Passer au contenu principal
POST
curl

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.

En-têtes

Content-Type
string

Définir sur application/json lors de l'envoi d'un corps JSON.

Exemple:

"application/json"

Paramètres de chemin

session_id
string<uuid>
requis

UUID de la session de Vérification des utilisateurs (KYC). Doit appartenir à la même application que la clé API — les UUID inter-applications, les sessions supprimées et les identifiants de session de Vérification d'entreprise (KYB) renvoient tous 404.

Exemple:

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

Corps

application/json
new_status
enum<string> | null

Libellé de statut optionnel à enregistrer sur l'entrée. Accepte toute valeur de statut de session, sensible à la casse ("approved" est rejeté avec 400). Enregistrer un statut ici ne modifie pas le statut réel de la session — utilisez l'endpoint de mise à jour du statut pour cela.

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

"In Review"

comment
string | null

Note en texte libre optionnelle (aucune limite de longueur imposée). Stockée textuellement ; les mentions @email ne sont pas traitées sur cet endpoint.

Exemple:

"Flagging for manual document re-check."

Réponse

Entrée enregistrée dans le journal d'audit de la session. La session elle-même reste inchangée — son status conserve sa valeur précédente et aucun webhook n'est envoyé. La nouvelle entrée apparaît également en tête de GET …/reviews/ (avec actor_display: "Unknown").

user
string

Nom d'affichage de l'auteur de l'entrée. Toujours "Unknown" pour les entrées créées via cet endpoint, car il n'enregistre aucune attribution d'acteur.

Exemple:

"Unknown"

new_status
enum<string> | null

Le libellé de statut enregistré sur l'entrée, ou null si aucun n'a été transmis. Le statut réel de la session n'est pas affecté.

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

"In Review"

comment
string | null

La note enregistrée sur l'entrée, ou null si aucune n'a été envoyée.

Exemple:

"Flagging for manual document re-check."

created_at
string<date-time>

Date et heure d'écriture de l'entrée, ISO 8601 UTC.

Exemple:

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

Dernière modification le 7 novembre 2026