Pular para o conteúdo principal
POST
curl

Autorizações

x-api-key
string
header
obrigatório

Chave de API da sua aplicação, em Developers -> API keys no Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter escopo restrito: nenhum acesso, leitura ou escrita por recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está errada, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que a requisição veio de um endereço fora da sua lista de IPs; 404 em uma rota de sessão significa que a sessão está fora dos fluxos ou status da chave. Uma chave sem acesso a mídia recebe URLs de imagem, vídeo e PDF como null, e uma chave sem permissão de escrita em sessões recebe links e tokens de sessão como null. Consulte https://docs.didit.me/console/api-keys.

Cabeçalhos

Content-Type
string

Defina como application/json ao enviar um corpo JSON.

Exemplo:

"application/json"

Parâmetros de caminho

session_id
string<uuid>
obrigatório

UUID da sessão de Verificação de usuários (KYC). Deve pertencer à mesma aplicação da chave de API: UUIDs de outras aplicações, sessões excluídas e IDs de sessões de Verificação de empresas (KYB) retornam 404.

Exemplo:

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

Corpo

application/json
new_status
enum<string> | null

Rótulo de status opcional a ser registrado na entrada. Aceita qualquer valor de status de sessão, diferenciando maiúsculas de minúsculas ("approved" é rejeitado com 400). Registrar um status aqui não altera o status real da sessão; para isso, use o endpoint de atualização de status.

Opções disponíveis:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User
Exemplo:

"In Review"

comment
string | null

Nota opcional em texto livre (sem limite de tamanho imposto). É armazenada literalmente; menções @email não são processadas neste endpoint.

Exemplo:

"Flagging for manual document re-check."

Resposta

Entrada registrada na trilha de auditoria da sessão. A sessão em si não é alterada: o seu status mantém o valor anterior e nenhum webhook é enviado. A nova entrada também aparece no topo de GET …/reviews/ (com actor_display: "Unknown").

user
string

Nome de exibição do autor da entrada. Sempre "Unknown" para entradas criadas por este endpoint, porque ele não registra a atribuição de autoria.

Exemplo:

"Unknown"

new_status
enum<string> | null

O rótulo de status registrado na entrada, ou null se nenhum foi enviado. O status real da sessão não é afetado.

Opções disponíveis:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User
Exemplo:

"In Review"

comment
string | null

A nota registrada na entrada, ou null se nenhuma foi enviada.

Exemplo:

"Flagging for manual document re-check."

created_at
string<date-time>

Quando a entrada foi gravada, em ISO 8601 UTC.

Exemplo:

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

Última modificação em 1 de novembro de 2026