> ## 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.

# Cancel·lar sobreescriptura de pas pendent: API de Didit

> Cancel·la a Didit una sobreescriptura d'estat de pas que encara espera que la persona acabi el flux. Així no s'aplica mai i el pas manté el seu estat.



Indicació per cancel·lar una substitució de funcionalitat
        Copia el prompt al porta-retalls



      
      

\<pre>

\`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/<SESSION_ID>/features/overrides/<OVERRIDE_ID>/cancel/ \
-H "x-api-key: <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.`

\</pre>



      
      

Enganxa a

Quan fas una substitució d'un pas amb `defer_until_flow_finishes: true` mentre la persona encara és al flux de treball, la substitució queda en espera i s'aplica quan acaba el flux de treball.
Cancel·la-la aquí si ja no vols que s'apliqui.La comprovació manté el seu estat actual.
La cancel·lació queda registrada a l'activitat de la sessió com a `FEATURE_OVERRIDE_CANCELLED`, i no s'envia cap webhook.
La resposta és la substitució amb `state: cancelled` i `cancel_reason: cancelled_by_reviewer`.## Troba l'ID de la substitucióUsa el `id` de l'objecte `override` que retorna [Update Feature Status](https://docs.didit.me/ca/sessions-api/update-feature-status.md), o llista les substitucions de la sessió amb [List Feature Overrides](https://docs.didit.me/ca/sessions-api/list-feature-overrides.md) i tria'n una amb `state` `pending_until_flow_finishes`.## Quan la cancel·lació fallaUna substitució que ja s'ha aplicat o cancel·lat retorna `409` amb el codi `feature_override_not_pending`.
Per canviar una comprovació després que la seva substitució s'hagi aplicat, envia en canvi una nova sol·licitud [Update Feature Status](https://docs.didit.me/ca/sessions-api/update-feature-status.md).## Relacionats- [Update Feature Status](https://docs.didit.me/ca/sessions-api/update-feature-status.md): substitueix l'estat d'un pas, ara o quan acabi el flux de treball.
- [List Feature Overrides](https://docs.didit.me/ca/sessions-api/list-feature-overrides.md): totes les substitucions d'una sessió i el seu estat.


## OpenAPI

````yaml ca/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 de verificació d'identitat. Autentica't amb la capçalera x-api-key.
servers:
  - url: https://verification.didit.me
security: []
tags: []
paths:
  /v3/session/{sessionId}/features/overrides/{overrideId}/cancel/:
    post:
      tags:
        - Sessions
      summary: >-
        Cancel·lar una modificació manual de verificació que espera que acabi el
        flux
      description: >-
        Cancel·la una modificació manual de l'estat d'una funcionalitat (pas)
        que encara estigui `pending_until_flow_finishes`, de manera que mai no
        s'apliqui. La verificació manté el seu estat, la cancel·lació es
        registra a l'activitat de la sessió com a `FEATURE_OVERRIDE_CANCELLED` i
        no s'envia cap webhook. La resposta és la modificació manual amb `state:
        cancelled` i `cancel_reason: cancelled_by_reviewer`.


        Una modificació manual que ja s'hagi aplicat o s'hagi cancel·lat retorna
        `409` amb el codi `feature_override_not_pending`. Pots trobar els ID de
        les modificacions manuals amb `GET
        /v3/session/{sessionId}/features/overrides/` o a l'objecte `override`
        que retorna l'actualització d'estat de la funcionalitat.


        Requereix el permís `write:sessions`; una clau d'API amb abast limitat
        necessita accés d'escriptura a les decisions.
      operationId: post_v3_session_feature_override_cancel
      parameters:
        - in: path
          name: sessionId
          required: true
          description: >-
            UUID de la sessió de verificació. Accepta tant IDs de sessió
            d'usuari (KYC) com d'empresa (KYB).
          schema:
            type: string
            format: uuid
            example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
        - in: path
          name: overrideId
          required: true
          description: L'`id` de l'override que es vol cancel·lar.
          schema:
            type: string
            format: uuid
            example: 9b2f4c1e-8d3a-4e5f-a6b7-c8d9e0f1a2b3
      responses:
        '200':
          description: La substitució s'ha cancel·lat i no s'aplicarà mai.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeatureStatusOverride'
              examples:
                Cancelled:
                  summary: La sobreescriptura cancel·lada
                  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 clau d'API amb abast ha caducat.
          content:
            application/json:
              examples:
                Expired API Key:
                  summary: Clau d'API amb abast que ha superat la data de caducitat
                  value:
                    detail: This API key has expired.
        '403':
          description: >-
            Falten les credencials, qui fa la crida no té el privilegi
            `write:sessions`, la clau d'API amb abast limitat no té l'accés que
            necessita aquest endpoint, o el `session_id` pertany a una altra
            aplicació.
          content:
            application/json:
              examples:
                Invalid Credentials:
                  summary: Falta l'x-api-key o no és vàlid
                  value:
                    detail: >-
                      Authentication credentials were not provided or are
                      invalid.
                Missing Privilege:
                  summary: L'emissor de la crida no disposa de write:sessions
                  value:
                    detail: You do not have permission to perform this action.
                Scoped Key Without Access:
                  summary: Clau d'API amb abast sense aquest accés
                  value:
                    detail: This API key has no write access to decisions.
        '404':
          description: >-
            No existeix cap sessió de KYC o KYB amb aquest `session_id`, o la
            sessió no té cap anul·lació amb aquest `overrideId`.
          content:
            application/json:
              examples:
                Not Found:
                  summary: session_id desconegut
                  value:
                    detail: Not found.
                Override Not Found:
                  summary: No hi ha cap sobreescriptura amb aquest id a la sessió
                  value:
                    detail: Override not found.
        '409':
          description: La substitució ja s'ha aplicat o s'ha cancel·lat.
          content:
            application/json:
              examples:
                Not Pending:
                  summary: Només es pot cancel·lar una invalidació en espera
                  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: >-
            <?php


            require 'vendor/autoload.php';


            use Didit\DiditClient;


            // Reads DIDIT_API_KEY.

            $didit = new DiditClient();


            $result =
            $didit->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: >-
        Una sobreescriptura de l'estat d'una comprovació (funcionalitat) feta
        amb `PATCH /v3/session/{sessionId}/features/{nodeId}/update-status/`:
        què canvia, si s'ha aplicat o encara espera que la persona finalitzi el
        flux, qui ho ha sol·licitat i per què.
      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: >-
            Identificador de la sobreescriptura. Transmet-lo a l'endpoint de
            cancel·lació.
          example: 7c9e6679-7425-40de-944b-e07fc1f90ae7
        node_id:
          type: string
          description: >-
            El node del flux de treball indicat a la sol·licitud (`default` per
            a un pas sense node).
          example: feature_ocr_1
        feature_type:
          type: string
          description: >-
            El `feature_type` que ha passat la sol·licitud, o una cadena buida
            si no n'ha passat cap.
          example: ''
        feature_model:
          type: string
          description: >-
            El tipus de comprovació que s'ha anul·lat, per exemple `KYC`,
            `Face`, `AML` o `GeolocationCheck`.
          example: KYC
        previous_status:
          type: string
          enum:
            - Not Finished
            - Approved
            - Declined
            - In Review
            - Resub Requested
          description: L'estat de la comprovació quan es va sol·licitar la sobreescriptura.
          example: In Review
        new_status:
          type: string
          enum:
            - Approved
            - Declined
            - In Review
          description: L'estat que estableix l'anul·lació.
          example: Approved
        state:
          type: string
          enum:
            - applied
            - pending_until_flow_finishes
            - cancelled
          description: >-
            `applied`: la comprovació té el nou estat.
            `pending_until_flow_finishes`: la sobreescriptura espera i s'aplica
            quan la persona finalitza el flux. `cancelled`: ha esperat i no s'ha
            arribat a aplicar mai (consulta `cancel_reason`).
          example: applied
        forced:
          type: boolean
          description: >-
            `true` quan la sobreescriptura s'ha aplicat immediatament mentre la
            persona encara era al flux.
          example: false
        reason:
          type: string
          nullable: true
          description: El `comment` enviat amb la sol·licitud, o `null`.
          example: Document manually verified by compliance.
        requested_by:
          type: object
          nullable: true
          description: Qui ha sol·licitat la substitució, o `null` si no se sap.
          properties:
            email:
              type: string
              format: email
              nullable: true
              description: >-
                Correu electrònic de l'usuari de la consola, o `null` per a
                claus d'API i el sistema.
              example: reviewer@example.com
            name:
              type: string
              nullable: true
              description: Nom visible del sol·licitant, o `null`.
              example: Alex Reviewer
            type:
              type: string
              enum:
                - CONSOLE_USER
                - API_KEY
                - SYSTEM
              description: >-
                Qui ha fet la sol·licitud: un usuari de la consola, una clau
                d'API o el mateix Didit.
              example: CONSOLE_USER
        requested_at:
          type: string
          format: date-time
          description: Quan es va sol·licitar la sobreescriptura.
          example: '2026-10-13T09:15:00Z'
        applied_at:
          type: string
          format: date-time
          nullable: true
          description: >-
            Quan la comprovació va adoptar el nou estat, o `null` mentre està en
            espera o un cop cancel·lada.
          example: '2026-10-13T09:15:00Z'
        cancelled_at:
          type: string
          format: date-time
          nullable: true
          description: Quan es va cancel·lar una substitució en espera, o `null`.
          example: null
        cancel_reason:
          type: string
          nullable: true
          enum:
            - cancelled_by_reviewer
            - replaced
            - check_changed
            - session_closed
            - null
          description: >-
            Per què no es va aplicar mai una substitució en espera, o `null`.
            `cancelled_by_reviewer`: cancel·lada amb l'endpoint de cancel·lació.
            `replaced`: una substitució més recent en la mateixa comprovació la
            va substituir. `check_changed`: la persona ha tornat a fer la
            comprovació abans d'acabar el flux. `session_closed`: la sessió ha
            sortit del flux abans que la persona l'acabés (abandonada, caducada
            o decidida a mig flux).
          example: null
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        La clau d'API de la teva aplicació, des de Developers -> API keys a la
        Business Console. La clau primària té accés complet. Una clau amb nom
        pot tenir l'abast limitat: cap, lectura o escriptura per recurs,
        limitada a determinats fluxos de treball o a sessions aprovades, a una
        llista d'adreces IP i a una data de caducitat. 401 significa que la clau
        és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap
        clau, que la clau no té accés a aquest recurs o acció, o que la
        sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una
        ruta de sessió significa que la sessió està fora dels fluxos de treball
        o estats de la clau. Una clau sense accés a fitxers multimèdia rep els
        URL d'imatge, vídeo i PDF com a null, i una clau sense permís
        d'escriptura de sessions rep els enllaços de sessió i els tokens com a
        null. Consulta https://docs.didit.me/console/api-keys.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.