Saltar al contenido principal
PATCH
curl
Los enlaces prefirmados de extra_files expiran. Cuando necesites los archivos más adelante, obtén enlaces nuevos de la decisión de la sesión. Si lo que quieres es corregir los datos extraídos de un documento, usa Actualizar datos 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 de usuarios (KYC) a la que se añade el archivo (el session_id que devuelve POST /v3/session/). Un ID de sesión de Verificación de empresas (KYB) devuelve 404.

Ejemplo:

"11111111-2222-3333-4444-555555555555"

Cuerpo

multipart/form-data
file
file
requerido

La imagen o el PDF. Extensiones permitidas: jpg, jpeg, png, webp, tiff, pdf. Como máximo 15 MB al subirlo; después, el archivo se comprime y se rechaza con 400 si sigue superando los 2 MB (2,097,152 bytes). Los archivos vacíos se rechazan.

model_type
enum<string>
requerido

kyc añade el archivo al resultado de la verificación de identidad; poa, al resultado de la Prueba de domicilio.

Opciones disponibles:
kyc,
poa
Ejemplo:

"kyc"

file_password
string

Contraseña de un PDF cifrado. Sin ella, o con una incorrecta, un PDF cifrado devuelve 400.

Respuesta

Archivo añadido. Devuelve todos los archivos adicionales de ese resultado, incluido el nuevo.

extra_files
(string<uri> | null)[]
requerido

Enlaces prefirmados de corta duración a todos los archivos adicionales del resultado indicado por model_type, del más antiguo al más reciente. Cada enlace es null para una clave de API con alcance limitado sin media: read. Más adelante, obtén enlaces nuevos de la decisión de la sesión.

Última modificación el 1 de noviembre de 2026