Saltar para o conteúdo principal
POST
curl
Crie um caso associado a exatamente um sujeito. Indique subject diretamente ou forneça links e deixe que a Didit determine o sujeito a partir do proprietário da primeira entidade ligada.
Indique blueprint sempre que tiver um - este determina quais as secções da página do caso que são apresentadas, se a resolução exige uma nota e para onde o caso é encaminhado em caso de escalonamento ou transferência.

Relacionados

Autorizações

x-api-key
string
header
obrigatório

A chave de API da sua aplicação, a partir de Programadores -> Chaves de API na Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter o âmbito definido: nenhum, 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á incorreta, 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 o pedido veio de um endereço fora da sua lista de IP; 404 numa rota de sessão significa que a sessão está fora dos fluxos ou estados da chave. Uma chave sem acesso a multimédia recebe URLs de imagens, vídeos e PDFs como nulos, e uma chave sem permissão de escrita em sessões recebe ligações de sessão e tokens como nulos. Consulte https://docs.didit.me/console/api-keys.

Parâmetros de caminho

organization_id
string<uuid>
obrigatório

UUID da organização.

application_id
string<uuid>
obrigatório

UUID da aplicação.

Corpo

application/json
title
string
obrigatório
Maximum string length: 255
blueprint
string<uuid> | null

UUID de CaseBlueprint. Omitir para não usar blueprint.

priority
enum<string>
padrão:MEDIUM
Opções disponíveis:
LOW,
MEDIUM,
HIGH
due_at
string<date-time> | null
tags
string[]
subject
object

Obrigatório exceto se links for fornecido; o sujeito estritamente único do caso.

Sessões/sessões de empresa/transações a anexar na criação, por exemplo, [{"entity_type": "transaction", "entity_uuid": "..."}]. Quando o assunto for omitido, o assunto é derivado do proprietário da primeira associação.

assigned_to
string<uuid> | null

UUID do utilizador a atribuir imediatamente.

review_duplicates
boolean
padrão:false

Volte a verificar investigações existentes antes de criar o caso. Quando for true, um sujeito com casos existentes exige um separate_incident_reason não vazio. A consola ativa sempre esta proteção. Omiti-la mantém o comportamento existente da API.

separate_incident_reason
string
Maximum string length: 1000
source_context
object

Resposta

Caso criado.

uuid
string<uuid>
case_number
string | null
title
string
status
enum<string>
Opções disponíveis:
OPEN,
AWAITING_USER,
RESOLVED
resolution
enum<string> | null
Opções disponíveis:
FALSE_POSITIVE,
VALID_THREAT,
INCONCLUSIVE,
REQUIREMENTS_NOT_MET,
REQUIREMENTS_SATISFIED
resolution_notes
string | null
priority
enum<string>
Opções disponíveis:
LOW,
MEDIUM,
HIGH
source
enum<string>
Opções disponíveis:
MANUAL,
AML_SCREENING,
TRANSACTION_RULE,
WORKFLOW_BUILDER
tags
string[]
subject
object | null

O único utilizador ou a única empresa a que o caso está associado.

assigned_to
object | null
assigned_at
string<date-time> | null
team
object | null

A equipa de revisão responsável pelo caso, ou null quando nenhuma equipa for responsável. O encaminhamento define-a quando uma regra de encaminhamento atribui o caso a uma das suas equipas. Altere ou limpe este valor com PATCH .../cases/{case_uuid}/ (team).

due_at
string<date-time> | null
resolved_at
string<date-time> | null
resolved_by_email
string | null
pending_resolution
object | null

Definido apenas enquanto uma resolução 4-eyes estiver preparada no blueprint do verificador, a aguardar aprovação ou rejeição.

checker
object | null

O membro designado para aprovar ou rejeitar a resolução pendente. Definido apenas enquanto uma resolução de quatro olhos aguarda por um revisor designado. Nulo quando nada estiver pendente, enquanto a resolução pendente aguarda na fila de revisores e assim que a resolução for aprovada, rejeitada ou devolvida para uma nova revisão porque as provas foram alteradas.

metadata
object
blueprint
object
notes
object[]

As 50 notas mais recentes.

events
object[]

Os 100 eventos mais recentes.

notes_count
integer
checklist_items
object[]
created_at
string<date-time>
updated_at
string<date-time>
Última modificação em 7 de novembro de 2026