Saltar al contingut principal
POST
curl
Crea un blueprint. content_config es valida de manera estricta: només s’accepten les sis seccions conegudes i les seves claus documentades, de manera que un error tipogràfic retorna un 400 en lloc de ser ignorat silenciosament.

Relacionats

Autoritzacions

x-api-key
string
header
requerit

La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys.

Paràmetres de ruta

organization_id
string<uuid>
requerit

UUID de l'organització.

application_id
string<uuid>
requerit

UUID de l'aplicació.

Cos

application/json
name
string
requerit

Màxim 24 caràcters, p. ex. "Investigació AML".

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

Llista d'UUID d'usuari. Les matrius buides es rebutgen amb "Tria com a mínim un assignat".

Minimum array length: 1
description
string | null
assignment_method
enum<string>
predeterminat:MANUAL
Opcions disponibles:
MANUAL,
AUTOMATIC
max_active_cases
integer | null

Llindar del mode automàtic: «menys de N casos assignats d'aquest model».

Rang requerit: x >= 1
escalation_enabled
boolean
predeterminat:false
escalation_blueprint
string<uuid> | null

UUID del blueprint de destinació. No es fa complir en desar, però l'acció d'escalada falla amb 400 fins que tant escalation_enabled com escalation_blueprint estiguin configurats.

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

Això habilita la revisió a quatre ulls: les resolucions d'aquest pla passen a la cua del pla del verificador.

require_resolution_note
boolean
predeterminat:false
content_config
object

Les sis seccions que es poden activar o desactivar i que determinen quines pestanyes i quins camps apareixen a la pàgina del cas. Es rebutgen les seccions o claus desconegudes.

is_active
boolean
predeterminat:true
default_deadline_hours
integer | null

Data límit predeterminada per als casos oberts recentment. Les dates límit dels casos existents no es modifiquen.

Rang requerit: 1 <= x <= 8760
publish
boolean
predeterminat:true
write-only

Estableix a false per desar un esborrany mai publicat. El registre roman inactiu a la versió 0 fins que l'esborrany es publica explícitament. Ometre aquest camp manté la creació immediata per a integracions existents.

Resposta

Blueprint creat.

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

Les sis seccions que es poden activar o desactivar i que determinen quines pestanyes i quins camps apareixen a la pàgina del cas. Es rebutgen les seccions o claus desconegudes.

creation_sources
object[]

Connectors que actualment estan encaminant casos nous cap a aquest esquema.

receives_escalation_from
object[]

Altres esquemes l'objectiu d'escalat dels quals apunta a aquest.

updated_at
string<date-time>
version
integer
read-only
default_deadline_hours
integer | null
Rang requerit: 1 <= x <= 8760
Darrera modificació el 7 de novembre del 2026