> ## 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 d'annulation de remplacement de fonctionnalité > Annulez un remplacement de statut d'étape encore en attente de la fin du parcours, pour qu'il ne s'applique jamais et que l'étape conserve son statut. Didit. Prompt pour annuler une dérogation de fonctionnalité Copier le prompt dans le presse-papiers \

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

\
Coller dans Lorsque vous appliquez une dérogation à une étape avec `defer_until_flow_finishes: true` alors que la personne est encore dans le parcours, la dérogation attend et s'applique à la fin du parcours. Annulez-la ici si vous ne souhaitez plus qu'elle s'applique.La vérification conserve son statut actuel. L'annulation est enregistrée dans l'activité de la session sous la forme `FEATURE_OVERRIDE_CANCELLED`, et aucun webhook n'est envoyé. La réponse est la dérogation avec `state: cancelled` et `cancel_reason: cancelled_by_reviewer`.## Trouver l'identifiant de la dérogationUtilisez le `id` de l'objet `override` renvoyé par [Mettre à jour le statut de la fonctionnalité](https://docs.didit.me/fr/sessions-api/update-feature-status.md), ou listez les dérogations de la session avec [Lister les dérogations de fonctionnalité](https://docs.didit.me/fr/sessions-api/list-feature-overrides.md) et choisissez-en une dont le `state` est `pending_until_flow_finishes`.## En cas d'échec de l'annulationUne dérogation déjà appliquée ou annulée renvoie `409` avec le code `feature_override_not_pending`. Pour modifier une vérification après l'application de sa dérogation, envoyez plutôt une nouvelle requête [Mettre à jour le statut de la fonctionnalité](https://docs.didit.me/fr/sessions-api/update-feature-status.md).## Voir aussi- [Mettre à jour le statut de la fonctionnalité](https://docs.didit.me/fr/sessions-api/update-feature-status.md) : appliquer une dérogation au statut d'une étape, maintenant ou une fois le parcours terminé. - [Lister les dérogations de fonctionnalité](https://docs.didit.me/fr/sessions-api/list-feature-overrides.md) : toutes les dérogations d'une session et leur état. ## OpenAPI ````yaml fr/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 vérification d'identité. Authentifiez-vous avec l'en-tête x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/session/{sessionId}/features/overrides/{overrideId}/cancel/: post: tags: - Sessions summary: Annuler une dérogation de vérification en attente de la fin du flux description: >- Annuler une dérogation sur le statut d'une fonctionnalité (étape) qui est encore `pending_until_flow_finishes`, afin qu'elle ne s'applique jamais. La vérification conserve son statut, l'annulation est consignée dans l'activité de la session sous `FEATURE_OVERRIDE_CANCELLED`, et aucun webhook n'est envoyé. La réponse est la dérogation avec `state: cancelled` et `cancel_reason: cancelled_by_reviewer`. Une dérogation déjà appliquée ou annulée renvoie `409` avec le code `feature_override_not_pending`. Recherchez les identifiants de dérogation à l'aide de `GET /v3/session/{sessionId}/features/overrides/` ou dans le champ `override` renvoyé par la mise à jour du statut de la fonctionnalité. Nécessite le privilège `write:sessions` ; une clé API restreinte nécessite un accès en écriture aux décisions. operationId: post_v3_session_feature_override_cancel parameters: - in: path name: sessionId required: true description: >- UUID de la session de vérification. Accepte les identifiants de session d'utilisateur (KYC) et d'entreprise (KYB). schema: type: string format: uuid example: 3fa85f64-5717-4562-b3fc-2c963f66afa6 - in: path name: overrideId required: true description: L'`id` de la dérogation à annuler. schema: type: string format: uuid example: 9b2f4c1e-8d3a-4e5f-a6b7-c8d9e0f1a2b3 responses: '200': description: La dérogation est annulée et ne s'appliquera jamais. content: application/json: schema: $ref: '#/components/schemas/FeatureStatusOverride' examples: Cancelled: summary: La dérogation annulée 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 clé API restreinte a expiré. content: application/json: examples: Expired API Key: summary: Clé API restreinte ayant dépassé sa date d'expiration value: detail: This API key has expired. '403': description: >- Identifiants manquants, appelant sans le privilège `write:sessions`, clé API avec restriction de portée ne disposant pas de l'accès requis par cet endpoint, ou un `session_id` qui appartient à une autre application. content: application/json: examples: Invalid Credentials: summary: x-api-key manquant ou invalide value: detail: >- Authentication credentials were not provided or are invalid. Missing Privilege: summary: L'appelant n'a pas write:sessions value: detail: You do not have permission to perform this action. Scoped Key Without Access: summary: Clé API restreinte sans cet accès value: detail: This API key has no write access to decisions. '404': description: >- Aucune session KYC ou KYB avec ce `session_id` n'existe, ou la session ne comporte aucun remplacement avec cet `overrideId`. content: application/json: examples: Not Found: summary: session_id inconnu value: detail: Not found. Override Not Found: summary: Aucune dérogation avec cet identifiant sur la session value: detail: Override not found. '409': description: La dérogation a déjà été appliquée ou a été annulée. content: application/json: examples: Not Pending: summary: Seule une dérogation en attente peut être annulée 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: >- Une modification manuelle (override) du statut d'une vérification (fonctionnalité) effectuée avec `PATCH /v3/session/{sessionId}/features/{nodeId}/update-status/` : ce qu'elle modifie, si elle a été appliquée ou si elle attend toujours que la personne termine le parcours, qui l'a demandée et pourquoi. 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: >- Identifiant de la dérogation. Transmettez-le à l'endpoint d'annulation. example: 7c9e6679-7425-40de-944b-e07fc1f90ae7 node_id: type: string description: >- Le nœud de workflow spécifié dans la requête (`default` pour une étape sans nœud). example: feature_ocr_1 feature_type: type: string description: >- Le `feature_type` transmis par la requête, ou une chaîne vide si aucun n'a été transmis. example: '' feature_model: type: string description: >- Le type de vérification qui a été remplacé, par exemple `KYC`, `Face`, `AML` ou `GeolocationCheck`. example: KYC previous_status: type: string enum: - Not Finished - Approved - Declined - In Review - Resub Requested description: >- Le statut de la vérification au moment où la dérogation a été demandée. example: In Review new_status: type: string enum: - Approved - Declined - In Review description: Le statut défini par la dérogation. example: Approved state: type: string enum: - applied - pending_until_flow_finishes - cancelled description: >- `applied` : le contrôle a le nouveau statut. `pending_until_flow_finishes` : la dérogation attend et s'applique lorsque la personne termine le flux. `cancelled` : elle a attendu et ne s'est jamais appliquée (voir `cancel_reason`). example: applied forced: type: boolean description: >- `true` lorsque la dérogation s'est appliquée immédiatement alors que la personne était encore dans le flux. example: false reason: type: string nullable: true description: Le `comment` envoyé avec la requête, ou `null`. example: Document manually verified by compliance. requested_by: type: object nullable: true description: Qui a demandé la dérogation, ou `null` lorsque cela n'est pas connu. properties: email: type: string format: email nullable: true description: >- E-mail de l'utilisateur de la console, ou `null` pour les clés API et le système. example: reviewer@example.com name: type: string nullable: true description: Nom d'affichage du demandeur, ou `null`. example: Alex Reviewer type: type: string enum: - CONSOLE_USER - API_KEY - SYSTEM description: >- Qui a effectué la requête : un utilisateur de la console, une clé API ou Didit lui-même. example: CONSOLE_USER requested_at: type: string format: date-time description: Moment où la dérogation a été demandée. example: '2026-10-13T09:15:00Z' applied_at: type: string format: date-time nullable: true description: >- Date et heure auxquelles la vérification a pris le nouveau statut, ou `null` pendant qu'elle est en attente ou une fois qu'elle est annulée. example: '2026-10-13T09:15:00Z' cancelled_at: type: string format: date-time nullable: true description: Moment où une dérogation en attente a été annulée, ou `null`. example: null cancel_reason: type: string nullable: true enum: - cancelled_by_reviewer - replaced - check_changed - session_closed - null description: >- Raison pour laquelle un remplacement en attente n'a jamais été appliqué, ou `null`. `cancelled_by_reviewer` : annulé avec l'endpoint d'annulation. `replaced` : un remplacement plus récent sur la même vérification l'a remplacé. `check_changed` : la personne a refait la vérification avant de terminer le flux. `session_closed` : la session a quitté le flux avant que la personne ne le termine (abandonnée, expirée ou décidée en cours de flux). example: null securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.