Skip to main content
엔드포인트가 /v3/face-auth/{authId}로 변경되었습니다.authId가 query parameter에서 path parameter가 되었고, 성공 응답도 { "result": "success", "statusCode": 200 }에서 { "authId": "..." }로 바뀌었습니다. 기존 연동을 옮기려면 FaceAuth 공통 참조 — 구 API에서 옮기기를 확인하세요.
FaceAuth submission의 대상 얼굴 이미지와 민감 처리 reference를 삭제합니다. KYC 원본 submission 및 KYC reference image는 삭제하지 않습니다.
  • 한 번의 요청당 1건의 제출 건만 삭제할 수 있습니다.
  • 삭제되는 정보: 대상 얼굴 이미지와 FaceAuth 처리 중 생성된 민감 reference가 제거됩니다. 삭제 후 이미지 다운로드 호출 시 404 FACEAUTH_SUBMISSION_NOT_FOUND가 반환됩니다.
  • 유지되는 정보: 제출 건 자체는 목록 조회·단건 조회 결과에 계속 포함되며 deleteTime에 값이 채워집니다. 인증 결과(authStatus)·판정 데이터(result)·적용된 정책(policy)·연결된 KYC 제출 건 ID(kycSubmissionId)·제출 방식(submitType)·생성 시각(createTime)은 그대로 유지됩니다.

​
1. Base URL

DELETE/Face-auth/{authId}

​
2. 인증

x-api-key header에 FaceAuth 프로젝트 API key를 포함해야 합니다.
x-api-key

​
3. 요청 예시

DELETE/Face-auth/{authId}

​
4. Path 파라미터

​
string
필수
삭제할 FaceAuth submission의 키값입니다.

​
5. 응답

​
5-1. 성공

삭제에 성공하면 200 OK와 아래 본문이 돌아옵니다.
result.json
​
string
삭제한 FaceAuth submission의 키값입니다. 요청한 authId와 같습니다.
  • 응답 본문의 field는 authId 하나뿐입니다. 삭제 시각이 필요하면 목록 조회나 단건 조회의 deleteTime으로 확인하세요.
  • 성공은 대상 얼굴 이미지 삭제와 삭제 기록이 모두 완료됐음을 뜻합니다.

​
5-2. 재시도와 멱등성

  • 이미 삭제된 authId를 다시 요청해도 같은 200 OK 응답을 반환합니다. client는 네트워크 오류 등으로 결과를 알 수 없을 때 동일 요청을 재시도할 수 있습니다.
  • 삭제 처리 중 일부만 완료된 경우 성공으로 응답하지 않고 503을 반환합니다. 같은 요청을 재시도하면 남은 처리를 이어서 완료합니다. 재시도는 안전합니다.

​
5-3. 실패

삭제에 실패하면 HTTP 상태 코드와 함께 에러 객체가 돌아옵니다.

​
6. 오류 응답

아르고스 애플리케이션이 반환하는 오류는 { code, message } 형식입니다. 인증 계층에서 차단된 401과 일부 403은 이 형식을 따르지 않습니다. FaceAuth 공통 참조 — 인증 계층 오류를 참고하세요.
인증(401 / 403)이 먼저 평가되고, 통과한 뒤에 파라미터 검증(400)이 수행됩니다. 따라서 API Key가 없거나 잘못된 상태에서는 authId를 어떻게 보내든 401 또는 403이 반환됩니다.