Vai al contenuto principale
POST
curl
Crea un blueprint. content_config viene validato in modo rigoroso: sono accettate solo le sei sezioni note e le relative chiavi documentate, quindi un errore di battitura restituisce un 400 invece di essere ignorato in silenzio.

Correlati

Autorizzazioni

x-api-key
string
header
obbligatorio

La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys.

Parametri del percorso

organization_id
string<uuid>
obbligatorio

UUID dell'organizzazione.

application_id
string<uuid>
obbligatorio

UUID dell'applicazione.

Corpo

application/json
name
string
obbligatorio

Massimo 24 caratteri, ad es. "AML investigation".

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

Elenco di UUID degli utenti. Gli array vuoti vengono rifiutati con "Seleziona almeno un assegnatario".

Minimum array length: 1
description
string | null
assignment_method
enum<string>
predefinito:MANUAL
Opzioni disponibili:
MANUAL,
AUTOMATIC
max_active_cases
integer | null

Soglia della modalità automatica: "meno di N casi di questo modello assegnati".

Intervallo richiesto: x >= 1
escalation_enabled
boolean
predefinito:false
escalation_blueprint
string<uuid> | null

UUID del blueprint di destinazione. Non verificato al momento del salvataggio, ma l'azione di escalation fallisce con 400 finché non vengono impostati sia escalation_enabled che escalation_blueprint.

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

L'impostazione di questo campo abilita la revisione a quattro occhi: le risoluzioni su questo blueprint vengono messe in attesa nella coda del blueprint del checker.

require_resolution_note
boolean
predefinito:false
content_config
object

Le sei sezioni attivabili/disattivabili che determinano quali schede e campi compaiono nella pagina del caso. Le sezioni o chiavi sconosciute vengono rifiutate.

is_active
boolean
predefinito:true
default_deadline_hours
integer | null

Scadenza predefinita per i casi appena aperti. Le scadenze dei casi esistenti rimangono invariate.

Intervallo richiesto: 1 <= x <= 8760
publish
boolean
predefinito:true
write-only

Imposta su false per salvare una bozza mai pubblicata. Il record rimane inattivo alla versione 0 fino a quando la bozza non viene esplicitamente pubblicata. L'omissione di questo campo mantiene la creazione immediata per le integrazioni esistenti.

Risposta

Blueprint creato.

uuid
string<uuid>
name
string
Maximum string length: 24
description
string | null
assignment_method
enum<string>
Opzioni disponibili:
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

Le sei sezioni attivabili/disattivabili che determinano quali schede e campi compaiono nella pagina del caso. Le sezioni o chiavi sconosciute vengono rifiutate.

creation_sources
object[]

Connettori che attualmente instradano nuovi casi in questo modello.

receives_escalation_from
object[]

Altri blueprint il cui target di escalation punta a questo.

updated_at
string<date-time>
version
integer
read-only
default_deadline_hours
integer | null
Intervallo richiesto: 1 <= x <= 8760
Ultima modifica il 7 novembre 2026