Vai al contenuto principale
POST
curl
Crea un caso collegato a esattamente un soggetto. Fornisci direttamente subject, oppure fornisci links e lascia che Didit ricavi il soggetto dal proprietario della prima entità collegata.
Passa blueprint ogni volta che ne hai uno: determina quali sezioni della pagina del caso vengono visualizzate, se la risoluzione richiede una nota e dove viene instradato il caso in caso di escalation o trasferimento.

Correlati

Autorizzazioni

x-api-key
string
header
obbligatorio

La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys.

Parametri del percorso

organization_id
string<uuid>
obbligatorio

UUID dell'organizzazione.

application_id
string<uuid>
obbligatorio

UUID dell'applicazione.

Corpo

application/json
title
string
obbligatorio
Maximum string length: 255
blueprint
string<uuid> | null

UUID di CaseBlueprint. Ometti se non c'è alcun blueprint.

priority
enum<string>
predefinito:MEDIUM
Opzioni disponibili:
LOW,
MEDIUM,
HIGH
due_at
string<date-time> | null
tags
string[]
subject
object

Obbligatorio a meno che non venga fornito links; l'unico soggetto del caso.

Sessioni/sessioni aziendali/transazioni da associare al momento della creazione, ad es. [{"entity_type": "transaction", "entity_uuid": "..."}]. Quando subject viene omesso, il soggetto viene ricavato dal proprietario del primo collegamento.

assigned_to
string<uuid> | null

UUID dell'utente da assegnare immediatamente.

review_duplicates
boolean
predefinito:false

Verifica nuovamente le indagini esistenti prima di creare il caso. Se impostato su true, un soggetto con casi esistenti richiede un valore non vuoto per separate_incident_reason. La console abilita sempre questa protezione. L'omissione mantiene il comportamento esistente dell'API.

separate_incident_reason
string
Maximum string length: 1000
source_context
object

Risposta

Caso creato.

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

L'unico utente o azienda a cui è associato il caso.

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

Il team di revisione assegnatario del caso, oppure null se non è assegnato ad alcun team. L'instradamento lo imposta quando una regola di instradamento assegna il caso a uno dei suoi team. Modificalo o cancellalo con 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

Impostato solo mentre una risoluzione a 4 occhi è predisposta sul blueprint checker, in attesa di approvazione o rifiuto dell'approvazione.

checker
object | null

Il membro designato per approvare o rifiutare la risoluzione in sospeso. Impostato solo mentre una risoluzione a quattro occhi attende un verificatore designato. Null quando non c'è nulla in sospeso, mentre la risoluzione in sospeso attende nella coda dei verificatori e una volta che la risoluzione è approvata, rifiutata o restituita per una nuova revisione a seguito della modifica delle prove.

metadata
object
blueprint
object
notes
object[]

Le 50 note più recenti.

events
object[]

I 100 eventi più recenti.

notes_count
integer
checklist_items
object[]
created_at
string<date-time>
updated_at
string<date-time>
Ultima modifica il 7 novembre 2026