> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Annulla override funzionalità API: passaggio in sospeso > Annulla un override dello stato del passaggio in attesa del completamento del flusso: non verrà applicato e lo stato resta invariato in Didit. Prompt per annullare l'override della funzionalità Copia il prompt negli appunti \

\`Cancel a check (feature) status override on a Didit session that still waits for the person to finish the flow, so it never applies.

Endpoint:
POST https://verification.didit.me/v3/session/{session_id}/features/overrides/{override_id}/cancel/

Authentication:
x-api-key (client API key) or a user-auth token. Privilege: write:sessions. A scoped API key needs write access to decisions.

Path parameters:
\- session_id (UUID): KYC or KYB; Didit resolves it against both session types.
\- override_id (UUID): the id of the override, from the "override" object returned by PATCH /v3/session/{session_id}/features/{node_id}/update-status/ or from GET /v3/session/{session_id}/features/overrides/.

Request body: none.

Only an override whose state is "pending_until_flow_finishes" can be cancelled.

Response (200): the override, with state "cancelled", cancelled_at set and cancel_reason "cancelled_by_reviewer".

Side effects:
\- The check keeps its current status.
\- The cancellation is recorded in the session's activity as FEATURE_OVERRIDE_CANCELLED.
\- No webhook is sent.

curl example:
curl -X POST https://verification.didit.me/v3/session//features/overrides//cancel/ \
-H "x-api-key: "

Failure modes:
\- 401: the scoped API key has expired.
\- 403: missing credentials (a wrong, revoked or expired key gets 401), the caller lacks write:sessions, a scoped key lacks decisions write, or the session belongs to another application ({ "detail": "You do not have permission to perform this action." }).
\- 404: { "detail": "Not found." } when no session with this session_id exists, or { "detail": "Override not found." } when the session has no override with this override_id.
\- 409: { "detail": "This override is no longer pending: it already applied or was cancelled.", "code": "feature_override_not_pending" }.

For end-to-end Didit integration, paste in the full prompt at /integration/integration-prompt.`

\
Incolla in 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'overrideUsa il valore `id` dell'oggetto `override` restituito da [Aggiorna lo stato della funzionalità](https://docs.didit.me/it/sessions-api/update-feature-status.md), oppure elenca gli override della sessione con [Elenca gli override della funzionalità](https://docs.didit.me/it/sessions-api/list-feature-overrides.md) e scegli quello il cui `state` è `pending_until_flow_finishes`.## Quando l'annullamento non riesceUn 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à](https://docs.didit.me/it/sessions-api/update-feature-status.md).## Correlati- [Aggiorna lo stato della funzionalità](https://docs.didit.me/it/sessions-api/update-feature-status.md): sovrascrive lo stato di un passaggio, subito oppure al termine del flusso. - [Elenca gli override della funzionalità](https://docs.didit.me/it/sessions-api/list-feature-overrides.md): tutti gli override di una sessione e il loro stato. ## OpenAPI ````yaml it/openapi-25.json POST /v3/session/{sessionId}/features/overrides/{overrideId}/cancel/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API di verifica dell'identità. Autenticati con l'intestazione x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/session/{sessionId}/features/overrides/{overrideId}/cancel/: post: tags: - Sessions summary: Annulla un override di controllo in attesa del completamento del flusso description: >- Annulla l'override dello stato di una funzionalità (passaggio) ancora `pending_until_flow_finishes`, in modo che non venga mai applicato. Il controllo mantiene il suo stato, l'annullamento viene registrato nelle 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`. Un override già applicato o annullato restituisce `409` con il codice `feature_override_not_pending`. Trova gli ID degli override con `GET /v3/session/{sessionId}/features/overrides/` o nell'oggetto `override` restituito dall'aggiornamento dello stato della funzionalità. Richiede il privilegio `write:sessions`; una chiave API con ambito limitato necessita dell'accesso in scrittura alle decisioni. operationId: post_v3_session_feature_override_cancel parameters: - in: path name: sessionId required: true description: >- UUID della sessione di verifica. Accetta sia ID di sessione utente (KYC) sia ID di sessione aziendale (KYB). schema: type: string format: uuid example: 3fa85f64-5717-4562-b3fc-2c963f66afa6 - in: path name: overrideId required: true description: L'`id` dell'override da annullare. schema: type: string format: uuid example: 9b2f4c1e-8d3a-4e5f-a6b7-c8d9e0f1a2b3 responses: '200': description: L'override è annullato e non verrà mai applicato. content: application/json: schema: $ref: '#/components/schemas/FeatureStatusOverride' examples: Cancelled: summary: L'override annullato value: id: 9b2f4c1e-8d3a-4e5f-a6b7-c8d9e0f1a2b3 node_id: feature_liveness_1 feature_type: '' feature_model: Face previous_status: Declined new_status: Approved state: cancelled forced: false reason: Liveness retried with a reviewer present. requested_by: email: reviewer@example.com name: Alex Reviewer type: CONSOLE_USER requested_at: '2026-10-13T09:15:00Z' applied_at: null cancelled_at: '2026-10-13T09:20:00Z' cancel_reason: cancelled_by_reviewer '401': description: La chiave API con ambito è scaduta. content: application/json: examples: Expired API Key: summary: Chiave API con ambito oltre la sua data di scadenza value: detail: This API key has expired. '403': description: >- Credenziali mancanti, chiamante senza il privilegio `write:sessions`, chiave API con ambito limitato priva dell'accesso richiesto da questo endpoint, oppure un `session_id` che appartiene a un'altra applicazione. content: application/json: examples: Invalid Credentials: summary: x-api-key mancante o non valida value: detail: >- Authentication credentials were not provided or are invalid. Missing Privilege: summary: Il chiamante non dispone dell'autorizzazione write:sessions value: detail: You do not have permission to perform this action. Scoped Key Without Access: summary: Chiave API con ambito priva di questo accesso value: detail: This API key has no write access to decisions. '404': description: >- Non esiste alcuna sessione KYC o KYB con questo `session_id`, oppure la sessione non ha alcun override con questo `overrideId`. content: application/json: examples: Not Found: summary: session_id sconosciuto value: detail: Not found. Override Not Found: summary: Nessun override con questo id nella sessione value: detail: Override not found. '409': description: L'override è già stato applicato o è stato annullato. content: application/json: examples: Not Pending: summary: È possibile annullare solo un override in attesa value: detail: >- This override is no longer pending: it already applied or was cancelled. code: feature_override_not_pending security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: |- curl -X POST \ https://verification.didit.me/v3/session/3fa85f64-5717-4562-b3fc-2c963f66afa6/features/overrides/9b2f4c1e-8d3a-4e5f-a6b7-c8d9e0f1a2b3/cancel/ \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.sessions.cancel_feature_override( "3fa85f64-5717-4562-b3fc-2c963f66afa6", "9b2f4c1e-8d3a-4e5f-a6b7-c8d9e0f1a2b3", ) print(result) - lang: javascript label: Node.js source: |- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.sessions.cancelFeatureOverride( "3fa85f64-5717-4562-b3fc-2c963f66afa6", "9b2f4c1e-8d3a-4e5f-a6b7-c8d9e0f1a2b3", ); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Sessions.CancelFeatureOverride(ctx, \"3fa85f64-5717-4562-b3fc-2c963f66afa6\", \"9b2f4c1e-8d3a-4e5f-a6b7-c8d9e0f1a2b3\")\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.sessions().cancelFeatureOverride("3fa85f64-5717-4562-b3fc-2c963f66afa6", "9b2f4c1e-8d3a-4e5f-a6b7-c8d9e0f1a2b3"); System.out.println(result); - lang: php label: PHP source: >- sessions->cancelFeatureOverride('3fa85f64-5717-4562-b3fc-2c963f66afa6', '9b2f4c1e-8d3a-4e5f-a6b7-c8d9e0f1a2b3'); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.sessions.cancel_feature_override( "3fa85f64-5717-4562-b3fc-2c963f66afa6", "9b2f4c1e-8d3a-4e5f-a6b7-c8d9e0f1a2b3" ) puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.Sessions.CancelFeatureOverrideAsync("3fa85f64-5717-4562-b3fc-2c963f66afa6", "9b2f4c1e-8d3a-4e5f-a6b7-c8d9e0f1a2b3"); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: FeatureStatusOverride: type: object description: >- 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é. required: - id - node_id - feature_type - feature_model - previous_status - new_status - state - forced - reason - requested_by - requested_at - applied_at - cancelled_at - cancel_reason properties: id: type: string format: uuid description: Identificatore dell'override. Passalo all'endpoint di annullamento. example: 7c9e6679-7425-40de-944b-e07fc1f90ae7 node_id: type: string description: >- Il nodo del workflow indicato dalla richiesta (`default` per un passaggio privo di nodo). example: feature_ocr_1 feature_type: type: string description: >- Il `feature_type` passato dalla richiesta, oppure una stringa vuota se non ne è stato passato alcuno. example: '' feature_model: type: string description: >- Il tipo di controllo che è stato ignorato manualmente, ad esempio `KYC`, `Face`, `AML` o `GeolocationCheck`. example: KYC previous_status: type: string enum: - Not Finished - Approved - Declined - In Review - Resub Requested description: Lo stato del controllo al momento della richiesta dell'override. example: In Review new_status: type: string enum: - Approved - Declined - In Review description: Lo stato impostato dall'override. example: Approved state: type: string enum: - applied - pending_until_flow_finishes - cancelled description: >- `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`). example: applied forced: type: boolean description: >- `true` quando l'override è stato applicato immediatamente mentre la persona si trovava ancora nel flusso. example: false reason: type: string nullable: true description: Il `comment` inviato con la richiesta, oppure `null`. example: Document manually verified by compliance. requested_by: type: object nullable: true description: Chi ha richiesto l'override, o `null` quando non è noto. properties: email: type: string format: email nullable: true description: >- Email dell'utente della console, oppure `null` per le chiavi API e il sistema. example: reviewer@example.com name: type: string nullable: true description: Nome visualizzato del richiedente, oppure `null`. example: Alex Reviewer type: type: string enum: - CONSOLE_USER - API_KEY - SYSTEM description: >- Chi ha effettuato la richiesta: un utente della console, una chiave API o Didit stessa. example: CONSOLE_USER requested_at: type: string format: date-time description: Quando è stato richiesto l'override. example: '2026-10-13T09:15:00Z' applied_at: type: string format: date-time nullable: true description: >- Data e ora in cui il controllo ha assunto il nuovo stato, oppure `null` mentre è in attesa o una volta annullato. example: '2026-10-13T09:15:00Z' cancelled_at: type: string format: date-time nullable: true description: Quando un override in attesa è stato annullato, oppure `null`. example: null cancel_reason: type: string nullable: true enum: - cancelled_by_reviewer - replaced - check_changed - session_closed - null description: >- 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). example: null securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- 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. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.