Notes

  • Deleted submissions cannot be restored.
  • Deleted submissions are still subject to billing.
  • Deleted submissions will appear as “Deleted Submission” in the dashboard and GET/API responses.
  • Use this API with caution to avoid unintentionally deleting critical data.

1. Endpoint

DELETE/Submission
DELETE https://rest-api.argosidentity.com/v3/submission

2. Authentication

Include the API key in the x-api-key header:

x-api-key
x-api-key: {yourAPIKey}

3. Request Parameter

submissionId
string
required

Unique ID of the submission to be deleted

admin_name
string
required

Deleted the admin name

The admin_name is optional; however, it is necessary for the admin to specify the admin_name parameter in order to receive a webhook after a submission is deleted.

3-1. Data to be Deleted

  • Personal identity information (e.g., name, date of birth, gender, nationality)
  • Sensitive ID details (e.g., document number, serial number, barcode)
  • Image files (e.g., ID images, selfies)
  • AML data (if stored via AML options)

3-2. Data to be Retained

  • Basic data that cannot identify individuals, such as Submission ID, submission date, ID type, and ID Check approval status.

4. Request Example

DELETE/Submission
bash Request
curl --location --request DELETE 'https://rest-api.argosidentity.com/v3/submission?submission_id={submission_id}&admin_name={admin_name}' \
--header 'x-api-key: {yourAPIKey}'

5. Response

5-1. Success Response

result.json
{
	"message": "success",
	"content": "Submission {submissionID} deleted successfully."
}

5-2. Error Response

If an error occurs, a 400 status code is returned along with details in the response body:

error.json
{
    "errorCode": "not Exist Submission ID"
}

5-3. Error Codes

Error CodesDescription
not Exist Submission IDsubmission_id is missing
not Exist Submission DataNo data found for the specified submission_id
not Exist Project DataProject information is missing
delete Process FAILDeletion process failed (e.g., Meta Face ID deletion failure)