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

# API Batalkan Override Fitur untuk Langkah Tertunda

> Batalkan override status langkah yang masih menunggu pengguna menyelesaikan alur di Didit, agar override tidak pernah berlaku dan status langkah tetap.



Prompt Pembatalan Override Fitur
        Salin prompt ke papan klip



      
      

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



      
      

Tempel ke

Saat Anda meng-override langkah dengan `defer_until_flow_finishes: true` selagi pengguna masih berada di dalam alur kerja, override tersebut menunggu dan baru berlaku setelah alur kerja selesai.
Batalkan di sini jika Anda tidak lagi ingin override tersebut berlaku.Pemeriksaan tetap mempertahankan statusnya saat ini.
Pembatalan dicatat dalam aktivitas sesi sebagai `FEATURE_OVERRIDE_CANCELLED`, dan tidak ada webhook yang dikirim.
Respons berupa override dengan `state: cancelled` dan `cancel_reason: cancelled_by_reviewer`.## Temukan ID overrideGunakan `id` dari objek `override` yang dikembalikan oleh [Update Feature Status](https://docs.didit.me/id/sessions-api/update-feature-status.md), atau tampilkan daftar override sesi dengan [List Feature Overrides](https://docs.didit.me/id/sessions-api/list-feature-overrides.md) lalu pilih override yang `state`-nya adalah `pending_until_flow_finishes`.## Saat pembatalan gagalOverride yang sudah berlaku atau sudah dibatalkan akan mengembalikan `409` dengan kode `feature_override_not_pending`.
Untuk mengubah pemeriksaan setelah override-nya berlaku, kirim permintaan [Update Feature Status](https://docs.didit.me/id/sessions-api/update-feature-status.md) yang baru.## Terkait- [Update Feature Status](https://docs.didit.me/id/sessions-api/update-feature-status.md): meng-override status satu langkah, sekarang atau setelah alur kerja selesai.
- [List Feature Overrides](https://docs.didit.me/id/sessions-api/list-feature-overrides.md): semua override dari sebuah sesi dan statusnya.


## OpenAPI

````yaml id/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 Verifikasi Identitas. Lakukan autentikasi dengan header x-api-key.
servers:
  - url: https://verification.didit.me
security: []
tags: []
paths:
  /v3/session/{sessionId}/features/overrides/{overrideId}/cancel/:
    post:
      tags:
        - Sessions
      summary: Batalkan override pemeriksaan yang menunggu alur selesai
      description: >-
        Batalkan override status fitur (langkah) yang masih
        `pending_until_flow_finishes`, sehingga tidak pernah diterapkan.
        Pemeriksaan mempertahankan statusnya, pembatalan dicatat dalam aktivitas
        sesi sebagai `FEATURE_OVERRIDE_CANCELLED`, dan tidak ada webhook yang
        dikirim. Responsnya adalah override dengan `state: cancelled` dan
        `cancel_reason: cancelled_by_reviewer`.


        Override yang sudah diterapkan atau dibatalkan mengembalikan `409`
        dengan kode `feature_override_not_pending`. Temukan ID override dengan
        `GET /v3/session/{sessionId}/features/overrides/` atau di dalam
        `override` yang dikembalikan oleh pembaruan status fitur.


        Memerlukan hak istimewa `write:sessions`; kunci API dengan cakupan
        memerlukan akses tulis ke keputusan.
      operationId: post_v3_session_feature_override_cancel
      parameters:
        - in: path
          name: sessionId
          required: true
          description: >-
            UUID sesi verifikasi. Menerima ID sesi pengguna (KYC) dan bisnis
            (KYB).
          schema:
            type: string
            format: uuid
            example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
        - in: path
          name: overrideId
          required: true
          description: '`id` dari override yang akan dibatalkan.'
          schema:
            type: string
            format: uuid
            example: 9b2f4c1e-8d3a-4e5f-a6b7-c8d9e0f1a2b3
      responses:
        '200':
          description: Penggantian dibatalkan dan tidak akan pernah diterapkan.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeatureStatusOverride'
              examples:
                Cancelled:
                  summary: Override yang dibatalkan
                  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: Kunci API dengan cakupan terbatas telah kedaluwarsa.
          content:
            application/json:
              examples:
                Expired API Key:
                  summary: Kunci API ber-scope melewati tanggal kedaluwarsanya
                  value:
                    detail: This API key has expired.
        '403':
          description: >-
            Kredensial tidak ada, pemanggil tanpa hak istimewa `write:sessions`,
            kunci API dengan pembatasan cakupan tanpa akses yang dibutuhkan
            endpoint ini, atau `session_id` milik aplikasi lain.
          content:
            application/json:
              examples:
                Invalid Credentials:
                  summary: x-api-key tidak ada atau tidak valid
                  value:
                    detail: >-
                      Authentication credentials were not provided or are
                      invalid.
                Missing Privilege:
                  summary: Pemanggil tidak memiliki izin write:sessions
                  value:
                    detail: You do not have permission to perform this action.
                Scoped Key Without Access:
                  summary: Kunci API ber-scope tanpa akses ini
                  value:
                    detail: This API key has no write access to decisions.
        '404':
          description: >-
            Tidak ada sesi KYC atau KYB dengan `session_id` ini, atau sesi tidak
            memiliki override dengan `overrideId` ini.
          content:
            application/json:
              examples:
                Not Found:
                  summary: session_id tidak dikenal
                  value:
                    detail: Not found.
                Override Not Found:
                  summary: Tidak ada override dengan id ini pada sesi
                  value:
                    detail: Override not found.
        '409':
          description: Penggantian telah diterapkan atau dibatalkan.
          content:
            application/json:
              examples:
                Not Pending:
                  summary: Hanya override yang sedang menunggu yang dapat dibatalkan
                  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: >-
        Satu penimpaan status pemeriksaan (fitur) yang dibuat dengan `PATCH
        /v3/session/{sessionId}/features/{nodeId}/update-status/`: apa yang
        diubahnya, apakah sudah diterapkan atau masih menunggu orang tersebut
        menyelesaikan alur, siapa yang meminta dan alasannya.
      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: Pengenal penimpaan (override). Teruskan ke endpoint pembatalan.
          example: 7c9e6679-7425-40de-944b-e07fc1f90ae7
        node_id:
          type: string
          description: >-
            Node alur kerja yang disebutkan dalam permintaan (`default` untuk
            langkah tanpa node).
          example: feature_ocr_1
        feature_type:
          type: string
          description: >-
            `feature_type` yang diteruskan oleh permintaan, atau string kosong
            jika tidak meneruskan apa pun.
          example: ''
        feature_model:
          type: string
          description: >-
            Jenis pemeriksaan yang ditimpa, misalnya `KYC`, `Face`, `AML`, atau
            `GeolocationCheck`.
          example: KYC
        previous_status:
          type: string
          enum:
            - Not Finished
            - Approved
            - Declined
            - In Review
            - Resub Requested
          description: Status pemeriksaan saat override diminta.
          example: In Review
        new_status:
          type: string
          enum:
            - Approved
            - Declined
            - In Review
          description: Status yang ditetapkan oleh penggantian (override).
          example: Approved
        state:
          type: string
          enum:
            - applied
            - pending_until_flow_finishes
            - cancelled
          description: >-
            `applied`: pemeriksaan memiliki status baru.
            `pending_until_flow_finishes`: penggantian menunggu dan diterapkan
            saat orang tersebut menyelesaikan alur. `cancelled`: penggantian
            menunggu dan tidak pernah diterapkan (lihat `cancel_reason`).
          example: applied
        forced:
          type: boolean
          description: >-
            `true` saat penggantian diterapkan seketika saat orang tersebut
            masih berada dalam alur.
          example: false
        reason:
          type: string
          nullable: true
          description: '`comment` yang dikirim bersama permintaan, atau `null`.'
          example: Document manually verified by compliance.
        requested_by:
          type: object
          nullable: true
          description: Pihak yang meminta override, atau `null` jika tidak diketahui.
          properties:
            email:
              type: string
              format: email
              nullable: true
              description: Email pengguna konsol, atau `null` untuk kunci API dan sistem.
              example: reviewer@example.com
            name:
              type: string
              nullable: true
              description: Nama tampilan pemohon, atau `null`.
              example: Alex Reviewer
            type:
              type: string
              enum:
                - CONSOLE_USER
                - API_KEY
                - SYSTEM
              description: >-
                Pihak yang membuat permintaan: pengguna konsol, kunci API, atau
                Didit sendiri.
              example: CONSOLE_USER
        requested_at:
          type: string
          format: date-time
          description: Waktu pengesampingan diminta.
          example: '2026-10-13T09:15:00Z'
        applied_at:
          type: string
          format: date-time
          nullable: true
          description: >-
            Waktu ketika pemeriksaan beralih ke status baru, atau `null` saat
            masih menunggu atau setelah dibatalkan.
          example: '2026-10-13T09:15:00Z'
        cancelled_at:
          type: string
          format: date-time
          nullable: true
          description: Saat penimpaan yang menunggu dibatalkan, atau `null`.
          example: null
        cancel_reason:
          type: string
          nullable: true
          enum:
            - cancelled_by_reviewer
            - replaced
            - check_changed
            - session_closed
            - null
          description: >-
            Alasan mengapa override yang tertunda tidak pernah diterapkan, atau
            `null`. `cancelled_by_reviewer`: dibatalkan dengan endpoint
            pembatalan. `replaced`: digantikan oleh override yang lebih baru
            pada pemeriksaan yang sama. `check_changed`: pengguna mengulangi
            pemeriksaan sebelum menyelesaikan alur. `session_closed`: sesi
            meninggalkan alur sebelum pengguna menyelesaikannya (ditinggalkan,
            kedaluwarsa, atau diputuskan di tengah alur).
          example: null
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Kunci API aplikasi Anda, dari Developers -> API keys di Business
        Console. Kunci utama memiliki akses penuh. Kunci bernama dapat diberi
        cakupan: none, read, atau write per sumber daya, dibatasi pada beberapa
        alur kerja atau pada sesi yang disetujui, pada daftar alamat IP, dan
        pada tanggal kedaluwarsa. 401 berarti kuncinya salah, dicabut, atau
        kedaluwarsa; 403 berarti tidak ada kunci yang dikirimkan, kunci tidak
        memiliki akses ke sumber daya atau tindakan ini, atau permintaan datang
        dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi
        berada di luar alur kerja atau status kunci tersebut. Kunci tanpa akses
        media menerima URL gambar, video, dan PDF sebagai null, dan kunci tanpa
        izin tulis sesi menerima tautan sesi dan token sebagai null. Lihat
        https://docs.didit.me/console/api-keys.

````

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