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"
}
이 작업은 되돌릴 수 없습니다. 삭제된 레코드는 복구할 수 없습니다.

엔드포인트

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개의 레코드 삭제를 처리할 수 있습니다.

관련 엔드포인트