> ## 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. # Listeneintrag löschen: Sperre per API aufheben > Entfernt einen Eintrag aus einer Didit-Liste per DELETE /v3/lists/{list_uuid}/entries/{entry_uuid}/. Hebt die Sperre bei Systemlisten auf. API-Prompt zum Löschen eines Listeneintrags Prompt in die Zwischenablage kopieren \

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

\
Einfügen in Entfernen Sie einen Eintrag aus einer Liste. Der Eintrag wird sofort gelöscht und nicht mehr abgeglichen. Bei einer Systemsperrliste hebt Didit außerdem die Sperre auf, die der Eintrag gesetzt hat: Das Gesicht, das Dokument, die Telefonnummer oder die E-Mail-Adresse ist nicht mehr als gesperrt gekennzeichnet. Jeder Benutzer und jedes Unternehmen mit dem Status `BLOCKED`, dessen `vendor_data` oder UUID einem Eintrag der Sperrliste vom Typ `user` oder `business` entspricht, wechselt zurück zu `ACTIVE`, unabhängig von der Ursache der Sperre und von seinem vorherigen Status. Bereits abgeschlossene Sitzungen und Transaktionen behalten ihren Status.Um die Sperre für das Gesicht, das Dokument, die Telefonnummer oder die E-Mail-Adresse einer Sitzung mit einem einzigen Aufruf aufzuheben, verwenden Sie [Aus Sperrliste entfernen](https://docs.didit.me/de/management-api/blocklist/remove.md). ## OpenAPI ````yaml de/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 für Ausweisverifizierung. Authentifizierung über den x-api-key-Header. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/lists/{list_uuid}/entries/{entry_uuid}/: delete: tags: - Lists summary: Einen Listeneintrag löschen description: >- Löscht einen Eintrag aus einer Liste, einschließlich Systemlisten. Der Eintrag wird sofort nicht mehr abgeglichen, und die Löschung ist unwiderruflich: Um den Wert erneut aufzulisten, erstellen Sie einen neuen Eintrag. Auf einer System-Sperrliste für Gesichter, Dokumente, Telefonnummern oder E-Mails wird der Datensatz, für den der Eintrag steht, nicht mehr als auf der Sperrliste geführt gekennzeichnet; auf der System-Sperrliste für Benutzer oder Unternehmen werden Benutzer oder Unternehmen der Anwendung, deren `vendor_data` dem Wert des Eintrags entspricht (oder deren `didit_internal_id` gleich dessen `reference_object_uuid` ist) und die den Status `BLOCKED` haben, wieder auf `ACTIVE` gesetzt. Bereits abgeschlossene Sitzungen und Transaktionen behalten ihren Status. Ein eingeschränkter API-Schlüssel benötigt `workflows: write`. operationId: delete_list_entry parameters: - name: list_uuid in: path required: true description: UUID der Liste, die den Eintrag enthält. schema: type: string format: uuid example: 11111111-2222-3333-4444-555555555555 - name: entry_uuid in: path required: true description: >- UUID des Eintrags, wie sie von „Listeneinträge auflisten“ oder „Listeneintrag erstellen“ zurückgegeben wird. schema: type: string format: uuid example: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee responses: '204': description: Der Eintrag wurde gelöscht. Kein Body. '401': description: >- Der API-Schlüssel mit eingeschränktem Geltungsbereich ist abgelaufen. Andere Authentifizierungsfehler geben `403` zurück. content: application/json: examples: Expired API key: value: detail: This API key has expired. '403': description: >- Der `x-api-key`-Header fehlt (ein falscher, widerrufener oder abgelaufener Schlüssel erhält `401`), oder ein API-Schlüssel mit Berechtigungseinschränkungen verfügt nicht über `workflows: write` oder wird von einer IP-Adresse außerhalb seiner Zulassungsliste verwendet. 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: >- In dieser Liste existiert kein Eintrag mit dieser UUID, die Liste befindet sich nicht in der Anwendung des API-Schlüssels oder wurde gelöscht, oder der Eintrag wurde bereits gelöscht. 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: >- Das geteilte Schreiblimit von 300 Anfragen pro Minute pro API-Schlüssel wurde überschritten. Beachten Sie `Retry-After`, bevor Sie es erneut versuchen. 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: >- Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.