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

# Feature-Überschreibung abbrechen (API)

> Mit Didit eine ausstehende Schritt-Überschreibung abbrechen, bevor die Person den Ablauf beendet. Der Schritt behält dann seinen Status.



Prompt zum Abbrechen der Funktionsüberschreibung
        Prompt in die Zwischenablage kopieren



      
      

\<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>



      
      

Einfügen in

Wenn Sie einen Schritt mit `defer_until_flow_finishes: true` überschreiben, während sich die Person noch im Workflow befindet, wartet die Überschreibung und wird angewendet, sobald der Workflow abgeschlossen ist.
Brechen Sie sie hier ab, wenn sie nicht mehr angewendet werden soll.Die Prüfung behält ihren aktuellen Status.
Der Abbruch wird im Aktivitätsprotokoll der Sitzung als `FEATURE_OVERRIDE_CANCELLED` erfasst, und es wird kein Webhook gesendet.
Die Antwort ist die Überschreibung mit `state: cancelled` und `cancel_reason: cancelled_by_reviewer`.## Override-ID findenVerwenden Sie die `id` des `override`-Objekts aus der Antwort von [Feature-Status aktualisieren](https://docs.didit.me/de/sessions-api/update-feature-status.md), oder listen Sie die Überschreibungen der Sitzung mit [Feature-Überschreibungen auflisten](https://docs.didit.me/de/sessions-api/list-feature-overrides.md) auf und wählen Sie eine aus, deren `state` `pending_until_flow_finishes` ist.## Wenn das Abbrechen fehlschlägtEine Überschreibung, die bereits angewendet oder abgebrochen wurde, gibt `409` mit dem Code `feature_override_not_pending` zurück.
Um eine Prüfung nach der Anwendung ihrer Überschreibung zu ändern, senden Sie stattdessen eine neue Anfrage an [Feature-Status aktualisieren](https://docs.didit.me/de/sessions-api/update-feature-status.md).## Verwandte Themen- [Feature-Status aktualisieren](https://docs.didit.me/de/sessions-api/update-feature-status.md): einen Schritt überschreiben, sofort oder sobald der Workflow abgeschlossen ist.
- [Feature-Überschreibungen auflisten](https://docs.didit.me/de/sessions-api/list-feature-overrides.md): alle Überschreibungen einer Sitzung und deren Status.


## OpenAPI

````yaml de/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 für Ausweisverifizierung. Authentifizierung über den x-api-key-Header.
servers:
  - url: https://verification.didit.me
security: []
tags: []
paths:
  /v3/session/{sessionId}/features/overrides/{overrideId}/cancel/:
    post:
      tags:
        - Sessions
      summary: >-
        Ein Überschreiben einer Prüfung abbrechen, das auf den Abschluss des
        Workflows wartet
      description: >-
        Bricht ein Überschreiben eines Funktionsstatus (Schrittstatus) ab, das
        noch `pending_until_flow_finishes` ist, sodass es nie angewendet wird.
        Die Prüfung behält ihren Status, der Abbruch wird in der Aktivität der
        Sitzung als `FEATURE_OVERRIDE_CANCELLED` protokolliert, und es wird kein
        Webhook gesendet. Die Antwort ist das Überschreiben mit `state:
        cancelled` und `cancel_reason: cancelled_by_reviewer`.


        Ein Überschreiben, das bereits angewendet oder abgebrochen wurde, gibt
        `409` mit dem Code `feature_override_not_pending` zurück. Override-IDs
        finden Sie über `GET /v3/session/{sessionId}/features/overrides/` oder
        im von der Statusaktualisierung der Funktion zurückgegebenen `override`.


        Erfordert die Berechtigung `write:sessions`; ein
        berechtigungsbeschränkter API-Schlüssel benötigt Schreibzugriff auf
        Entscheidungen.
      operationId: post_v3_session_feature_override_cancel
      parameters:
        - in: path
          name: sessionId
          required: true
          description: >-
            UUID der Verifizierungssitzung. Akzeptiert sowohl Benutzer- (KYC)
            als auch Unternehmens- (KYB) Sitzungs-IDs.
          schema:
            type: string
            format: uuid
            example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
        - in: path
          name: overrideId
          required: true
          description: Die `id` des zu stornierenden Overrides.
          schema:
            type: string
            format: uuid
            example: 9b2f4c1e-8d3a-4e5f-a6b7-c8d9e0f1a2b3
      responses:
        '200':
          description: Der Override wurde storniert und wird nie angewendet.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeatureStatusOverride'
              examples:
                Cancelled:
                  summary: Der stornierte Override
                  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: >-
            Der API-Schlüssel mit eingeschränktem Geltungsbereich ist
            abgelaufen.
          content:
            application/json:
              examples:
                Expired API Key:
                  summary: >-
                    API-Schlüssel mit eingeschränktem Berechtigungsumfang nach
                    Ablaufdatum
                  value:
                    detail: This API key has expired.
        '403':
          description: >-
            Fehlende Anmeldedaten, ein Aufrufer ohne das
            `write:sessions`-Privileg, ein API-Schlüssel mit Gültigkeitsbereich
            ohne den für diesen Endpoint erforderlichen Zugriff oder eine
            `session_id`, die zu einer anderen Anwendung gehört.
          content:
            application/json:
              examples:
                Invalid Credentials:
                  summary: Fehlender oder ungültiger x-api-key
                  value:
                    detail: >-
                      Authentication credentials were not provided or are
                      invalid.
                Missing Privilege:
                  summary: Dem Aufrufer fehlt write:sessions
                  value:
                    detail: You do not have permission to perform this action.
                Scoped Key Without Access:
                  summary: >-
                    API-Schlüssel mit eingeschränktem Berechtigungsumfang ohne
                    diesen Zugriff
                  value:
                    detail: This API key has no write access to decisions.
        '404':
          description: >-
            Es existiert keine KYC- oder KYB-Sitzung mit dieser `session_id`,
            oder die Sitzung hat keinen Override mit dieser `overrideId`.
          content:
            application/json:
              examples:
                Not Found:
                  summary: Unbekannte session_id
                  value:
                    detail: Not found.
                Override Not Found:
                  summary: Kein Override mit dieser ID in der Sitzung
                  value:
                    detail: Override not found.
        '409':
          description: Der Override wurde bereits angewendet oder storniert.
          content:
            application/json:
              examples:
                Not Pending:
                  summary: Nur ein ausstehendes Override kann abgebrochen werden
                  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: >-
        Eine Überschreibung eines Prüfungs- bzw. Funktionsstatus, vorgenommen
        mit `PATCH /v3/session/{sessionId}/features/{nodeId}/update-status/`:
        was geändert wird, ob sie angewendet wurde oder noch darauf wartet, dass
        die Person den Flow abschließt, wer die Anfrage gestellt hat und warum.
      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: Kennung des Overrides. Übergeben Sie sie an den Cancel-Endpoint.
          example: 7c9e6679-7425-40de-944b-e07fc1f90ae7
        node_id:
          type: string
          description: >-
            Der in der Anfrage angegebene Workflow-Knoten (`default` für einen
            Schritt ohne Knoten).
          example: feature_ocr_1
        feature_type:
          type: string
          description: >-
            Der von der Anfrage übergebene `feature_type` oder eine leere
            Zeichenkette, wenn keiner übergeben wurde.
          example: ''
        feature_model:
          type: string
          description: >-
            Die Art der Prüfung, die überschrieben wurde, beispielsweise `KYC`,
            `Face`, `AML` oder `GeolocationCheck`.
          example: KYC
        previous_status:
          type: string
          enum:
            - Not Finished
            - Approved
            - Declined
            - In Review
            - Resub Requested
          description: Der Status der Überprüfung zum Zeitpunkt der Anfrage des Overrides.
          example: In Review
        new_status:
          type: string
          enum:
            - Approved
            - Declined
            - In Review
          description: Der Status, den die Überschreibung festlegt.
          example: Approved
        state:
          type: string
          enum:
            - applied
            - pending_until_flow_finishes
            - cancelled
          description: >-
            `applied`: Die Prüfung hat den neuen Status.
            `pending_until_flow_finishes`: Das Override wartet und greift, wenn
            die Person den Ablauf beendet. `cancelled`: Es hat gewartet und
            wurde nie angewendet (siehe `cancel_reason`).
          example: applied
        forced:
          type: boolean
          description: >-
            `true`, wenn die Überschreibung sofort angewendet wurde, während die
            Person sich noch im Ablauf befand.
          example: false
        reason:
          type: string
          nullable: true
          description: Der mit der Anfrage gesendete `comment` oder `null`.
          example: Document manually verified by compliance.
        requested_by:
          type: object
          nullable: true
          description: >-
            Wer die Übersteuerung angefordert hat, oder `null`, wenn dies nicht
            bekannt ist.
          properties:
            email:
              type: string
              format: email
              nullable: true
              description: >-
                E-Mail des Console-Benutzers oder `null` für API-Schlüssel und
                das System.
              example: reviewer@example.com
            name:
              type: string
              nullable: true
              description: Anzeigename des Anfragenden oder `null`.
              example: Alex Reviewer
            type:
              type: string
              enum:
                - CONSOLE_USER
                - API_KEY
                - SYSTEM
              description: >-
                Wer die Anfrage gestellt hat: ein Benutzer der Konsole, ein
                API-Schlüssel oder Didit selbst.
              example: CONSOLE_USER
        requested_at:
          type: string
          format: date-time
          description: Wann die Übersteuerung angefordert wurde.
          example: '2026-10-13T09:15:00Z'
        applied_at:
          type: string
          format: date-time
          nullable: true
          description: >-
            Wann die Überprüfung den neuen Status angenommen hat, oder `null`,
            während sie wartet oder sobald sie storniert wurde.
          example: '2026-10-13T09:15:00Z'
        cancelled_at:
          type: string
          format: date-time
          nullable: true
          description: Wann ein wartender Override abgebrochen wurde, oder `null`.
          example: null
        cancel_reason:
          type: string
          nullable: true
          enum:
            - cancelled_by_reviewer
            - replaced
            - check_changed
            - session_closed
            - null
          description: >-
            Warum ein wartendes Override nie angewendet wurde, oder `null`.
            `cancelled_by_reviewer`: über den Abbrechen-Endpoint storniert.
            `replaced`: ein neueres Override für denselben Check hat es ersetzt.
            `check_changed`: die Person hat die Prüfung vor dem Abschluss des
            Ablaufs wiederholt. `session_closed`: die Sitzung wurde beendet,
            bevor die Person den Ablauf abgeschlossen hat (abgebrochen,
            abgelaufen oder mitten im Ablauf entschieden).
          example: null
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in
        der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter
        Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese-
        oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte
        Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und
        auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen
        oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde,
        der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder
        die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei
        einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows
        oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff
        erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne
        Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als
        null. Siehe https://docs.didit.me/console/api-keys.

````

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