Saltar al contingut principal
DELETE
curl
Purga una plantilla: se’n elimina de totes les modalitats de coincidència i s’esborra la plantilla emmagatzemada. La purga és irreversible i queda registrada al registre d’auditoria amb el principal que l’executa.

Semàntica dels reintents

Didit esborra primer la plantilla emmagatzemada i només després la marca com a purgada. Si un magatzem biomètric no està disponible, la crida retorna 503, la plantilla passa a status: purge_failed i ja queda exclosa de les coincidències. Repeteix la mateixa crida per completar la purga.

Errors

Altres punts de purga

Les plantilles també es purguen quan elimines l’usuari propietari amb Batch Delete Users, quan elimines qualsevol sessió d’aquest usuari amb deletion_instruction: "privacy_erasure", i automàticament a expires_at. Consulta Punts de purga.

Autoritzacions

x-api-key
string
header
requerit

La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys.

Paràmetres de ruta

template_uuid
string<uuid>
requerit

ID de la plantilla, tal com es retorna a biometric_template_uuid pels endpoints de supressió de sessions, biometric_template_id en una coincidència de cerca facial o l'endpoint de llistat.

Exemple:

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

Resposta

Resultat de la purga.

uuid
string<uuid>
outcome
enum<string>
Opcions disponibles:
purged,
already_purged
Darrera modificació el 7 de novembre del 2026