> ## 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.

# Supprimer une entrée de liste API : débloquer un élément

> Supprime une entrée d'une liste Didit via DELETE /v3/lists/{list_uuid}/entries/{entry_uuid}/. Lève le blocage sur les listes système.



Prompt API de suppression d'une entrée de liste
        Copier le prompt dans le presse-papiers



      
      

\<pre>

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

\</pre>



      
      

Coller dans

Supprime une entrée d'une liste. L'entrée est supprimée et cesse immédiatement de correspondre. Sur une liste de blocage système, Didit lève aussi le blocage que cette entrée avait défini : le visage, le document, le numéro de téléphone ou l'adresse e-mail n'est plus signalé comme figurant sur une liste de blocage, et chaque utilisateur ou entreprise `BLOCKED` dont le `vendor_data` ou l'UUID correspond à une entrée de liste de blocage `user` ou `business` repasse à `ACTIVE`, quelle qu'en soit la cause et quel qu'ait été son statut précédent. Les sessions et les transactions déjà terminées conservent leur statut.Pour lever en un seul appel le blocage sur le visage, le document, le numéro de téléphone ou l'adresse e-mail d'une session, utilisez [Retirer de la liste de blocage](https://docs.didit.me/fr/management-api/blocklist/remove.md).


## OpenAPI

````yaml fr/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 vérification d'identité. Authentifiez-vous avec l'en-tête x-api-key.
servers:
  - url: https://verification.didit.me
security: []
tags: []
paths:
  /v3/lists/{list_uuid}/entries/{entry_uuid}/:
    delete:
      tags:
        - Lists
      summary: Supprimer une entrée de liste
      description: >-
        Supprime une entrée d'une liste, listes système incluses. L'entrée cesse
        immédiatement de correspondre, et la suppression est irréversible : pour
        répertorier à nouveau la valeur, créez une nouvelle entrée. Sur une
        liste de blocage système de visages, documents, téléphones ou e-mails,
        l'enregistrement représenté par l'entrée n'est plus signalé comme
        figurant sur la liste de blocage ; sur la liste de blocage système des
        utilisateurs ou des entreprises, les utilisateurs ou les entreprises de
        l'application dont le champ `vendor_data` est égal à la valeur de
        l'entrée (ou dont le champ `didit_internal_id` est égal à son
        `reference_object_uuid`) et qui ont le statut `BLOCKED` repassent à
        `ACTIVE`. Les sessions et transactions déjà terminées conservent leur
        statut. Une clé API restreinte nécessite `workflows: write`.
      operationId: delete_list_entry
      parameters:
        - name: list_uuid
          in: path
          required: true
          description: UUID de la liste contenant l'entrée.
          schema:
            type: string
            format: uuid
          example: 11111111-2222-3333-4444-555555555555
        - name: entry_uuid
          in: path
          required: true
          description: >-
            UUID de l'entrée, tel que renvoyé par Lister les entrées d'une liste
            ou Créer une entrée de liste.
          schema:
            type: string
            format: uuid
          example: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
      responses:
        '204':
          description: L'entrée a été supprimée. Aucun corps de réponse.
        '401':
          description: >-
            La clé API restreinte a expiré. Les autres échecs d'authentification
            renvoient `403`.
          content:
            application/json:
              examples:
                Expired API key:
                  value:
                    detail: This API key has expired.
        '403':
          description: >-
            L'en-tête `x-api-key` est manquant (une clé incorrecte, révoquée ou
            expirée renvoie `401`), ou une clé API restreinte n'a pas
            l'autorisation `workflows: write` ou est utilisée depuis une adresse
            IP hors de sa liste d'autorisation.
          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: >-
            Aucune entrée avec cet UUID n'existe dans cette liste, la liste
            n'appartient pas à l'application de la clé API ou a été supprimée,
            ou l'entrée a déjà été supprimée.
          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: >-
            <?php


            require 'vendor/autoload.php';


            use Didit\DiditClient;


            // Reads DIDIT_API_KEY.

            $didit = new DiditClient();


            $didit->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: >-
        La limite d'écriture partagée de 300 requêtes par minute et par clé API
        a été dépassée. Respectez l'en-tête `Retry-After` avant de réessayer.
      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 clé API de votre application, issue de Développeurs -> Clés API dans
        la Business Console. La clé principale dispose d'un accès complet. Une
        clé nommée peut être restreinte : aucun, lecture ou écriture par
        ressource, limitée à certains workflows ou aux sessions approuvées, à
        une liste d'adresses IP et à une date d'expiration. 401 signifie que la
        clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a
        été envoyée, que la clé n'a pas accès à cette ressource ou action, ou
        que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur
        une route de session signifie que la session est hors des workflows ou
        des statuts de la clé. Une clé sans accès aux médias reçoit les URL
        d'images, de vidéos et de PDF à null, et une clé sans accès en écriture
        aux sessions reçoit les liens et tokens de session à null. Voir
        https://docs.didit.me/console/api-keys.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.