Saltar al contenido principal
POST
curl
Crea una plantilla de caso. content_config se valida de forma estricta: solo se aceptan las seis secciones conocidas y sus claves documentadas, así que un error tipográfico devuelve un 400 en lugar de ignorarse sin aviso.

Relacionado

Autorizaciones

x-api-key
string
header
requerido

La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys.

Parámetros de ruta

organization_id
string<uuid>
requerido

UUID de la organización.

application_id
string<uuid>
requerido

UUID de la aplicación.

Cuerpo

application/json
name
string
requerido

Máximo 24 caracteres, por ejemplo "Investigación AML".

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

Lista de UUID de usuario. Los arrays vacíos se rechazan con "Pick at least one assignee".

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

Umbral del modo automático: "menos de N casos asignados de este blueprint".

Rango requerido: x >= 1
escalation_enabled
boolean
predeterminado:false
escalation_blueprint
string<uuid> | null

UUID del blueprint de destino. No se valida al guardar, pero la acción de escalado falla con 400 hasta que se configuran tanto escalation_enabled como escalation_blueprint.

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

Configurar esto activa la revisión de cuatro ojos: las resoluciones de este blueprint quedan en espera en la cola del blueprint verificador.

require_resolution_note
boolean
predeterminado:false
content_config
object

Las seis secciones activables que determinan qué pestañas y campos aparecen en la página del caso. Se rechazan las secciones o claves desconocidas.

is_active
boolean
predeterminado:true
default_deadline_hours
integer | null

Plazo predeterminado para los casos recién abiertos. Los plazos de los casos existentes no cambian.

Rango requerido: 1 <= x <= 8760
publish
boolean
predeterminado:true
write-only

Establécelo en false para guardar un borrador nunca publicado. El registro permanece inactivo en la versión 0 hasta que el borrador se publique explícitamente. Si se omite este campo, se mantiene la creación inmediata para las integraciones existentes.

Respuesta

Blueprint creado.

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

Las seis secciones activables que determinan qué pestañas y campos aparecen en la página del caso. Se rechazan las secciones o claves desconocidas.

creation_sources
object[]

Conectores que actualmente dirigen casos nuevos a este blueprint.

receives_escalation_from
object[]

Otros blueprints cuyo destino de escalado apunta a este.

updated_at
string<date-time>
version
integer
read-only
default_deadline_hours
integer | null
Rango requerido: 1 <= x <= 8760
Última modificación el 1 de noviembre de 2026