Pular para o conteúdo principal
DELETE
curl
Remove um template: ele é retirado de todos os tipos de correspondência e o template armazenado é excluído. A remoção é irreversível e fica registrada na trilha de auditoria com a identidade responsável pela ação.

Semântica de novas tentativas

A Didit exclui primeiro o template armazenado e só então marca o template como purgado. Se um armazenamento biométrico estiver indisponível, a chamada retorna 503, o template passa para status: purge_failed e já fica excluído da correspondência. Repita a mesma chamada para concluir a purga.

Erros

Outros pontos de remoção

Os modelos também são removidos quando você exclui o usuário proprietário com Excluir usuários em lote, quando você exclui qualquer sessão desse usuário com deletion_instruction: "privacy_erasure" e automaticamente no momento definido em expires_at. Consulte Pontos de remoção.

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.

Parâmetros de caminho

template_uuid
string<uuid>
obrigatório

ID do template, conforme retornado em biometric_template_uuid pelos endpoints de exclusão de sessão, em biometric_template_id em uma correspondência da Busca facial ou pelo endpoint de listagem.

Exemplo:

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

Resposta

Resultado do expurgo.

uuid
string<uuid>
outcome
enum<string>
Opções disponíveis:
purged,
already_purged
Última modificação em 1 de novembro de 2026