메인 콘텐츠로 건너뛰기
이 작업은 되돌릴 수 없습니다. 삭제된 레코드는 복구할 수 없습니다.

​
엔드포인트

DELETE /submission/aml/monitor/{worklistId}

​
기본 URL

https://rest-api.argosidentity.com/v3/submission/aml/monitor

​
인증

요청 헤더에 API 키를 포함하세요:
​
x-api-key
string
required
인증을 위한 API 키

​
경로 매개변수

​
worklistId
string
required
삭제할 레코드가 포함된 워크리스트의 ID

​
요청 본문

​
admin
string
required
삭제 요청을 하는 관리자의 이메일 주소 (프로젝트의 관리자 목록에 등록되어 있어야 함)
​
recordIds
array
required
삭제할 레코드 ID 배열 (최대 1-25개 레코드)

​
요청 예시

curl -X DELETE 'https://rest-api.argosidentity.com/v3/submission/aml/monitor/{worklistId}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {yourAPIKey}' \
  -d '{
    "admin": "test@company.com",
    "recordIds": [
      "ncd0e2meod5c41_3tsti7mepaqifz",
      "ncgae2meod5c41_3tsti7mephgifz"
    ]
  }'

​
응답

​
성공 응답

{
  "message": "records deleted successfully"
}

​
응답 필드

​
message
string
required
삭제 작업을 확인하는 성공 메시지

​
오류 응답

{
  "errorCode": "invalid_record",
  "errorMessage": "Some records do not exist",
  "details": [
    {
      "statusCode": 404,
      "error": {
        "code": "MAPI-001",
        "message": "Resource not found"
      }
    },
    {
      "statusCode": 404,
      "error": {
        "code": "MAPI-001",
        "message": "Resource not found"
      }
    }
  ]
}

​
오류 코드

오류 코드HTTP 상태설명
invalid_payload400요청 페이로드 누락 또는 형식 오류
invalid_admin400잘못된 관리자 계정 또는 프로젝트에 등록되지 않은 관리자
invalid_record400하나 이상의 레코드 ID가 존재하지 않음
invalide_worklist400잘못된 워크리스트 ID
invalid_project400프로젝트 ID 누락 또는 잘못된 API 키

​
중요 사항

삭제 제한사항:
  • 요청당 최대 25개 레코드만 삭제 가능
  • 지정된 워크리스트 내의 레코드만 삭제 가능
  • 삭제는 영구적이며 되돌릴 수 없음
  • 진행하기 전에 올바른 레코드 ID가 있는지 확인하세요
모범 사례:
  • 삭제 시도 전에 레코드 ID가 존재하는지 확인
  • 효율성 향상을 위해 여러 삭제에 배치 작업 사용
  • 삭제 전 중요한 레코드의 백업 유지
  • 부분 실패에 대한 응답 모니터링
배치 처리:
  • 시스템은 단일 요청에서 모든 레코드 ID를 처리합니다
  • 일부 레코드가 삭제에 실패하면 응답에 상세한 오류 정보가 포함됩니다
  • 부분 실패가 가능합니다 - 일부 레코드는 삭제되고 다른 레코드는 실패할 수 있습니다

​
속도 제한

이 엔드포인트는 표준 속도 제한 정책을 따릅니다. 각 요청은 동시에 최대 25개의 레코드 삭제를 처리할 수 있습니다.

​
관련 엔드포인트

온고잉 모니터링 레코드 조회

특정 모니터링 레코드에 대한 상세 정보 조회

온고잉 모니터링 레코드 생성

제출에 대한 새로운 온고잉 모니터링 레코드 등록