Zum Hauptinhalt springen
POST
curl
Erstellen Sie einen Blueprint. content_config wird streng validiert: Akzeptiert werden nur die sechs bekannten Abschnitte und deren dokumentierte Schlüssel. Ein Tippfehler führt daher zu einer 400-Antwort, statt stillschweigend ignoriert zu werden.

Verwandte Themen

Autorisierungen

x-api-key
string
header
erforderlich

Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys.

Pfadparameter

organization_id
string<uuid>
erforderlich

UUID der Organisation.

application_id
string<uuid>
erforderlich

Anwendungs-UUID.

Body

application/json
name
string
erforderlich

Maximal 24 Zeichen, z. B. „AML investigation“.

Maximum string length: 24
assignee_pool
string<uuid>[]
erforderlich

Liste von Benutzer-UUIDs. Leere Arrays werden mit "Mindestens einen Bearbeiter auswählen" abgelehnt.

Minimum array length: 1
description
string | null
assignment_method
enum<string>
Standard:MANUAL
Verfügbare Optionen:
MANUAL,
AUTOMATIC
max_active_cases
integer | null

Schwellenwert für den Automatikmodus: „weniger als N Fälle dieser Vorlage zugewiesen“.

Erforderlicher Bereich: x >= 1
escalation_enabled
boolean
Standard:false
escalation_blueprint
string<uuid> | null

Ziel-Blueprint-UUID. Wird beim Speichern nicht erzwungen, aber die Eskalationsaktion schlägt mit 400 fehl, bis sowohl escalation_enabled als auch escalation_blueprint festgelegt sind.

transfer_enabled
boolean
Standard:false
four_eyes_checker_blueprint
string<uuid> | null

Wenn dies festgelegt wird, wird die Vier-Augen-Prüfung aktiviert: Entscheidungen zu diesem Blueprint werden in die Warteschlange des Checker-Blueprints eingereiht.

require_resolution_note
boolean
Standard:false
content_config
object

Die sechs umschaltbaren Abschnitte, die steuern, welche Tabs und Felder auf der Fallseite erscheinen. Unbekannte Abschnitte oder Schlüssel werden abgelehnt.

is_active
boolean
Standard:true
default_deadline_hours
integer | null

Standardfrist für neu geöffnete Fälle. Fristen bestehender Fälle bleiben unverändert.

Erforderlicher Bereich: 1 <= x <= 8760
publish
boolean
Standard:true
write-only

Auf false setzen, um einen noch nie veröffentlichten Entwurf zu speichern. Der Datensatz bleibt bei Version 0 inaktiv, bis der Entwurf explizit veröffentlicht wird. Das Weglassen dieses Felds behält die sofortige Erstellung für bestehende Integrationen bei.

Antwort

Blueprint erstellt.

uuid
string<uuid>
name
string
Maximum string length: 24
description
string | null
assignment_method
enum<string>
Verfügbare Optionen:
MANUAL,
AUTOMATIC
assignee_pool
string<uuid>[]
max_active_cases
integer | null
escalation_enabled
boolean
transfer_enabled
boolean
require_resolution_note
boolean
is_active
boolean
preset_key
string | null
created_at
string<date-time>
escalation_blueprint
string<uuid> | null
escalation_blueprint_name
string | null
four_eyes_checker_blueprint
string<uuid> | null
four_eyes_checker_blueprint_name
string | null
content_config
object

Die sechs umschaltbaren Abschnitte, die steuern, welche Tabs und Felder auf der Fallseite erscheinen. Unbekannte Abschnitte oder Schlüssel werden abgelehnt.

creation_sources
object[]

Konnektoren, die derzeit neue Fälle in diese Vorlage leiten.

receives_escalation_from
object[]

Andere Blueprints, deren Eskalationsziel auf diesen verweist.

updated_at
string<date-time>
version
integer
read-only
default_deadline_hours
integer | null
Erforderlicher Bereich: 1 <= x <= 8760
Zuletzt geändert am 7. November 2026