Vai al contenuto principale
POST
curl
Quando esegui un override di un passaggio con defer_until_flow_finishes: true mentre l’utente è ancora nel flusso, l’override resta in attesa e viene applicato al termine del flusso. Annullalo qui se non vuoi più che venga applicato. Il controllo mantiene il proprio stato attuale. L’annullamento viene registrato nell’attività della sessione come FEATURE_OVERRIDE_CANCELLED e non viene inviato alcun webhook. La risposta è l’override con state: cancelled e cancel_reason: cancelled_by_reviewer.

Trova l’ID dell’override

Usa il valore id dell’oggetto override restituito da Aggiorna lo stato della funzionalità, oppure elenca gli override della sessione con Elenca gli override della funzionalità e scegli quello il cui state è pending_until_flow_finishes.

Quando l’annullamento non riesce

Un override già applicato o annullato restituisce 409 con il codice feature_override_not_pending. Per modificare un controllo dopo che il relativo override è stato applicato, invia invece una nuova richiesta Aggiorna lo stato della funzionalità.

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

sessionId
string<uuid>
obbligatorio

UUID della sessione di verifica. Accetta sia ID di sessione utente (KYC) sia ID di sessione aziendale (KYB).

Esempio:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

overrideId
string<uuid>
obbligatorio

L'id dell'override da annullare.

Esempio:

"9b2f4c1e-8d3a-4e5f-a6b7-c8d9e0f1a2b3"

Risposta

L'override è annullato e non verrà mai applicato.

Un override dello stato di un controllo (funzionalità) eseguito con PATCH /v3/session/{sessionId}/features/{nodeId}/update-status/: cosa modifica, se è stato applicato o è ancora in attesa che la persona completi il flusso, chi lo ha richiesto e perché.

id
string<uuid>
obbligatorio

Identificatore dell'override. Passalo all'endpoint di annullamento.

Esempio:

"7c9e6679-7425-40de-944b-e07fc1f90ae7"

node_id
string
obbligatorio

Il nodo del workflow indicato dalla richiesta (default per un passaggio privo di nodo).

Esempio:

"feature_ocr_1"

feature_type
string
obbligatorio

Il feature_type passato dalla richiesta, oppure una stringa vuota se non ne è stato passato alcuno.

Esempio:

""

feature_model
string
obbligatorio

Il tipo di controllo che è stato ignorato manualmente, ad esempio KYC, Face, AML o GeolocationCheck.

Esempio:

"KYC"

previous_status
enum<string>
obbligatorio

Lo stato del controllo al momento della richiesta dell'override.

Opzioni disponibili:
Not Finished,
Approved,
Declined,
In Review,
Resub Requested
Esempio:

"In Review"

new_status
enum<string>
obbligatorio

Lo stato impostato dall'override.

Opzioni disponibili:
Approved,
Declined,
In Review
Esempio:

"Approved"

state
enum<string>
obbligatorio

applied: il controllo ha il nuovo stato. pending_until_flow_finishes: l'override resta in attesa e viene applicato quando la persona completa il flusso. cancelled: è rimasto in attesa e non è mai stato applicato (vedi cancel_reason).

Opzioni disponibili:
applied,
pending_until_flow_finishes,
cancelled
Esempio:

"applied"

forced
boolean
obbligatorio

true quando l'override è stato applicato immediatamente mentre la persona si trovava ancora nel flusso.

Esempio:

false

reason
string | null
obbligatorio

Il comment inviato con la richiesta, oppure null.

Esempio:

"Document manually verified by compliance."

requested_by
object | null
obbligatorio

Chi ha richiesto l'override, o null quando non è noto.

requested_at
string<date-time>
obbligatorio

Quando è stato richiesto l'override.

Esempio:

"2026-10-13T09:15:00Z"

applied_at
string<date-time> | null
obbligatorio

Data e ora in cui il controllo ha assunto il nuovo stato, oppure null mentre è in attesa o una volta annullato.

Esempio:

"2026-10-13T09:15:00Z"

cancelled_at
string<date-time> | null
obbligatorio

Quando un override in attesa è stato annullato, oppure null.

Esempio:

null

cancel_reason
enum<string> | null
obbligatorio

Il motivo per cui un override in attesa non è mai stato applicato, oppure null. cancelled_by_reviewer: annullato con l'endpoint di annullamento. replaced: sostituito da un override più recente sullo stesso controllo. check_changed: la persona ha ripetuto il controllo prima di completare il flusso. session_closed: la sessione è uscita dal flusso prima che la persona lo completasse (abbandonata, scaduta o decisa a metà flusso).

Opzioni disponibili:
cancelled_by_reviewer,
replaced,
check_changed,
session_closed,
null
Esempio:

null

Ultima modifica il 7 novembre 2026