Saltar al contenido principal
POST
curl
Crea un caso vinculado a exactamente un sujeto. Indica subject directamente, o proporciona links y deja que Didit obtenga el sujeto a partir del propietario de la primera entidad vinculada.
Pasa blueprint siempre que tengas uno: determina qué secciones se muestran en la página del caso, si la resolución requiere una nota y adónde se dirige el caso en una escalada o transferencia.

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
title
string
requerido
Maximum string length: 255
blueprint
string<uuid> | null

UUID de CaseBlueprint. Omítelo para no usar ninguna plantilla.

priority
enum<string>
predeterminado:MEDIUM
Opciones disponibles:
LOW,
MEDIUM,
HIGH
due_at
string<date-time> | null
tags
string[]
subject
object

Obligatorio salvo que se proporcione links; el único sujeto del caso.

Sesiones, sesiones de empresa o transacciones que se adjuntan al crear, p. ej. [{"entity_type": "transaction", "entity_uuid": "..."}]. Cuando se omite subject, el sujeto se deriva del propietario del primer vínculo.

assigned_to
string<uuid> | null

UUID del usuario al que se asigna de inmediato.

review_duplicates
boolean
predeterminado:false

Vuelve a comprobar las investigaciones existentes antes de crear el caso. Si es true, un sujeto con casos existentes requiere un separate_incident_reason no vacío. La consola siempre activa esta protección. Si lo omites, se mantiene el comportamiento actual de la API.

separate_incident_reason
string
Maximum string length: 1000
source_context
object

Respuesta

Caso creado.

uuid
string<uuid>
case_number
string | null
title
string
status
enum<string>
Opciones disponibles:
OPEN,
AWAITING_USER,
RESOLVED
resolution
enum<string> | null
Opciones disponibles:
FALSE_POSITIVE,
VALID_THREAT,
INCONCLUSIVE,
REQUIREMENTS_NOT_MET,
REQUIREMENTS_SATISFIED
resolution_notes
string | null
priority
enum<string>
Opciones disponibles:
LOW,
MEDIUM,
HIGH
source
enum<string>
Opciones disponibles:
MANUAL,
AML_SCREENING,
TRANSACTION_RULE,
WORKFLOW_BUILDER
tags
string[]
subject
object | null

El único usuario o empresa al que está vinculado el caso.

assigned_to
object | null
assigned_at
string<date-time> | null
team
object | null

El equipo de revisión responsable del caso, o null si ningún equipo es responsable. El enrutamiento lo establece cuando una regla de enrutamiento asigna el caso a uno de sus equipos. Cámbialo o bórralo con PATCH .../cases/{case_uuid}/ (team).

due_at
string<date-time> | null
resolved_at
string<date-time> | null
resolved_by_email
string | null
pending_resolution
object | null

Se establece solo mientras una resolución de doble validación (4-eyes) está preparada en el blueprint del verificador, a la espera de su aprobación o del rechazo de la aprobación.

checker
object | null

El miembro designado para aprobar o rechazar la resolución pendiente. Solo tiene valor mientras una resolución con principio de cuatro ojos espera a un verificador designado. Null cuando no hay nada pendiente, mientras la resolución pendiente espera en la cola de verificadores, y una vez que la resolución se aprueba, se rechaza o se devuelve para una nueva revisión porque las pruebas cambiaron.

metadata
object
blueprint
object
notes
object[]

Las 50 notas más recientes.

events
object[]

Los 100 eventos más recientes.

notes_count
integer
checklist_items
object[]
created_at
string<date-time>
updated_at
string<date-time>
Última modificación el 1 de noviembre de 2026