> ## 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 para excluir entrada da lista: desbloquear item > DELETE /v3/lists/{list_uuid}/entries/{entry_uuid}/: remove entrada de lista de bloqueio, permissões ou personalizada da Didit e libera o bloqueio. Prompt da API para excluir entrada de lista Copiar o prompt para a área de transferência \

\`Remove an entry from a Didit list through the Management API.

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

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

Goal:
\- Remove a single entry from a blocklist, allowlist, or custom list, system lists included.
\- On a system blocklist, removing the entry lifts the block it set: future verifications and transactions are no longer declined for that match.

Path parameters:
\- list_uuid: list UUID from GET /v3/lists/.
\- entry_uuid: entry UUID from GET /v3/lists/{list_uuid}/entries/ or the create response.

Important semantics:
\- Returns 204 No Content with an empty body on success.
\- The entry is deleted: it no longer appears in any read and stops matching. Deletion is irreversible; to list the value again, create a new entry.
\- Calling DELETE again on the same entry_uuid returns 404.
\- Sessions and transactions that already finished are not changed.

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

Failure modes:
\- 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 entry with this UUID in this list, or the list is not in this application ({ "detail": "No ListEntry matches the given query." }).
\- 429: rate limited (see /integration/rate-limiting); back off and retry.

Side effects:
\- System blocklist entries: the face, document, phone or email record the entry stands for is no longer flagged as blocklisted, so it stops declining new sessions.
\- User and business blocklist entries: every BLOCKED user or business whose vendor_data or UUID matches the entry returns to ACTIVE, whatever blocked it, and not to the status it had before.
\- Face entries: the face stops matching new sessions.

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

\
Colar em Remova uma entrada de uma lista. A entrada é excluída e deixa de gerar correspondências imediatamente. Em uma lista de bloqueio do sistema, a Didit também remove o bloqueio que a entrada aplicou: o rosto, o documento, o número de telefone ou o endereço de e-mail deixa de ser sinalizado como bloqueado, e todo usuário ou empresa com status `BLOCKED` cujo `vendor_data` ou UUID corresponda a uma entrada `user` ou `business` da lista de bloqueio volta para `ACTIVE`, independentemente do que causou o bloqueio e de qual era seu status anterior. Sessões e transações já finalizadas mantêm seu status.Para remover o bloqueio do rosto, do documento, do número de telefone ou do endereço de e-mail de uma sessão em uma única chamada, use [Remover da lista de bloqueio](https://docs.didit.me/pt-br/management-api/blocklist/remove.md). ## OpenAPI ````yaml pt-br/openapi-25.json DELETE /v3/lists/{list_uuid}/entries/{entry_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}/entries/{entry_uuid}/: delete: tags: - Lists summary: Excluir uma entrada de lista description: >- Exclui uma entrada de uma lista, incluindo listas do sistema. A entrada deixa de gerar correspondências imediatamente, e a exclusão é irreversível: para listar o valor novamente, crie uma nova entrada. Em uma lista de bloqueio do sistema de rostos, documentos, telefones ou e-mails, o registro que a entrada representa deixa de ser sinalizado como bloqueado; na lista de bloqueio do sistema de usuários ou de empresas, os usuários ou empresas da aplicação cujo `vendor_data` seja igual ao valor da entrada (ou cujo `didit_internal_id` seja igual ao seu `reference_object_uuid`) e que estejam `BLOCKED` voltam a `ACTIVE`. Sessões e transações já concluídas mantêm seu status. Uma chave de API com escopo precisa de `workflows: write`. operationId: delete_list_entry parameters: - name: list_uuid in: path required: true description: UUID da lista que contém a entrada. schema: type: string format: uuid example: 11111111-2222-3333-4444-555555555555 - name: entry_uuid in: path required: true description: >- UUID da entrada, conforme retornado por Listar entradas da lista ou Criar uma entrada na lista. schema: type: string format: uuid example: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee responses: '204': description: A entrada foi excluída. Sem corpo. '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 entrada com este UUID nesta lista, a lista não está na aplicação da chave de API ou foi excluída, ou a entrada já foi excluída. content: application/json: examples: Not found: value: detail: No ListEntry 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/entries/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/' \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() client.lists.entries.delete( "11111111-2222-3333-4444-555555555555", "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee", ) - lang: javascript label: Node.js source: |- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); await didit.lists.entries.delete( "11111111-2222-3333-4444-555555555555", "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee", ); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nif err := client.Lists.Entries.Delete(ctx, \"11111111-2222-3333-4444-555555555555\", \"aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee\"); 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().entries().delete("11111111-2222-3333-4444-555555555555", "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"); - lang: php label: PHP source: >- lists->entries->delete('11111111-2222-3333-4444-555555555555', 'aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee'); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new didit.lists.entries.delete( "11111111-2222-3333-4444-555555555555", "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee" ) - lang: csharp label: .NET source: >- using System; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); await client.Lists.Entries.DeleteAsync("11111111-2222-3333-4444-555555555555", "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"); 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.