메인 콘텐츠로 건너뛰기
DELETE
curl
템플릿 하나를 삭제합니다. 템플릿은 모든 유형의 매칭에서 제거되고 저장된 템플릿은 삭제됩니다. 삭제는 되돌릴 수 없으며, 작업 주체와 함께 감사 로그에 기록됩니다.

재시도 동작

Didit은 저장된 템플릿을 먼저 삭제한 다음에만 템플릿을 삭제된 것으로 표시합니다. 생체 저장소를 사용할 수 없으면 호출은 503을 반환하고, 템플릿은 status: purge_failed 상태로 바뀌며, 이미 매칭에서 제외됩니다. 같은 호출을 반복하여 삭제를 완료하십시오.

오류

그 밖의 삭제 시점

템플릿은 소유 사용자를 사용자 일괄 삭제로 삭제할 때, deletion_instruction: "privacy_erasure"를 사용해 해당 사용자의 세션을 하나라도 삭제할 때, 그리고 expires_at 시점에 자동으로도 삭제됩니다. 자세한 내용은 삭제 시점을 참조하십시오.

인증

x-api-key
string
header
필수

Business Console의 Developers -> API keys에서 발급받은 귀하 애플리케이션의 API 키입니다. 기본 키는 전체 접근 권한을 갖습니다. 이름이 지정된 키는 리소스별 none, read, write 범위로 권한을 제한할 수 있으며 특정 워크플로나 승인된 세션, IP 주소 목록, 만료일 등으로 제한할 수도 있습니다. 401은 키가 잘못되었거나 폐기되었거나 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스나 작업에 대한 접근 권한이 없거나, 요청이 허용된 IP 목록 외부 주소에서 발생했음을 의미합니다. 세션 경로에서의 404는 해당 세션이 키의 허용 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 비디오, PDF URL을 null로 수신하며, 세션 write 권한이 없는 키는 세션 링크와 token을 null로 수신합니다. https://docs.didit.me/console/api-keys 를 참고하십시오.

경로 매개변수

template_uuid
string<uuid>
필수

세션 삭제 endpoint에서 biometric_template_uuid로 반환되거나, 얼굴 검색 일치 시 biometric_template_id로 반환되거나, 목록 endpoint에서 반환된 템플릿 ID입니다.

예시:

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

응답

영구 삭제 결과.

uuid
string<uuid>
outcome
enum<string>
사용 가능한 옵션:
purged,
already_purged
마지막 수정일 2026년 11월 7일