Saltar al contenido principal
POST
curl
Elimina muchas plantillas en una sola llamada. Indica una lista explícita de ID o delete_all: true, que puedes acotar con los mismos filtros que Listar plantillas biométricas.

Cuerpo de la solicitud

delete_all: true sin filtros elimina todas las plantillas biométricas de la aplicación y no se puede deshacer. Ejecuta antes Contar plantillas biométricas con los mismos filtros para confirmar qué se va a eliminar.

Ejemplos

Las plantillas se eliminan una a una; cada resultado indica purged o already_purged. Si un almacén biométrico no está disponible, la llamada devuelve 503 en la primera plantilla que falla; las plantillas eliminadas antes en la misma solicitud siguen eliminadas, la que falla pasa a purge_failed (ya excluida de las comparaciones) y repetir la solicitud completa el trabajo.

Errores

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.

Cuerpo

application/json
template_uuids
string<uuid>[]

Plantillas que se purgarán. Obligatorio salvo que delete_all sea true. Los ID ya purgados se indican como already_purged.

Minimum array length: 1
delete_all
boolean
predeterminado:false

Si es true, purga todas las plantillas que coinciden con los filtros siguientes (todas las plantillas de la aplicación si no se indica ningún filtro). Se ignora template_uuids. Es irreversible.

vendor_data
string

Solo con delete_all: coincidencia de subcadena, sin distinguir mayúsculas y minúsculas, en el vendor_data del usuario propietario.

vendor_user_uuid
string<uuid>

Solo con delete_all: coincidencia exacta con el usuario propietario.

status
enum<string>

Solo con delete_all.

Opciones disponibles:
pending,
active,
expired,
held_out_of_use,
purge_pending,
purge_failed
source_type
enum<string>

Solo con delete_all.

Opciones disponibles:
session_delete,
automatic_retention,
backfill
retained_from
string<date-time>

Solo con delete_all.

retained_to
string<date-time>

Solo con delete_all. No debe ser anterior a retained_from.

Respuesta

Resultados de la purga por plantilla.

results
object[]
Última modificación el 1 de noviembre de 2026