> ## 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. # Excluir lista via API: remover lista de conformidade > DELETE /v3/lists/{list_uuid}/: exclua uma lista de permissões ou personalizada e suas entradas no Didit. Listas do sistema não podem ser excluídas. Prompt da API para excluir lista Copiar o prompt para a área de transferência \

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

\
Colar em Exclua uma lista de permissões ou uma lista personalizada junto com suas entradas. A lista deixa de aparecer em nenhuma consulta, e as condições de regras do fluxo de verificação (workflow) e de transações que fazem referência a ela passam a avaliá-la como uma lista vazia. A exclusão é irreversível.Listas do sistema (listas de bloqueio, a lista **High Risk Countries** e as listas de permissões do sistema) não podem ser excluídas e retornam `400`. Para esvaziar uma lista do sistema, [exclua suas entradas](https://docs.didit.me/pt-br/management-api/lists/delete-entry.md) uma por uma. ## OpenAPI ````yaml pt-br/openapi-25.json DELETE /v3/lists/{list_uuid}/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API de verificação de identidade. Autentique-se com o cabeçalho x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/lists/{list_uuid}/: delete: tags: - Lists summary: Excluir uma lista description: >- Exclui uma lista de permissões ou lista personalizada junto com suas entradas. A exclusão é irreversível: a lista e suas entradas deixam de aparecer em qualquer leitura, e as condições de regras de fluxos e de transações que fazem referência à lista passam a avaliá-la como uma lista vazia. Sessões e transações já avaliadas mantêm seus resultados, e o nome pode ser reutilizado em uma nova lista. Listas do sistema não podem ser excluídas e retornam `400`; para esvaziar uma delas, [exclua suas entradas](https://docs.didit.me/pt-br/management-api/lists/delete-entry). Uma chave de API com escopo precisa de `workflows: write`. operationId: delete_list parameters: - name: list_uuid in: path required: true description: >- UUID da lista, conforme retornado por Listar listas ou Criar uma lista. schema: type: string format: uuid example: 11111111-2222-3333-4444-555555555555 responses: '204': description: A lista e suas entradas foram excluídas. Sem corpo. '400': description: A lista é uma lista do sistema. content: application/json: examples: System list: value: detail: System lists cannot be deleted. '401': description: >- A chave de API com escopo expirou. Outras falhas de autenticação retornam `403`. content: application/json: examples: Expired API key: value: detail: This API key has expired. '403': description: >- O cabeçalho `x-api-key` está ausente (uma chave incorreta, revogada ou expirada recebe `401`), ou uma chave de API com escopo não tem `workflows: write` ou é usada a partir de um endereço IP fora da sua lista de permissões. 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: >- Não existe nenhuma lista com este UUID na aplicação da chave de API, ou ela já foi excluída. 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: >- O limite compartilhado de escrita de 300 requisições por minuto por chave de API foi excedido. Respeite `Retry-After` antes de tentar novamente. 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: >- Chave de API da sua aplicação, em Developers -> API keys no Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter escopo restrito: nenhum acesso, leitura ou escrita por recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está errada, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que a requisição veio de um endereço fora da sua lista de IPs; 404 em uma rota de sessão significa que a sessão está fora dos fluxos ou status da chave. Uma chave sem acesso a mídia recebe URLs de imagem, vídeo e PDF como null, e uma chave sem permissão de escrita em sessões recebe links e tokens de sessão como null. Consulte https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.