> ## 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 entrada de lista API: desbloquear item > Remova uma entrada de uma lista da Didit (bloqueio, permissão ou personalizada). DELETE /v3/lists/{list_uuid}/entries/{entry_uuid}/ Prompt da API para eliminar 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 é eliminada e deixa de corresponder de imediato. Numa lista de bloqueio do sistema, a Didit também levanta o bloqueio que a entrada definiu: a face, o documento, o número de telefone ou o endereço de e-mail deixam de estar assinalados como bloqueados, e cada utilizador ou empresa com o estado `BLOCKED` cujo `vendor_data` ou UUID corresponda a uma entrada de lista de bloqueio dos tipos `user` ou `business` volta a `ACTIVE`, independentemente do que o bloqueou e do estado que tinha antes. As sessões e transações já terminadas mantêm o respetivo estado.Para levantar o bloqueio da face, do documento, do número de telefone ou do endereço de e-mail de uma sessão numa única chamada, utilize [Remover da lista de bloqueio](https://docs.didit.me/pt/management-api/blocklist/remove.md). ## OpenAPI ````yaml pt/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: Eliminar uma entrada de lista description: >- Elimina uma entrada de uma lista, incluindo listas de sistema. A entrada deixa de corresponder de imediato e a eliminação é irreversível: para voltar a listar o valor, crie uma nova entrada. Numa lista de bloqueio de sistema de rostos, documentos, telefones ou e-mails, o registo que a entrada representa deixa de estar sinalizado como estando na lista de bloqueio; na lista de bloqueio de sistema de utilizadores ou empresas, os utilizadores ou empresas da aplicação cujo `vendor_data` seja igual ao valor da entrada (ou cujo `didit_internal_id` seja igual ao respetivo `reference_object_uuid`) e que estejam com estado `BLOCKED` regressam a `ACTIVE`. As sessões e transações que já tenham terminado mantêm o seu estado. Uma chave de API com âmbito necessita 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 da lista. schema: type: string format: uuid example: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee responses: '204': description: A entrada foi eliminada. Sem corpo. '401': description: >- A chave de API com âmbito expirou. Outras falhas de autenticação devolvem `403`. content: application/json: examples: Expired API key: value: detail: This API key has expired. '403': description: >- O cabeçalho `x-api-key` está em falta (uma chave errada, revogada ou expirada recebe `401`), ou uma chave de API com âmbito não tem `workflows: write` ou é utilizada 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 pertence à aplicação da chave de API ou foi eliminada, ou a entrada já foi eliminada. 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 de escrita partilhado de 300 pedidos por minuto por chave de API foi excedido. Respeite o `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: >- A chave de API da sua aplicação, a partir de Programadores -> Chaves de API na Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter o âmbito definido: nenhum, 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á incorreta, 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 o pedido veio de um endereço fora da sua lista de IP; 404 numa rota de sessão significa que a sessão está fora dos fluxos ou estados da chave. Uma chave sem acesso a multimédia recebe URLs de imagens, vídeos e PDFs como nulos, e uma chave sem permissão de escrita em sessões recebe ligações de sessão e tokens como nulos. Consulte https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.