Passer au contenu principal
DELETE
curl
Purge un gabarit : il est retiré de tous les types de correspondance, et le gabarit stocké est supprimé. La purge est irréversible et est consignée dans le journal d’audit avec le principal agissant.

Comportement en cas de nouvelle tentative

Didit supprime d’abord le gabarit stocké, puis seulement ensuite marque le gabarit comme purgé. Si un magasin de données biométriques est indisponible, l’appel renvoie 503, le gabarit passe à status: purge_failed et il est déjà exclu des comparaisons. Renouvelez le même appel pour achever la purge.

Erreurs

Autres points de purge

Les gabarits sont aussi purgés lorsque vous supprimez l’utilisateur propriétaire avec Suppression en lot des utilisateurs, lorsque vous supprimez une session de cet utilisateur avec deletion_instruction: "privacy_erasure", et automatiquement à expires_at. Voir Points de purge.

Autorisations

x-api-key
string
header
requis

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.

Paramètres de chemin

template_uuid
string<uuid>
requis

Identifiant du modèle, tel que renvoyé dans biometric_template_uuid par les endpoints de suppression de session, biometric_template_id lors d'une correspondance de Recherche faciale, ou l'endpoint de liste.

Exemple:

"9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b"

Réponse

Résultat de la purge.

uuid
string<uuid>
outcome
enum<string>
Options disponibles:
purged,
already_purged
Dernière modification le 7 novembre 2026