Agentic Flows¶

Verwende einen API-Schlüssel oder REST-OAuth-Access-Token. Scopes und deine aktuellen Workspace-Rechte gelten gemeinsam. Die Beispiele verwenden fiktive Daten.

Flow-Auswahlkatalog lesen¶

GET /api/external/v1/flow-catalog

Scope: flows:read

Antwort 200

Erfolgreich.

Header	Typ	Beschreibung
`Cache-Control`	`string`	Die Antwort darf nicht zwischengespeichert werden. Beispiel: `no-store`

application/json

FelderBeispiel

Feld	Typ	Beschreibung
`models`	Liste von `object`	Mit den aktuellen Benutzerrechten verfügbare Modelle.
`routingModes`	Liste von `string`	Verfügbare Routing-Verfahren. Werte: `LLM`, `DECISION`
`promptVariables`	Liste von `object`	Von dieser Konfiguration unterstützte Prompt-Variablen.

models — Felder

Feld	Typ	Beschreibung
`value`	`string`	Exakter Katalogwert für API-Aufrufe. Alle 19 erlaubten Werte anzeigen `GPT_6_1_SOL`, `GPT_6_1_TERRA`, `GPT_6_SOL`, `GPT_6_LUNA`, `GPT_5_6_SOL`, `GPT_5_6_TERRA`, `GPT_5_6_LUNA`, `GPT_5`, `GPT_5_MINI`, `GPT_5_NANO`, `GPT_5_4`, `GPT_5_4_MINI`, `GPT_5_4_NANO`, `GPT_4_1`, `GPT_4_1_MINI`, `GPT_4_1_NANO`, `DEEPSEEK_V4_FLASH`, `MISTRAL_LARGE_3`, `MICROSOFT_DECISION_1`
`fixedTemperature`	`number` (double)	Vom Modell vorgegebene Temperatur, sofern sie festgelegt ist.
`maxOutputTokens`	`integer` (int32)	Maximales vom Modell unterstütztes Output-Tokenbudget.

promptVariables — Felder

Feld	Typ	Beschreibung
`key`	`string`	Name der Variablen oder des Parameters.
`label`	`string`	Anzeigename dieses Werts oder dieser Variablen.
`helperText`	`string`	Erläuterung zur Verwendung der Prompt-Variablen.
`category`	`string`	Kategorie zur Gruppierung von Prompt-Variablen. Werte: `AGENT`, `ROUTING`

{
  "models": [],
  "routingModes": [],
  "promptVariables": []
}

Fehlerantworten

Status	Bedeutung
`400`	Ungültige Eingabe, Auswahl oder Zeitgrenzen.
`401`	Fehlender, abgelaufener oder ungültiger Zugang. Der Body kann leer sein.
`403`	Benötigter Scope oder aktuelles Benutzerrecht fehlt. Der Body kann leer sein.
`429`	Gemeinsames Workspace-Budget überschritten. Retry-After abwarten; unklare Schreibvorgänge nicht blind wiederholen.
`503`	Vorübergehend nicht verfügbar. Unklare Schreibvorgänge vor erneutem Versuch prüfen.

Fehler-Body

Feld	Typ	Beschreibung
`status`	`integer`	HTTP-Statuscode.
`error`	`string`	Beschreibung des Fehlers.
`details`	`any`	Weitere Fehlerdetails, sofern vorhanden. Regeln: `null` erlaubt
`code`	`string`	Maschinenlesbarer Fehlercode.
`params`	`object`	Zusätzliche Werte zum Fehlercode.
`fieldErrors`	`object`	Validierungsfehler nach Eingabefeld.

Bei 429 oder 503 den Header Retry-After (Sekunden) beachten. Unklare Schreibvorgänge vor einem neuen Versuch prüfen.

Agentic Flow erstellen¶

POST /api/external/v1/flows

Scope: flows:write

Speichert die Konfiguration direkt; führt keinen Anruf, Tooltest oder Nachrichtenversand aus.

Request-Body · application/json

FelderBeispiel

Feld	Typ	Pflicht	Beschreibung
`title`	`string`	Ja	Anzeigename der Ressource. Regeln: höchstens 255 Zeichen Beispiel: `"Demo"`
`description`	`string`	Nein	Beschreibung des Zwecks dieser Ressource. Regeln: höchstens 255 Zeichen
`persona`	`string`	Nein	Gemeinsame Persönlichkeit und Sprechweise für die Agents dieses Flows. Regeln: höchstens 100000 Zeichen
`routingPrompt`	`string`	Nein	Anweisungen für LLM-Routing. Variablen aus dem Flow-Katalog verwenden. Regeln: höchstens 100000 Zeichen
`model`	`string`	Ja	Routing-Modell aus dem Flow-Katalog. Temperatur- und Outputgrenzen des Eintrags beachten. Alle 19 erlaubten Werte anzeigen `GPT_6_1_SOL`, `GPT_6_1_TERRA`, `GPT_6_SOL`, `GPT_6_LUNA`, `GPT_5_6_SOL`, `GPT_5_6_TERRA`, `GPT_5_6_LUNA`, `GPT_5`, `GPT_5_MINI`, `GPT_5_NANO`, `GPT_5_4`, `GPT_5_4_MINI`, `GPT_5_4_NANO`, `GPT_4_1`, `GPT_4_1_MINI`, `GPT_4_1_NANO`, `DEEPSEEK_V4_FLASH`, `MISTRAL_LARGE_3`, `MICROSOFT_DECISION_1`
`conversationHistoryLimit`	`integer` (int32)	Ja	Maximale Anzahl der Gesprächsverlaufseinträge für das Modell. Regeln: `0–100` Beispiel: `10`
`temperature`	`number` (double)	Ja	Variation der Routing-Antworten. Eine feste Temperatur im Flow-Katalog beachten. Regeln: `0–2` Beispiel: `0.3`
`maxTokens`	`integer` (int32)	Ja	Maximales Output-Tokenbudget. Zusätzlich die Grenze des gewählten Modells im Katalog beachten. Regeln: `10–25000` Beispiel: `1000`
`intentAgentMapping`	`object`	Ja	Ordnet Intentnamen Agent-IDs dieses Workspaces zu. DEFAULT als Rückfallziel angeben. Regeln: mindestens 1 Schlüssel Beispiel: `{"DEFAULT": "00000000-0000-0000-0000-000000000001"}` Je Wert: `string` (uuid)
`routingMode`	`string`	Ja	Routing-Verfahren aus dem Flow-Katalog. Werte: `LLM`, `DECISION`
`decisionRouting`	`object`	Nein	Decision-Routing-Einstellungen. Auslassen oder null beim Update behält den vorhandenen Entwurf.

decisionRouting — Felder

Feld	Typ	Pflicht	Beschreibung
`instructions`	`string`	Nein	Anweisungen zur Auswahl eines Routing-Intents. Regeln: höchstens 20000 Zeichen
`intentDescriptions`	`object`	Nein	Beschreibt, wann jeder aktive Intent einschließlich DEFAULT zutrifft. Je Wert: `string`
`conversationHistoryLimit`	`integer` (int32)	Ja	Maximale Anzahl der Gesprächsverlaufseinträge für das Modell. Regeln: `0–100` Beispiel: `10`

{
  "title": "Demo",
  "description": "string",
  "persona": "string",
  "routingPrompt": "string",
  "model": "GPT_4_1_MINI",
  "conversationHistoryLimit": 10,
  "temperature": 0.3,
  "maxTokens": 1000,
  "intentAgentMapping": {
    "DEFAULT": "00000000-0000-0000-0000-000000000001"
  },
  "routingMode": "LLM",
  "decisionRouting": {
    "instructions": "string",
    "intentDescriptions": {},
    "conversationHistoryLimit": 10
  }
}

Antwort 201

Erstellt.

Header	Typ	Beschreibung
`Cache-Control`	`string`	Die Antwort darf nicht zwischengespeichert werden. Beispiel: `no-store`
`Location`	`string`	Pfad der erstellten Ressource.
`ETag`	`string`	Aktuelle Revision. Bei erforderlichem If-Match unverändert einschließlich Anführungszeichen senden. Beispiel: `"revision-from-get"`

application/json

FelderBeispiel

Feld	Typ	Beschreibung
`id`	`string` (uuid)	Ressourcen-ID in deinem Workspace.
`revision`	`string`	Aktuelle Ressourcenrevision. Beim Ändern den ETag der Antwort als If-Match senden.
`configuration`	`object`	Einstellungen dieser Ressource. Beim Ändern die vollständige bearbeitbare Konfiguration senden.

configuration — Felder

Feld	Typ	Beschreibung
`title`	`string`	Anzeigename der Ressource. Regeln: höchstens 255 Zeichen Beispiel: `"Demo"`
`description`	`string`	Beschreibung des Zwecks dieser Ressource. Regeln: höchstens 255 Zeichen
`persona`	`string`	Gemeinsame Persönlichkeit und Sprechweise für die Agents dieses Flows. Regeln: höchstens 100000 Zeichen
`routingPrompt`	`string`	Anweisungen für LLM-Routing. Variablen aus dem Flow-Katalog verwenden. Regeln: höchstens 100000 Zeichen
`model`	`string`	Routing-Modell aus dem Flow-Katalog. Temperatur- und Outputgrenzen des Eintrags beachten. Alle 19 erlaubten Werte anzeigen `GPT_6_1_SOL`, `GPT_6_1_TERRA`, `GPT_6_SOL`, `GPT_6_LUNA`, `GPT_5_6_SOL`, `GPT_5_6_TERRA`, `GPT_5_6_LUNA`, `GPT_5`, `GPT_5_MINI`, `GPT_5_NANO`, `GPT_5_4`, `GPT_5_4_MINI`, `GPT_5_4_NANO`, `GPT_4_1`, `GPT_4_1_MINI`, `GPT_4_1_NANO`, `DEEPSEEK_V4_FLASH`, `MISTRAL_LARGE_3`, `MICROSOFT_DECISION_1`
`conversationHistoryLimit`	`integer` (int32)	Maximale Anzahl der Gesprächsverlaufseinträge für das Modell. Regeln: `0–100` Beispiel: `10`
`temperature`	`number` (double)	Variation der Routing-Antworten. Eine feste Temperatur im Flow-Katalog beachten. Regeln: `0–2` Beispiel: `0.3`
`maxTokens`	`integer` (int32)	Maximales Output-Tokenbudget. Zusätzlich die Grenze des gewählten Modells im Katalog beachten. Regeln: `10–25000` Beispiel: `1000`
`intentAgentMapping`	`object`	Ordnet Intentnamen Agent-IDs dieses Workspaces zu. DEFAULT als Rückfallziel angeben. Regeln: mindestens 1 Schlüssel Beispiel: `{"DEFAULT": "00000000-0000-0000-0000-000000000001"}` Je Wert: `string` (uuid)
`routingMode`	`string`	Routing-Verfahren aus dem Flow-Katalog. Werte: `LLM`, `DECISION`
`decisionRouting`	`object`	Decision-Routing-Einstellungen. Auslassen oder null beim Update behält den vorhandenen Entwurf.

decisionRouting — Felder

Feld	Typ	Beschreibung
`instructions`	`string`	Anweisungen zur Auswahl eines Routing-Intents. Regeln: höchstens 20000 Zeichen
`intentDescriptions`	`object`	Beschreibt, wann jeder aktive Intent einschließlich DEFAULT zutrifft. Je Wert: `string`
`conversationHistoryLimit`	`integer` (int32)	Maximale Anzahl der Gesprächsverlaufseinträge für das Modell. Regeln: `0–100` Beispiel: `10`

{
  "id": "00000000-0000-0000-0000-000000000001",
  "revision": "revision-from-get",
  "configuration": {
    "title": "Demo",
    "description": "string",
    "persona": "string",
    "routingPrompt": "string",
    "model": "GPT_4_1_MINI",
    "conversationHistoryLimit": 10,
    "temperature": 0.3,
    "maxTokens": 1000,
    "intentAgentMapping": {
      "DEFAULT": "00000000-0000-0000-0000-000000000001"
    },
    "routingMode": "LLM",
    "decisionRouting": {
      "instructions": "string",
      "intentDescriptions": {},
      "conversationHistoryLimit": 10
    }
  }
}

Fehlerantworten

Status	Bedeutung
`400`	Ungültige Eingabe, Auswahl oder Zeitgrenzen.
`401`	Fehlender, abgelaufener oder ungültiger Zugang. Der Body kann leer sein.
`403`	Benötigter Scope oder aktuelles Benutzerrecht fehlt. Der Body kann leer sein.
`409`	Fehlende/veraltete Revision oder Abhängigkeits-/Routingkonflikt. Vor erneutem Versuch neu lesen.
`429`	Gemeinsames Workspace-Budget überschritten. Retry-After abwarten; unklare Schreibvorgänge nicht blind wiederholen.
`503`	Vorübergehend nicht verfügbar. Unklare Schreibvorgänge vor erneutem Versuch prüfen.

Fehler-Body

Feld	Typ	Beschreibung
`status`	`integer`	HTTP-Statuscode.
`error`	`string`	Beschreibung des Fehlers.
`details`	`any`	Weitere Fehlerdetails, sofern vorhanden. Regeln: `null` erlaubt
`code`	`string`	Maschinenlesbarer Fehlercode.
`params`	`object`	Zusätzliche Werte zum Fehlercode.
`fieldErrors`	`object`	Validierungsfehler nach Eingabefeld.

Bei 429 oder 503 den Header Retry-After (Sekunden) beachten. Unklare Schreibvorgänge vor einem neuen Versuch prüfen.

Agentic Flows auflisten¶

GET /api/external/v1/flows

Scope: flows:read

Parameter

Name	Position	Typ	Pflicht	Beschreibung
`page`	Query	`integer` (int32)	Nein	Seitenindex ab 0. Regeln: `0–100000` Standard: `0`
`size`	Query	`integer` (int32)	Nein	Ergebnisse pro Seite. Regeln: `1–100` Standard: `25`

Antwort 200

Erfolgreich.

Header	Typ	Beschreibung
`Cache-Control`	`string`	Die Antwort darf nicht zwischengespeichert werden. Beispiel: `no-store`

application/json

FelderBeispiel

Feld	Typ	Beschreibung
`items`	Liste von `object`	Ergebnisse dieser Seite.
`page`	`integer` (int32)	Aktueller Seitenindex, beginnend bei 0.
`size`	`integer` (int32)	Angeforderte Anzahl der Ergebnisse pro Seite.
`totalElements`	`integer` (int64)	Gesamtzahl der passenden Ergebnisse.
`totalPages`	`integer` (int32)	Gesamtzahl der Ergebnisseiten.

items — Felder

Feld	Typ	Beschreibung
`id`	`string` (uuid)	Ressourcen-ID in deinem Workspace.
`revision`	`string`	Aktuelle Ressourcenrevision. Beim Ändern den ETag der Antwort als If-Match senden.
`title`	`string`	Anzeigename der Ressource.
`description`	`string`	Beschreibung des Zwecks dieser Ressource.
`routingMode`	`string`	Routing-Verfahren aus dem Flow-Katalog. Werte: `LLM`, `DECISION`

{
  "items": [
    {
      "id": "00000000-0000-0000-0000-000000000001",
      "revision": "revision-from-get",
      "title": "NuvoCar service",
      "description": "string",
      "routingMode": "LLM"
    }
  ],
  "page": 0,
  "size": 25,
  "totalElements": 1,
  "totalPages": 1
}

Fehlerantworten

Status	Bedeutung
`400`	Ungültige Eingabe, Auswahl oder Zeitgrenzen.
`401`	Fehlender, abgelaufener oder ungültiger Zugang. Der Body kann leer sein.
`403`	Benötigter Scope oder aktuelles Benutzerrecht fehlt. Der Body kann leer sein.
`429`	Gemeinsames Workspace-Budget überschritten. Retry-After abwarten; unklare Schreibvorgänge nicht blind wiederholen.
`503`	Vorübergehend nicht verfügbar. Unklare Schreibvorgänge vor erneutem Versuch prüfen.

Fehler-Body

Feld	Typ	Beschreibung
`status`	`integer`	HTTP-Statuscode.
`error`	`string`	Beschreibung des Fehlers.
`details`	`any`	Weitere Fehlerdetails, sofern vorhanden. Regeln: `null` erlaubt
`code`	`string`	Maschinenlesbarer Fehlercode.
`params`	`object`	Zusätzliche Werte zum Fehlercode.
`fieldErrors`	`object`	Validierungsfehler nach Eingabefeld.

Bei 429 oder 503 den Header Retry-After (Sekunden) beachten. Unklare Schreibvorgänge vor einem neuen Versuch prüfen.

Agentic Flow löschen¶

DELETE /api/external/v1/flows/{id}

Scope: flows:write

Ressource zuerst lesen. Den aktuellen ETag einschließlich Anführungszeichen als If-Match senden.

Parameter

Name	Position	Typ	Pflicht	Beschreibung
`id`	Pfad	`string` (uuid)	Ja	Ressourcen-ID im gebundenen Workspace.
`If-Match`	Header	`string`	Ja	ETag aus dem vorherigen Leseaufruf einschließlich Anführungszeichen. Beispiel: `"revision-from-get"`

Antwort 204

Gelöscht; kein Response-Body.

Header	Typ	Beschreibung
`Cache-Control`	`string`	Die Antwort darf nicht zwischengespeichert werden. Beispiel: `no-store`

Fehlerantworten

Status	Bedeutung
`400`	Ungültige Eingabe, Auswahl oder Zeitgrenzen.
`401`	Fehlender, abgelaufener oder ungültiger Zugang. Der Body kann leer sein.
`403`	Benötigter Scope oder aktuelles Benutzerrecht fehlt. Der Body kann leer sein.
`404`	Ressource im gebundenen Workspace nicht verfügbar.
`409`	Fehlende/veraltete Revision oder Abhängigkeits-/Routingkonflikt. Vor erneutem Versuch neu lesen.
`429`	Gemeinsames Workspace-Budget überschritten. Retry-After abwarten; unklare Schreibvorgänge nicht blind wiederholen.
`503`	Vorübergehend nicht verfügbar. Unklare Schreibvorgänge vor erneutem Versuch prüfen.

Fehler-Body

Feld	Typ	Beschreibung
`status`	`integer`	HTTP-Statuscode.
`error`	`string`	Beschreibung des Fehlers.
`details`	`any`	Weitere Fehlerdetails, sofern vorhanden. Regeln: `null` erlaubt
`code`	`string`	Maschinenlesbarer Fehlercode.
`params`	`object`	Zusätzliche Werte zum Fehlercode.
`fieldErrors`	`object`	Validierungsfehler nach Eingabefeld.

Bei 429 oder 503 den Header Retry-After (Sekunden) beachten. Unklare Schreibvorgänge vor einem neuen Versuch prüfen.

Agentic Flow abrufen¶

GET /api/external/v1/flows/{id}

Scope: flows:read

Parameter

Name	Position	Typ	Pflicht	Beschreibung
`id`	Pfad	`string` (uuid)	Ja	Ressourcen-ID im gebundenen Workspace.

Antwort 200

Erfolgreich.

Header	Typ	Beschreibung
`Cache-Control`	`string`	Die Antwort darf nicht zwischengespeichert werden. Beispiel: `no-store`
`ETag`	`string`	Aktuelle Revision. Bei erforderlichem If-Match unverändert einschließlich Anführungszeichen senden. Beispiel: `"revision-from-get"`

application/json

FelderBeispiel

Feld	Typ	Beschreibung
`id`	`string` (uuid)	Ressourcen-ID in deinem Workspace.
`revision`	`string`	Aktuelle Ressourcenrevision. Beim Ändern den ETag der Antwort als If-Match senden.
`configuration`	`object`	Einstellungen dieser Ressource. Beim Ändern die vollständige bearbeitbare Konfiguration senden.

configuration — Felder

Feld	Typ	Beschreibung
`title`	`string`	Anzeigename der Ressource. Regeln: höchstens 255 Zeichen Beispiel: `"Demo"`
`description`	`string`	Beschreibung des Zwecks dieser Ressource. Regeln: höchstens 255 Zeichen
`persona`	`string`	Gemeinsame Persönlichkeit und Sprechweise für die Agents dieses Flows. Regeln: höchstens 100000 Zeichen
`routingPrompt`	`string`	Anweisungen für LLM-Routing. Variablen aus dem Flow-Katalog verwenden. Regeln: höchstens 100000 Zeichen
`model`	`string`	Routing-Modell aus dem Flow-Katalog. Temperatur- und Outputgrenzen des Eintrags beachten. Alle 19 erlaubten Werte anzeigen `GPT_6_1_SOL`, `GPT_6_1_TERRA`, `GPT_6_SOL`, `GPT_6_LUNA`, `GPT_5_6_SOL`, `GPT_5_6_TERRA`, `GPT_5_6_LUNA`, `GPT_5`, `GPT_5_MINI`, `GPT_5_NANO`, `GPT_5_4`, `GPT_5_4_MINI`, `GPT_5_4_NANO`, `GPT_4_1`, `GPT_4_1_MINI`, `GPT_4_1_NANO`, `DEEPSEEK_V4_FLASH`, `MISTRAL_LARGE_3`, `MICROSOFT_DECISION_1`
`conversationHistoryLimit`	`integer` (int32)	Maximale Anzahl der Gesprächsverlaufseinträge für das Modell. Regeln: `0–100` Beispiel: `10`
`temperature`	`number` (double)	Variation der Routing-Antworten. Eine feste Temperatur im Flow-Katalog beachten. Regeln: `0–2` Beispiel: `0.3`
`maxTokens`	`integer` (int32)	Maximales Output-Tokenbudget. Zusätzlich die Grenze des gewählten Modells im Katalog beachten. Regeln: `10–25000` Beispiel: `1000`
`intentAgentMapping`	`object`	Ordnet Intentnamen Agent-IDs dieses Workspaces zu. DEFAULT als Rückfallziel angeben. Regeln: mindestens 1 Schlüssel Beispiel: `{"DEFAULT": "00000000-0000-0000-0000-000000000001"}` Je Wert: `string` (uuid)
`routingMode`	`string`	Routing-Verfahren aus dem Flow-Katalog. Werte: `LLM`, `DECISION`
`decisionRouting`	`object`	Decision-Routing-Einstellungen. Auslassen oder null beim Update behält den vorhandenen Entwurf.

decisionRouting — Felder

Feld	Typ	Beschreibung
`instructions`	`string`	Anweisungen zur Auswahl eines Routing-Intents. Regeln: höchstens 20000 Zeichen
`intentDescriptions`	`object`	Beschreibt, wann jeder aktive Intent einschließlich DEFAULT zutrifft. Je Wert: `string`
`conversationHistoryLimit`	`integer` (int32)	Maximale Anzahl der Gesprächsverlaufseinträge für das Modell. Regeln: `0–100` Beispiel: `10`

{
  "id": "00000000-0000-0000-0000-000000000001",
  "revision": "revision-from-get",
  "configuration": {
    "title": "Demo",
    "description": "string",
    "persona": "string",
    "routingPrompt": "string",
    "model": "GPT_4_1_MINI",
    "conversationHistoryLimit": 10,
    "temperature": 0.3,
    "maxTokens": 1000,
    "intentAgentMapping": {
      "DEFAULT": "00000000-0000-0000-0000-000000000001"
    },
    "routingMode": "LLM",
    "decisionRouting": {
      "instructions": "string",
      "intentDescriptions": {},
      "conversationHistoryLimit": 10
    }
  }
}

Fehlerantworten

Status	Bedeutung
`400`	Ungültige Eingabe, Auswahl oder Zeitgrenzen.
`401`	Fehlender, abgelaufener oder ungültiger Zugang. Der Body kann leer sein.
`403`	Benötigter Scope oder aktuelles Benutzerrecht fehlt. Der Body kann leer sein.
`404`	Ressource im gebundenen Workspace nicht verfügbar.
`429`	Gemeinsames Workspace-Budget überschritten. Retry-After abwarten; unklare Schreibvorgänge nicht blind wiederholen.
`503`	Vorübergehend nicht verfügbar. Unklare Schreibvorgänge vor erneutem Versuch prüfen.

Fehler-Body

Feld	Typ	Beschreibung
`status`	`integer`	HTTP-Statuscode.
`error`	`string`	Beschreibung des Fehlers.
`details`	`any`	Weitere Fehlerdetails, sofern vorhanden. Regeln: `null` erlaubt
`code`	`string`	Maschinenlesbarer Fehlercode.
`params`	`object`	Zusätzliche Werte zum Fehlercode.
`fieldErrors`	`object`	Validierungsfehler nach Eingabefeld.

Bei 429 oder 503 den Header Retry-After (Sekunden) beachten. Unklare Schreibvorgänge vor einem neuen Versuch prüfen.

Agentic Flow ändern¶

PUT /api/external/v1/flows/{id}

Scope: flows:write

Speichert die Konfiguration direkt; führt keinen Anruf, Tooltest oder Nachrichtenversand aus. Ressource zuerst lesen. Den aktuellen ETag einschließlich Anführungszeichen als If-Match senden. Vollständige bearbeitbare Konfiguration senden. Ausgelassene Einstellungen können zurückgesetzt werden.

Parameter

Name	Position	Typ	Pflicht	Beschreibung
`id`	Pfad	`string` (uuid)	Ja	Ressourcen-ID im gebundenen Workspace.
`If-Match`	Header	`string`	Ja	ETag aus dem vorherigen Leseaufruf einschließlich Anführungszeichen. Beispiel: `"revision-from-get"`

Request-Body · application/json

FelderBeispiel

Feld	Typ	Pflicht	Beschreibung
`title`	`string`	Ja	Anzeigename der Ressource. Regeln: höchstens 255 Zeichen Beispiel: `"Demo"`
`description`	`string`	Nein	Beschreibung des Zwecks dieser Ressource. Regeln: höchstens 255 Zeichen
`persona`	`string`	Nein	Gemeinsame Persönlichkeit und Sprechweise für die Agents dieses Flows. Regeln: höchstens 100000 Zeichen
`routingPrompt`	`string`	Nein	Anweisungen für LLM-Routing. Variablen aus dem Flow-Katalog verwenden. Regeln: höchstens 100000 Zeichen
`model`	`string`	Ja	Routing-Modell aus dem Flow-Katalog. Temperatur- und Outputgrenzen des Eintrags beachten. Alle 19 erlaubten Werte anzeigen `GPT_6_1_SOL`, `GPT_6_1_TERRA`, `GPT_6_SOL`, `GPT_6_LUNA`, `GPT_5_6_SOL`, `GPT_5_6_TERRA`, `GPT_5_6_LUNA`, `GPT_5`, `GPT_5_MINI`, `GPT_5_NANO`, `GPT_5_4`, `GPT_5_4_MINI`, `GPT_5_4_NANO`, `GPT_4_1`, `GPT_4_1_MINI`, `GPT_4_1_NANO`, `DEEPSEEK_V4_FLASH`, `MISTRAL_LARGE_3`, `MICROSOFT_DECISION_1`
`conversationHistoryLimit`	`integer` (int32)	Ja	Maximale Anzahl der Gesprächsverlaufseinträge für das Modell. Regeln: `0–100` Beispiel: `10`
`temperature`	`number` (double)	Ja	Variation der Routing-Antworten. Eine feste Temperatur im Flow-Katalog beachten. Regeln: `0–2` Beispiel: `0.3`
`maxTokens`	`integer` (int32)	Ja	Maximales Output-Tokenbudget. Zusätzlich die Grenze des gewählten Modells im Katalog beachten. Regeln: `10–25000` Beispiel: `1000`
`intentAgentMapping`	`object`	Ja	Ordnet Intentnamen Agent-IDs dieses Workspaces zu. DEFAULT als Rückfallziel angeben. Regeln: mindestens 1 Schlüssel Beispiel: `{"DEFAULT": "00000000-0000-0000-0000-000000000001"}` Je Wert: `string` (uuid)
`routingMode`	`string`	Ja	Routing-Verfahren aus dem Flow-Katalog. Werte: `LLM`, `DECISION`
`decisionRouting`	`object`	Nein	Decision-Routing-Einstellungen. Auslassen oder null beim Update behält den vorhandenen Entwurf.

decisionRouting — Felder

Feld	Typ	Pflicht	Beschreibung
`instructions`	`string`	Nein	Anweisungen zur Auswahl eines Routing-Intents. Regeln: höchstens 20000 Zeichen
`intentDescriptions`	`object`	Nein	Beschreibt, wann jeder aktive Intent einschließlich DEFAULT zutrifft. Je Wert: `string`
`conversationHistoryLimit`	`integer` (int32)	Ja	Maximale Anzahl der Gesprächsverlaufseinträge für das Modell. Regeln: `0–100` Beispiel: `10`

{
  "title": "Demo",
  "description": "string",
  "persona": "string",
  "routingPrompt": "string",
  "model": "GPT_4_1_MINI",
  "conversationHistoryLimit": 10,
  "temperature": 0.3,
  "maxTokens": 1000,
  "intentAgentMapping": {
    "DEFAULT": "00000000-0000-0000-0000-000000000001"
  },
  "routingMode": "LLM",
  "decisionRouting": {
    "instructions": "string",
    "intentDescriptions": {},
    "conversationHistoryLimit": 10
  }
}

Antwort 200

Erfolgreich.

Header	Typ	Beschreibung
`Cache-Control`	`string`	Die Antwort darf nicht zwischengespeichert werden. Beispiel: `no-store`
`ETag`	`string`	Aktuelle Revision. Bei erforderlichem If-Match unverändert einschließlich Anführungszeichen senden. Beispiel: `"revision-from-get"`

application/json

FelderBeispiel

Feld	Typ	Beschreibung
`id`	`string` (uuid)	Ressourcen-ID in deinem Workspace.
`revision`	`string`	Aktuelle Ressourcenrevision. Beim Ändern den ETag der Antwort als If-Match senden.
`configuration`	`object`	Einstellungen dieser Ressource. Beim Ändern die vollständige bearbeitbare Konfiguration senden.

configuration — Felder

Feld	Typ	Beschreibung
`title`	`string`	Anzeigename der Ressource. Regeln: höchstens 255 Zeichen Beispiel: `"Demo"`
`description`	`string`	Beschreibung des Zwecks dieser Ressource. Regeln: höchstens 255 Zeichen
`persona`	`string`	Gemeinsame Persönlichkeit und Sprechweise für die Agents dieses Flows. Regeln: höchstens 100000 Zeichen
`routingPrompt`	`string`	Anweisungen für LLM-Routing. Variablen aus dem Flow-Katalog verwenden. Regeln: höchstens 100000 Zeichen
`model`	`string`	Routing-Modell aus dem Flow-Katalog. Temperatur- und Outputgrenzen des Eintrags beachten. Alle 19 erlaubten Werte anzeigen `GPT_6_1_SOL`, `GPT_6_1_TERRA`, `GPT_6_SOL`, `GPT_6_LUNA`, `GPT_5_6_SOL`, `GPT_5_6_TERRA`, `GPT_5_6_LUNA`, `GPT_5`, `GPT_5_MINI`, `GPT_5_NANO`, `GPT_5_4`, `GPT_5_4_MINI`, `GPT_5_4_NANO`, `GPT_4_1`, `GPT_4_1_MINI`, `GPT_4_1_NANO`, `DEEPSEEK_V4_FLASH`, `MISTRAL_LARGE_3`, `MICROSOFT_DECISION_1`
`conversationHistoryLimit`	`integer` (int32)	Maximale Anzahl der Gesprächsverlaufseinträge für das Modell. Regeln: `0–100` Beispiel: `10`
`temperature`	`number` (double)	Variation der Routing-Antworten. Eine feste Temperatur im Flow-Katalog beachten. Regeln: `0–2` Beispiel: `0.3`
`maxTokens`	`integer` (int32)	Maximales Output-Tokenbudget. Zusätzlich die Grenze des gewählten Modells im Katalog beachten. Regeln: `10–25000` Beispiel: `1000`
`intentAgentMapping`	`object`	Ordnet Intentnamen Agent-IDs dieses Workspaces zu. DEFAULT als Rückfallziel angeben. Regeln: mindestens 1 Schlüssel Beispiel: `{"DEFAULT": "00000000-0000-0000-0000-000000000001"}` Je Wert: `string` (uuid)
`routingMode`	`string`	Routing-Verfahren aus dem Flow-Katalog. Werte: `LLM`, `DECISION`
`decisionRouting`	`object`	Decision-Routing-Einstellungen. Auslassen oder null beim Update behält den vorhandenen Entwurf.

decisionRouting — Felder

Feld	Typ	Beschreibung
`instructions`	`string`	Anweisungen zur Auswahl eines Routing-Intents. Regeln: höchstens 20000 Zeichen
`intentDescriptions`	`object`	Beschreibt, wann jeder aktive Intent einschließlich DEFAULT zutrifft. Je Wert: `string`
`conversationHistoryLimit`	`integer` (int32)	Maximale Anzahl der Gesprächsverlaufseinträge für das Modell. Regeln: `0–100` Beispiel: `10`

{
  "id": "00000000-0000-0000-0000-000000000001",
  "revision": "revision-from-get",
  "configuration": {
    "title": "Demo",
    "description": "string",
    "persona": "string",
    "routingPrompt": "string",
    "model": "GPT_4_1_MINI",
    "conversationHistoryLimit": 10,
    "temperature": 0.3,
    "maxTokens": 1000,
    "intentAgentMapping": {
      "DEFAULT": "00000000-0000-0000-0000-000000000001"
    },
    "routingMode": "LLM",
    "decisionRouting": {
      "instructions": "string",
      "intentDescriptions": {},
      "conversationHistoryLimit": 10
    }
  }
}

Fehlerantworten

Status	Bedeutung
`400`	Ungültige Eingabe, Auswahl oder Zeitgrenzen.
`401`	Fehlender, abgelaufener oder ungültiger Zugang. Der Body kann leer sein.
`403`	Benötigter Scope oder aktuelles Benutzerrecht fehlt. Der Body kann leer sein.
`404`	Ressource im gebundenen Workspace nicht verfügbar.
`409`	Fehlende/veraltete Revision oder Abhängigkeits-/Routingkonflikt. Vor erneutem Versuch neu lesen.
`429`	Gemeinsames Workspace-Budget überschritten. Retry-After abwarten; unklare Schreibvorgänge nicht blind wiederholen.
`503`	Vorübergehend nicht verfügbar. Unklare Schreibvorgänge vor erneutem Versuch prüfen.

Fehler-Body

Feld	Typ	Beschreibung
`status`	`integer`	HTTP-Statuscode.
`error`	`string`	Beschreibung des Fehlers.
`details`	`any`	Weitere Fehlerdetails, sofern vorhanden. Regeln: `null` erlaubt
`code`	`string`	Maschinenlesbarer Fehlercode.
`params`	`object`	Zusätzliche Werte zum Fehlercode.
`fieldErrors`	`object`	Validierungsfehler nach Eingabefeld.

Bei 429 oder 503 den Header Retry-After (Sekunden) beachten. Unklare Schreibvorgänge vor einem neuen Versuch prüfen.