Saltar al contenido principal
POST
curl

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.

Encabezados

Content-Type
string

Establécelo en application/json cuando envíes un cuerpo JSON.

Ejemplo:

"application/json"

Parámetros de ruta

session_id
string<uuid>
requerido

UUID de la sesión de Verificación de usuarios (KYC). Debe pertenecer a la misma aplicación que la clave de API: los UUID de otras aplicaciones, las sesiones eliminadas y los ID de sesión de Verificación de empresas (KYB) devuelven 404.

Ejemplo:

"8c2f3a14-7e9b-4d23-9e83-3f7d5e8a1c6d"

Cuerpo

application/json
new_status
enum<string> | null

Etiqueta de estado opcional que se registra en la entrada. Acepta cualquier valor de estado de sesión y distingue mayúsculas de minúsculas ("approved" se rechaza con 400). Registrar un estado aquí no cambia el estado real de la sesión: para eso, usa el endpoint de actualización de estado.

Opciones disponibles:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User
Ejemplo:

"In Review"

comment
string | null

Nota opcional en texto libre (sin límite de longitud aplicado). Se guarda tal cual; en este endpoint no se procesan las menciones @email.

Ejemplo:

"Flagging for manual document re-check."

Respuesta

Entrada registrada en el historial de auditoría de la sesión. La sesión en sí no cambia: su status conserva el valor anterior y no se envía ningún webhook. La nueva entrada también aparece al principio de GET …/reviews/ (con actor_display: "Unknown").

user
string

Nombre visible del autor de la entrada. Siempre es "Unknown" en las entradas creadas mediante este endpoint, porque no registra la atribución de ningún actor.

Ejemplo:

"Unknown"

new_status
enum<string> | null

La etiqueta de estado registrada en la entrada, o null si no se envió ninguna. El estado real de la sesión no se ve afectado.

Opciones disponibles:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User
Ejemplo:

"In Review"

comment
string | null

La nota registrada en la entrada, o null si no se envió ninguna.

Ejemplo:

"Flagging for manual document re-check."

created_at
string<date-time>

Cuándo se escribió la entrada, en ISO 8601 UTC.

Ejemplo:

"2026-06-12T00:18:44.466537Z"

Última modificación el 1 de noviembre de 2026