> ## 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 de suppression de workflow : supprimer un flux KYC > Supprimez un workflow Didit via l'API. Les sessions existantes ne sont pas affectées. Sans contrat ni engagement mensuel. Prompt de l'API de suppression d'un workflow Copier le prompt dans le presse-papiers \

\`Delete a Didit workflow through the Management API.

Endpoint:
DELETE https://verification.didit.me/v3/workflows/{settings_uuid}/

Authentication:
Use the x-api-key header with my Didit API key.

Goal:
\- Remove a workflow that I no longer use so it stops appearing in pickers and stops being available for new sessions.

Path parameter:
\- settings_uuid — the per-version workflow UUID returned by GET /v3/workflows/ or POST /v3/workflows/.

Important semantics:
\- Sessions already in progress with this workflow are not affected — they continue against the snapshot they were created with.
\- New POST /v3/session/ calls referencing this workflow_id will fail once the workflow is deleted.
\- Deleting the default workflow leaves the application without a default; consider PATCH-ing another workflow to is_default: true first.
\- Returns 204 No Content on success with an empty body.

Example call:
curl -X DELETE "https://verification.didit.me/v3/workflows/{settings_uuid}/" \
-H "x-api-key: YOUR_API_KEY"

Failure modes:
\- 401 — missing or malformed x-api-key.
\- 403 — canonical { "detail": "You do not have permission to perform this action." } envelope when the workflow belongs to a different application than the API key.
\- 404 — workflow not found in this application; calling DELETE again on the same UUID is also 404 (effectively idempotent).

Side effects:
\- Deletes the workflow. Sessions already run against it keep their verification results.

For the full integration shape, see /integration/integration-prompt.`

\
Coller dans ## OpenAPI ````yaml fr/openapi-25.json DELETE /v3/workflows/{settings_uuid}/ 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/workflows/{settings_uuid}/: delete: tags: - Workflows summary: Supprimer le workflow description: "Supprime définitivement une version de workflow (aucun retour en arrière possible). Les sessions existantes conservent leurs résultats de vérification mais leur référence de workflow est effacée\_; les autres versions du même groupe `workflow_id` ne sont pas supprimées." operationId: delete_workflow parameters: - name: settings_uuid in: path required: true schema: type: string format: uuid description: UUID par version du workflow à supprimer. responses: '204': description: Workflow supprimé. Le corps de la réponse est vide. '403': description: Clé API manquante ou invalide. content: application/json: examples: Invalid token: value: detail: You do not have permission to perform this action. '404': description: >- Aucun workflow avec ce `settings_uuid` n'existe pour l'application authentifiée. content: application/json: examples: Not found: value: detail: Not found. '429': description: >- Limite de débit dépassée. Réessayez avec une temporisation exponentielle. '500': description: Erreur serveur inattendue. Peut être réessayé en toute sécurité. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: cURL source: >- curl -X DELETE 'https://verification.didit.me/v3/workflows/a1b2c3d4-5678-90ab-cdef-111111111111/' \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() client.workflows.delete( "11111111-2222-3333-4444-555555555555", ) - lang: javascript label: Node.js source: >- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); await didit.workflows.delete("11111111-2222-3333-4444-555555555555"); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nif err := client.Workflows.Delete(ctx, \"11111111-2222-3333-4444-555555555555\"); err != nil {\n\tlog.Fatal(err)\n}" - lang: java label: Java source: |- import me.didit.Didit; // Reads DIDIT_API_KEY. Didit client = new Didit(); client.workflows().delete("11111111-2222-3333-4444-555555555555"); - lang: php label: PHP source: |- workflows->delete('11111111-2222-3333-4444-555555555555'); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new didit.workflows.delete("11111111-2222-3333-4444-555555555555") - lang: csharp label: .NET source: >- using System; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); await client.Workflows.DeleteAsync("11111111-2222-3333-4444-555555555555"); components: 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.