Saltar para o conteúdo principal
DELETE
curl
Purga um modelo: ele é removido de todos os tipos de correspondência e o modelo armazenado é eliminado. A purga é irreversível e fica registada no registo de auditoria, com o principal que executou a ação.

Comportamento ao tentar novamente

A Didit elimina primeiro o modelo armazenado e só depois marca o modelo como purgado. Se um repositório biométrico estiver indisponível, a chamada devolve 503, o modelo 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 purga

Os modelos são também purgados quando o utilizador associado é eliminado através de Batch Delete Users, quando qualquer sessão desse utilizador é eliminada com deletion_instruction: "privacy_erasure", e automaticamente quando expires_at é atingido. Consulte Pontos de purga.

Autorizações

x-api-key
string
header
obrigatório

A chave de API da sua aplicação, a partir de Programadores -> Chaves de API na Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter o âmbito definido: nenhum, 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á incorreta, 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 o pedido veio de um endereço fora da sua lista de IP; 404 numa rota de sessão significa que a sessão está fora dos fluxos ou estados da chave. Uma chave sem acesso a multimédia recebe URLs de imagens, vídeos e PDFs como nulos, e uma chave sem permissão de escrita em sessões recebe ligações de sessão e tokens como nulos. Consulte https://docs.didit.me/console/api-keys.

Parâmetros de caminho

template_uuid
string<uuid>
obrigatório

ID do modelo, tal como devolvido em biometric_template_uuid pelos endpoints de eliminação de sessão, biometric_template_id numa correspondência da Pesquisa facial, ou pelo endpoint de listagem.

Exemplo:

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

Resposta

Resultado da purga.

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