Skip to main content
Important Notes
  • Deleted specific fields cannot be restored.
  • Use this API with caution. Be careful not to accidentally delete important data.
  • When Partial Delete is applied to a component that is a target for duplicate checking, duplicate checks will not be applied to that submission.
    • Even if data identical to the state before Partial Delete was applied comes in, duplicate checks will not be applied.

​
1. Endpoint

PARTIAL-DELETE/Submission
DELETE https://rest-api.argosidentity.com/v3/submission/partial?submission_id={submission_id}

​
2. Authentication

Include the API key in the x-api-key header:
x-api-key
x-api-key: {yourAPIKey}

​
3. Request Parameter

​
submission_id
string
required
Unique ID of the submission to be deleted
​
fields
string
required
Use the fields parameter to selectively delete specific types of data. You can input one of the following options:
  • id_image
  • selfie_image
  • data: Final confirmed dataset as a result of the process
  • OCR_raw(*case-sensitive): RAW dataset extracted by OCR
  • ocr: Dataset converted from extracted OCR to standardized format
  • review: Result dataset reviewed by user using OCR results (automatically processed with the same value when OCR recognition score is high)
  • applicant_id
  • email
  • userid
  • additional_list
  • duplicated_information
  • custom_duplicated_information
  • injection_action
​
data_fields
string
Use the data_fields parameter to selectively delete specific types of personal information within the data field. data_fields only works when the data field is declared in the fields parameter, and in this case, if no value is provided in the data_fields parameter, all sub-data under data will be deleted. Data refers to the final confirmed dataset as a result of the process. You can input one of the following options:
  • age_group
  • first_name
  • last_name
  • full_name
  • name
  • gender
  • nationality
  • date_of_birth
  • address_city
  • address_country
  • address_state
  • address_street
  • address_street2
  • address_zipcode
  • address_globalCode
  • address_compoundCode
  • address_formatted
  • address_input
  • address_detail
  • ip_address
  • idcard_issuingCountry
  • idcard_issueDate
  • idcard_expireDate
  • idType
  • documentNumber
  • identityNumber
  • ssnNumber
  • phoneNumber
  • cf1
  • cf2
  • cf3
​
admin_name
string
Name of the administrator who performed the deletion

​
3-1. Data to be Deleted

  • parameters declared from fields and data_fields

​
3-2. Data to be Retained

  • In submitted cases, parameters not declared in fields, and when specific parameters are specified in data_fields, unspecified parameters will not be deleted and will be retained.

​
4. Request Example

​
Using fields only

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

​
Using fields and data_fields

PARTIAL-DELETE/Submission
curl --location --request DELETE 'https://rest-api.argosidentity.com/v3/submission/partial?submission_id={submission_id}&fields=data&data_fields=gender,ip_address' \ --header 'x-api-key: {yourAPIKey}'

​
Using multiple fields and data_fields

PARTIAL-DELETE/Submission
curl --location --request DELETE 'https://rest-api.argosidentity.com/v3/submission/partial?submission_id={submission_id}&fields=id_image,data,selfie_image&data_fields=gender,ip_address' \ --header 'x-api-key: {yourAPIKey}'

​
5. Response

​
5-1. Success Response

{
    "message": "success",
    "content": "Submission {submission_id} partially deleted successfully.",
    "statusCode": 200
}

​
5-2. Error Response

If an error occurs, a 400 status code is returned along with details in the response body:
error.json
{
    "message": "submission_id is required",
    "statusCode": 400
}

​
5-3. Error Codes

Error CodeDescription
submission_id is requiredRequired parameter submission_id is missing from the request
fields parameter is required and cannot be emptyRequired parameter fields is missing or empty in the request
fields must be a string
data_fields must be a string		fields parameter is not in string format

data_fields parameter is not in string format
fields cannot be emptyfields parameter is empty
invalid fields found in fields: field1, field2
invalid fields found in data_fields: field1, field2		Invalid fields are included in fields

Invalid fields are included in data_fields
data_fields parameter is not allowed when fields does not include datadata_fields parameter is provided when data is not included in the fields parameter
invalid format for fields: error messageFormat of fields parameter is invalid
invalid format for data_fields: error messageFormat of data_fields parameter is invalid
invalid API key for this projectProvided API key is not valid for this project
not Exist Submission DataNo data exists for the requested submission_id
not Exist Project DataNo project data exists
Internal server errorInternal server error occurred