Types API

REST Nur Admins

Grundlagen

Data Types sind die Blaupausen deiner Daten. Sie definieren das JSON‑Schema, das jedes Objekt erfüllen muss, bevor es gespeichert werden kann.

Basis‑Pfad: /api/memory/types
Auth: Authorization: Bearer <token>

Types auflisten

GET /api/memory/types

Liefert alle verfügbaren Type‑Definitionen.

Response

{
  "items": [
    {
      "id": "b1820464-9e11...",
      "type": "Ticket",
      "version": 1,
      "jsonSchema": { "type": "object" }
    }
  ]
}

Type anlegen

POST /api/memory/types

Definiert eine neue Blaupause. Du gibst einen eindeutigen Namen und ein Validierungsschema an.

Body

Feld	Typ	Required	Beschreibung
`type`	string	Ja	Eindeutige Kennung (z. B. `Ticket`).
`jsonSchema`	object	Ja	Gültiges JSON Schema.
`groupNames`	string[]	Nein	`PARAMETER`, `RETURN` oder `KNOWLEDGE`.

Beispiel

{
  "type": "Ticket",
  "groupNames": ["KNOWLEDGE"],
  "jsonSchema": {
    "type": "object",
    "required": ["status"],
    "properties": {
      "status": { "type": "string" },
      "priority": { "type": "string" }
    }
  }
}

Type aktualisieren

PUT /api/memory/types/{id}

Aktualisiert Schema oder Metadaten eines bestehenden Typs.

Body

Feld	Typ	Required	Beschreibung
`jsonSchema`	object	Ja	Neues Validierungsschema.
`groupNames`	string[]	Nein	Aktualisierte Gruppenliste.

Response

Gibt die aktive Typ‑Definition zurück.

Type löschen

DELETE /api/memory/types/{id}

Entfernt die Definition.

Constraint: Ein Typ kann nicht gelöscht werden, solange Objekte ihn noch verwenden. Lösche abhängige Objekte zuerst, um Konsistenz sicherzustellen.