Pular para o conteúdo principal
POST
curl
Remove vários templates em uma única chamada. Informe uma lista explícita de IDs ou delete_all: true, com a remoção opcionalmente restrita pelos mesmos filtros de Listar templates biométricos.

Corpo da requisição

delete_all: true sem filtros remove todos os templates biométricos da aplicação e não pode ser desfeito. Execute antes Contar templates biométricos com os mesmos filtros para confirmar o que será removido.

Exemplos

Os templates são removidos um a um, e cada resultado informa purged ou already_purged. Se um armazenamento biométrico estiver indisponível, a chamada retorna 503 no primeiro template que falhar. Os templates removidos anteriormente na mesma requisição permanecem removidos; o template que falhou passa para purge_failed (já excluído da correspondência), e repetir a requisição conclui o trabalho.

Erros

Autorizações

x-api-key
string
header
obrigatório

Chave de API da sua aplicação, em Developers -> API keys no Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter escopo restrito: nenhum acesso, leitura ou escrita por recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está errada, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que a requisição veio de um endereço fora da sua lista de IPs; 404 em uma rota de sessão significa que a sessão está fora dos fluxos ou status da chave. Uma chave sem acesso a mídia recebe URLs de imagem, vídeo e PDF como null, e uma chave sem permissão de escrita em sessões recebe links e tokens de sessão como null. Consulte https://docs.didit.me/console/api-keys.

Corpo

application/json
template_uuids
string<uuid>[]

Templates a expurgar. Obrigatório, a menos que delete_all seja true. IDs já expurgados são informados como already_purged.

Minimum array length: 1
delete_all
boolean
padrão:false

Quando true, elimina definitivamente todos os modelos que correspondem aos filtros abaixo (todos os modelos da aplicação quando nenhum filtro é informado). template_uuids é ignorado. Irreversível.

vendor_data
string

Somente com delete_all: correspondência de substring, sem diferenciar maiúsculas de minúsculas, no vendor_data do User proprietário.

vendor_user_uuid
string<uuid>

Somente com delete_all: correspondência exata com o usuário proprietário.

status
enum<string>

Somente com delete_all.

Opções disponíveis:
pending,
active,
expired,
held_out_of_use,
purge_pending,
purge_failed
source_type
enum<string>

Somente com delete_all.

Opções disponíveis:
session_delete,
automatic_retention,
backfill
retained_from
string<date-time>

Somente com delete_all.

retained_to
string<date-time>

Somente com delete_all. Não pode ser anterior a retained_from.

Resposta

Resultados da exclusão definitiva por modelo.

results
object[]
Última modificação em 1 de novembro de 2026