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"
}
This action is irreversible. Deleted records cannot be recovered.

Endpoint

DELETE /submission/aml/monitor/{worklistId}

Base URL

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

Authentication

Include your API key in the request header:
x-api-key
string
required
Your API key for authentication

Path Parameters

worklistId
string
required
The ID of the worklist containing the records to delete

Request Body

admin
string
required
Email address of the administrator making the deletion request (must be registered in the project’s admin list)
recordIds
array
required
Array of record IDs to delete (1-25 records maximum)

Request Example

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"
    ]
  }'

Response

Success Response

{
  "message": "records deleted successfully"
}

Response Fields

message
string
required
Success message confirming the deletion operation

Error Response

{
  "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"
      }
    }
  ]
}

Error Codes

Error CodeHTTP StatusDescription
invalid_payload400Missing request payload or format error
invalid_admin400Invalid admin account or admin not registered in the project
invalid_record400One or more record IDs do not exist
invalide_worklist400Invalid worklist ID
invalid_project400Missing project ID or invalid API key

Important Notes

Deletion Limitations:
  • Maximum 25 records can be deleted per request
  • Only records within the specified worklist can be deleted
  • Deletion is permanent and cannot be undone
  • Ensure you have the correct record IDs before proceeding
Best Practices:
  • Verify record IDs exist before attempting deletion
  • Use batch operations for multiple deletions to improve efficiency
  • Keep a backup of important records before deletion
  • Monitor the response for any partial failures
Batch Processing:
  • The system processes all record IDs in a single request
  • If some records fail to delete, the response will include detailed error information
  • Partial failures are possible - some records may be deleted while others fail

Rate Limits

This endpoint follows the standard rate limiting policies. Each request can process up to 25 record deletions simultaneously.