Remove transaction tags

Overview

Use this method to remove custom tags from a particular transaction.

📘

Notes

  • Tag names are case sensitive. For example, Suspicious and suspicious are considered different.
  • By removing tags from transactions, you do not remove them from the Dashboard settings.

Request example

curl -X DELETE \
     'https://api.sumsub.com/resources/kyt/txns/66c46d7566f5244e45a81167/tags' \
     -H 'content-type: application/json' \
     -d '[
           "Anomaly med",
           "Suspicious pattern"
         ]'

Response explained

If the request is sent and processed correctly, you may receive one of the following responses:

  • When the transaction still holds tags, you will get the JSON file containing an array of objects representing the remaining tags. For example:
[
  {
    "label": "Bonus abuse",
    "type": "userDefined"
  },
  {
    "label": "Suspicious pattern",
    "type": "userDefined"
  }
]
  • When all tags are removed, the response will return no content.
No Content

If the request fails, you will receive an HTTP response containing an error code along with a message explaining the error.

For example:

{
  "description": "The request body must not be null",
  "code": 400,
  "correlationId": "9fb77d5080ca4efd4ab19624e50a1baf"
}

No error is returned in cases where you specify non-existing tags in your request.

Language
Credentials
Header
Click Try It! to start a request and see the response here!