---
updatedAt: 2026-07-15T09:47:33.000Z
---

Fetch the complete documentation index at: https://docs.sumsub.com/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version.

# Remove applicant tags

# Overview

Use this method to remove specific [custom tags](https://cockpit.sumsub.com/checkus/sdkIntegrations/globalSettings/general/tags) from applicant profiles.

> 📘 Info
>
> * By removing tags from profiles, you do not remove them from the [Tags](https://cockpit.sumsub.com/checkus/#/sdkIntegrations/globalSettings/general/tags) page in the Dashboard.
> * To add new tags, use [this method](https://docs.sumsub.com/sumsub/reference/add-custom-applicant-tags).

# Request example

```curl
curl -X DELETE
     'https://api.sumsub.com/resources/applicants/5fd1012c885b5d0009d50e6e/tags' \
     -H 'Content-Type: application/json' \
     -H 'X-App-Token: <your-app-token>' \
     -H 'X-App-Access-Sig: <your-signature>' \
     -H 'X-App-Access-Ts: <unix-timestamp>' \
     -d '["Approved Sanctions", "Approved PEP", "821"]'
```

# Response explained

If the tags are removed correctly, you will get the following response:

```json
{
    "ok": 1
}
```

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

For example:

```json
{
  "description": "Invalid id 'xxxxxxxxxxxxx'",
  "code": 400,
  "correlationId": "77b612a1bb281c64c132dd0000000000"
}
```

> Neither error nor result is returned in cases where you specify non-existing tags in your request.

<br />

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "sumsub-api",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.sumsub.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "name": "X-App-Token",
        "in": "header",
        "x-default": ""
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/resources/applicants/{applicantId}/tags": {
      "delete": {
        "summary": "Remove applicant tags",
        "description": "",
        "operationId": "remove-custom-applicant-tags",
        "parameters": [
          {
            "name": "applicantId",
            "in": "path",
            "description": "Unique applicant identifier in the Sumsub system. <br><br>This identifier is a random combination of 24 digits and lowercase Latin characters. It is automatically generated when the applicant is created on the Sumsub side, and can be found in the [Dashboard](https://cockpit.sumsub.com/checkus/#/applicants/individual?limit=10&page=0). <br><br>If the `applicantId` is unknown to you, use the [Get applicant data (externalUserId)](https://docs.sumsub.com/sumsub/reference/get-applicant-data-via-externaluserid) method to fetch it.",
            "schema": {
              "type": "string"
            },
            "required": true
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "RAW_BODY": {
                    "type": "array",
                    "description": "Array of custom tags strings. Each string stands for a standalone tag. <br><br>Specify the tags to be removed from the applicant profile. Mind that each tag must be spelled exactly as it was created (for example, `Reliable` and `reliable` are considered different tags). The system cannot remove non-existing tags.",
                    "items": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```