> ## 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. # Eliminar llista API: suprimeix llistes de compliment > DELETE /v3/lists/{list_uuid}/: elimina una llista d'autoritzats o personalitzada i entrades de Didit. Les llistes del sistema no es poden eliminar. Prompt de l'API per eliminar una llista Copia el prompt al porta-retalls \

\`Delete an allowlist or custom list from my Didit application through the Management API.

Endpoint:
DELETE https://verification.didit.me/v3/lists/{list_uuid}/

Authentication:
Use the x-api-key header with my Didit API key. A scoped API key needs workflows: write.

Goal:
\- Delete an allowlist or custom list that I no longer need, together with its entries.
\- System lists (is_system: true) cannot be deleted; the API answers 400.

Path parameter:
\- list_uuid: the list UUID returned by GET /v3/lists/ or POST /v3/lists/.

Important semantics:
\- Returns 204 No Content with an empty body on success.
\- The list no longer appears in any read and its entries can no longer be listed.
\- Workflow and transaction rule conditions that reference the list (value_type: "list") evaluate it as an empty list from then on. Audit them before deleting.
\- Deletion is irreversible. The name can be reused for a new list.
\- Calling DELETE again on the same list_uuid returns 404.

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

Failure modes:
\- 400: the list is a system list ({ "detail": "System lists cannot be deleted." }).
\- 401: the API key has expired.
\- 403: missing x-api-key (a wrong, revoked or expired key gets 401) ({ "detail": "You do not have permission to perform this action." }), or a scoped key without workflows: write.
\- 404: no list with this UUID in this application, or it was already deleted.
\- 429: rate limited (see /integration/rate-limiting); back off and retry.

Side effects:
\- The list and its entries are deleted.

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

\
Enganxa a Elimina una llista d'acceptació o una llista personalitzada juntament amb les seves entrades. La llista deixa d'aparèixer en cap lectura, i les condicions de les regles de flux de treball i de transaccions que hi facin referència l'avaluen com a llista buida. L'eliminació és irreversible.Les llistes del sistema (les llistes de bloqueig, la llista **High Risk Countries** i les llistes d'acceptació del sistema) no es poden eliminar i retornen `400`. Per buidar una llista del sistema, [elimina les seves entrades](https://docs.didit.me/ca/management-api/lists/delete-entry.md) una per una. ## OpenAPI ````yaml ca/openapi-25.json DELETE /v3/lists/{list_uuid}/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API de verificació d'identitat. Autentica't amb la capçalera x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/lists/{list_uuid}/: delete: tags: - Lists summary: Eliminar una llista description: >- Elimina una llista permesa o personalitzada juntament amb les seves entrades. L'eliminació és irreversible: la llista i les seves entrades ja no apareixen en cap lectura, i les condicions de regles de transaccions i de fluxos de treball que facin referència a la llista l'avaluaran a partir d'aleshores com una llista buida. Les sessions i transaccions ja avaluades mantenen els seus resultats, i el nom es pot reutilitzar per a una nova llista. Les llistes del sistema no es poden eliminar i retornen `400`; per buidar-ne una, [elimina les seves entrades](https://docs.didit.me/ca/management-api/lists/delete-entry). Una clau d'API amb àmbit requereix `workflows: write`. operationId: delete_list parameters: - name: list_uuid in: path required: true description: >- UUID de la llista, tal com el retorna Llistar llistes o Crear una llista. schema: type: string format: uuid example: 11111111-2222-3333-4444-555555555555 responses: '204': description: S'han suprimit la llista i les seves entrades. Sense cos. '400': description: La llista és una llista de sistema. content: application/json: examples: System list: value: detail: System lists cannot be deleted. '401': description: >- La clau d'API amb abast ha caducat. Altres fallades d'autenticació retornen `403`. content: application/json: examples: Expired API key: value: detail: This API key has expired. '403': description: >- Falta la capçalera `x-api-key` (una clau incorrecta, revocada o caducada rep un `401`), o una clau d'API amb àmbit no té `workflows: write` o s'utilitza des d'una adreça IP fora de la seva llista d'admesos. content: application/json: examples: Missing or invalid API key: value: detail: You do not have permission to perform this action. Scoped key without workflows access: value: detail: This API key has no write access to workflows. '404': description: >- No existeix cap llista amb aquest UUID a l'aplicació de la clau d'API, o ja s'havia suprimit. content: application/json: examples: Not found: value: detail: No List matches the given query. '429': $ref: '#/components/responses/RateLimitedWrite' security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X DELETE 'https://verification.didit.me/v3/lists/11111111-2222-3333-4444-555555555555/' \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() client.lists.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.lists.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.Lists.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.lists().delete("11111111-2222-3333-4444-555555555555"); - lang: php label: PHP source: |- lists->delete('11111111-2222-3333-4444-555555555555'); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new didit.lists.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.Lists.DeleteAsync("11111111-2222-3333-4444-555555555555"); components: responses: RateLimitedWrite: description: >- S'ha superat el límit compartit d'escriptura de 300 sol·licituds per minut per clau d'API. Respecta `Retry-After` abans de reintentar. content: application/json: schema: type: object required: - detail properties: detail: type: string example: detail: >- Write request rate limit exceeded. You can make up to 300 requests per minute. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.