Passer au contenu principal
PATCH
Python

Autorisations

x-api-key
string
header
requis

La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys.

Paramètres de chemin

sessionId
string<uuid>
requis

UUID de la session de Vérification d'entreprise (KYB). Il doit appartenir à l'application de la clé API.

Exemple:

"33333333-4444-5555-6666-777777777777"

draftId
string<uuid>
requis

UUID du brouillon de la partie (draft_id renvoyé lors de sa création).

Exemple:

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

Paramètres de requête

node_id
string

Nœud de workflow de l'étape KYB. Nécessaire uniquement lorsque le workflow comporte plus d'un nœud KYB ; par défaut, Didit utilise le nœud propre à la session.

Corps

application/json

Tout sous-ensemble des champs de la partie. La modification est fusionnée dans le brouillon enregistré et la partie fusionnée est validée dans son ensemble, de sorte qu'un brouillon qui pouvait être soumis avant une modification peut toujours l'être après celle-ci.

entity_type
enum<string>

Indique si la partie est un particulier ou une entreprise.

Options disponibles:
person,
company
full_name
string

Nom complet d'une personne. Envoyez-le, ou transmettez first_name et last_name.

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

Rôle que détient la partie. Interchangeable avec roles ; lorsque les deux sont envoyés, ils sont fusionnés.

Options 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>[]

Chaque rôle détenu par la partie. Une personne a besoin d'au moins un rôle (ici ou dans role).

Options 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

Intitulé du poste d'une personne.

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

Nom d'une partie représentant l'entreprise. Requis lorsque entity_type est company.

Maximum string length: 255
registration_number
string

Numéro d'immatriculation d'une partie de l'entreprise.

Maximum string length: 100
email
string<email>

Destination d'envoi du lien de vérification. Requis lorsque la partie doit effectuer une vérification, ce qui dépend des paramètres de rôle et des seuils d'actionnariat du workflow.

ownership_percent
number | null

Part de l'entreprise détenue par la partie.

nationality
string

Nationalité d'une personne, ou pays de constitution d'une entreprise. Obligatoire pour chaque partie.

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

Champs supplémentaires définis par le workflow.

skip_verification
boolean
défaut:false

Demander d'ignorer la vérification de cette partie. Pris en compte uniquement lorsque le rôle de la partie permet de l'ignorer dans les paramètres Personnes clés du workflow.

Réponse

Brouillon mis à jour.

draft_id
string<uuid>
requis
created_at
string<date-time>
requis
updated_at
string<date-time>
requis
party
object
requis
Dernière modification le 7 novembre 2026