Saltar al contenido principal
PATCH
Python

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 empresas (KYB). Debe pertenecer a la aplicación de la clave de API.

Ejemplo:

"33333333-4444-5555-6666-777777777777"

draftId
string<uuid>
requerido

UUID del borrador de la parte (el draft_id que se devolvió al crearlo).

Ejemplo:

"5b0d7a52-9d3e-4f0c-8c6a-0e5f3a1b2c4d"

Parámetros de consulta

node_id
string

Nodo del flujo correspondiente al paso KYB. Solo es necesario cuando el flujo tiene más de un nodo KYB; de forma predeterminada, Didit usa el propio nodo de la sesión.

Cuerpo

application/json

Cualquier subconjunto de los campos de la parte. La edición se combina con el borrador almacenado y la parte resultante se valida en su conjunto, de modo que un borrador que podía enviarse antes de una edición sigue pudiendo enviarse después.

entity_type
enum<string>

Si la parte es una persona física o una empresa.

Opciones disponibles:
person,
company
full_name
string

Nombre completo de una persona. Envíalo, o bien first_name y last_name.

Maximum string length: 255
first_name
string
Maximum string length: 128
last_name
string
Maximum string length: 128
role
enum<string>

Rol que tiene la parte. Equivalente a roles; si se envían ambos, se combinan.

Opciones disponibles:
director,
non_executive_director,
secretary,
chairman,
ubo,
shareholder,
representative,
founder,
legal_advisor,
authorized_signatory,
trustee,
beneficiary,
settlor,
protector,
company_officer,
investor,
other
roles
enum<string>[]

Todos los roles que tiene la parte. Una persona necesita al menos un rol (aquí o en role).

Opciones disponibles:
director,
non_executive_director,
secretary,
chairman,
ubo,
shareholder,
representative,
founder,
legal_advisor,
authorized_signatory,
trustee,
beneficiary,
settlor,
protector,
company_officer,
investor,
other
position
string

Cargo de una persona.

Maximum string length: 128
date_of_birth
string<date> | null
company_name
string

Nombre de una parte que es una empresa. Obligatorio cuando entity_type es company.

Maximum string length: 255
registration_number
string

Número de registro de una parte que es una empresa.

Maximum string length: 100
email
string<email>

Destino al que se envía el enlace de verificación. Obligatorio cuando la parte tiene que completar la verificación, lo que depende de la configuración de roles y de los umbrales de propiedad del flujo.

ownership_percent
number | null

Participación de la empresa que posee la parte.

nationality
string

Nacionalidad de una persona o país de constitución de una empresa. Obligatorio para cada parte.

Maximum string length: 100
phone_number
string
Maximum string length: 32
custom_fields
object

Campos adicionales definidos en el flujo.

skip_verification
boolean
predeterminado:false

Solicita omitir la verificación de esta parte. Solo se aplica cuando el rol de la parte permite omitirla en la configuración de Personas clave del flujo.

Respuesta

Borrador actualizado.

draft_id
string<uuid>
requerido
created_at
string<date-time>
requerido
updated_at
string<date-time>
requerido
party
object
requerido
Última modificación el 1 de noviembre de 2026