Saltar al contenido principal
PATCH
curl
Las claves de los campos son las que configuraste para el documento en el flujo. Consulta Document AI para ver cómo se configuran los documentos y los campos, y el informe de Document AI para ver dónde aparece el resultado en la decisión de la sesión.

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

sessionId
string<uuid>
requerido

UUID de la sesión de verificación (el session_id que devuelve POST /v3/session/). Acepta ID de sesión tanto de Verificación de usuarios (KYC) como de Verificación de empresas (KYB): el servidor resuelve el ID en ambos tipos de sesión. Debe ser un UUID con formato válido; un valor mal formado no coincide con la ruta y devuelve un 404 en HTML.

Ejemplo:

"11111111-2222-3333-4444-555555555555"

documentUuid
string<uuid>
requerido

UUID del documento de Document AI (document_ai_documents[].items[].uuid en GET /v3/session/{sessionId}/decision/). Debe pertenecer a la sesión indicada en la ruta.

Ejemplo:

"44444444-5555-6666-7777-888888888888"

Cuerpo

application/json
extracted_data
object

Claves de campo (las claves que configuraste para el documento) y sus valores corregidos. Debe ser un objeto JSON; se combina clave por clave con los datos almacenados. Omítelo en lugar de enviar null, que devuelve 400.

Ejemplo:
status
enum<string>

Nuevo estado de revisión del documento.

Opciones disponibles:
Approved,
Declined,
In Review,
Not Finished
Ejemplo:

"Approved"

Respuesta

Documento actualizado. Devuelve el documento después de la combinación.

uuid
string<uuid>
requerido

Identificador del documento.

document_key
string
requerido

El documento configurado al que corresponde esta carga.

original_filename
string | null
requerido

Nombre de archivo con el que se subió el documento.

file_url
string | null
requerido

Ruta de almacenamiento del archivo subido. No es un enlace de descarga: lee el file_url prefirmado de la decisión de la sesión para descargar el archivo.

status
enum<string>
requerido

Estado de revisión del documento.

Opciones disponibles:
Not Finished,
Approved,
Declined,
In Review,
Resub Requested
extracted_data
object | null
requerido

Todos los campos extraídos tras la combinación, indexados por clave de campo.

Última modificación el 1 de noviembre de 2026