Vai al contenuto principale
DELETE
curl
Elimina un modello: viene rimosso da ogni tipo di confronto e il modello memorizzato viene eliminato. L’eliminazione è irreversibile e viene registrata nel registro di audit insieme al soggetto che ha eseguito l’azione.

Gestione dei nuovi tentativi

Didit elimina prima il modello biometrico memorizzato e solo dopo lo contrassegna come eliminato. Se un archivio biometrico non è disponibile, la chiamata restituisce 503, il modello passa a status: purge_failed ed è già escluso dal confronto. Ripeti la stessa chiamata per completare l’eliminazione.

Errori

Altri punti di eliminazione

I modelli vengono eliminati anche quando elimini l’utente proprietario con Batch Delete Users, quando elimini una qualsiasi sessione di quell’utente con deletion_instruction: "privacy_erasure", e automaticamente alla scadenza di expires_at. Vedi Punti di eliminazione.

Autorizzazioni

x-api-key
string
header
obbligatorio

La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys.

Parametri del percorso

template_uuid
string<uuid>
obbligatorio

ID del modello, restituito come biometric_template_uuid dagli endpoint di eliminazione della sessione, biometric_template_id in una corrispondenza di Ricerca facciale o dall'endpoint di elenco.

Esempio:

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

Risposta

Esito dell'eliminazione definitiva.

uuid
string<uuid>
outcome
enum<string>
Opzioni disponibili:
purged,
already_purged
Ultima modifica il 7 novembre 2026