> ## 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. # Elimina workflow API: rimuovere il flusso KYC > Elimina un workflow di verifica Didit via API. Le sessioni esistenti non sono interessate. Pay-per-call, nessun contratto, nessun impegno mensile. Prompt dell'API per eliminare un workflow Copia il prompt negli appunti \

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

\
Incolla in ## OpenAPI ````yaml it/openapi-25.json DELETE /v3/workflows/{settings_uuid}/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API di verifica dell'identità. Autenticati con l'intestazione x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/workflows/{settings_uuid}/: delete: tags: - Workflows summary: Elimina workflow description: >- Elimina definitivamente una versione del workflow (operazione irreversibile). Le sessioni esistenti mantengono i risultati della verifica, ma il loro riferimento al workflow viene cancellato; le altre versioni nello stesso gruppo `workflow_id` non vengono eliminate. operationId: delete_workflow parameters: - name: settings_uuid in: path required: true schema: type: string format: uuid description: UUID per versione del workflow da eliminare. responses: '204': description: Workflow eliminato. Il corpo della risposta è vuoto. '403': description: Chiave API mancante o non valida. content: application/json: examples: Invalid token: value: detail: You do not have permission to perform this action. '404': description: >- Nessun workflow con questo `settings_uuid` esiste per l'applicazione autenticata. content: application/json: examples: Not found: value: detail: Not found. '429': description: Limite di frequenza superato. Riprova con backoff esponenziale. '500': description: >- Errore imprevisto del server. È sicuro effettuare un nuovo tentativo. 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 chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.