Saltar al contenido principal
DELETE
curl
Purga una plantilla: se excluye de todo tipo de coincidencia y la plantilla almacenada se elimina. La purga es irreversible y queda registrada en el registro de auditoría junto con la entidad que realizó la acción.

Semántica de reintentos

Didit elimina primero la plantilla almacenada y solo después marca la plantilla como purgada. Si un repositorio biométrico no está disponible, la llamada devuelve 503, la plantilla pasa a status: purge_failed y ya queda excluida del proceso de comparación. Repite la misma llamada para completar la purga.

Errores

Otros puntos de purga

Las plantillas también se purgan cuando eliminas el User al que pertenecen con Batch Delete Users, cuando eliminas cualquier sesión de ese User con deletion_instruction: "privacy_erasure", y automáticamente en expires_at. Consulta Puntos de purga.

Autorizaciones

x-api-key
string
header
requerido

La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys.

Parámetros de ruta

template_uuid
string<uuid>
requerido

ID de la plantilla, tal como lo devuelven biometric_template_uuid en los endpoints de eliminación de sesiones, biometric_template_id en una coincidencia de Búsqueda facial o el endpoint de listado.

Ejemplo:

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

Respuesta

Resultado de la purga.

uuid
string<uuid>
outcome
enum<string>
Opciones disponibles:
purged,
already_purged
Última modificación el 1 de noviembre de 2026