> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thanx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Tags

<Info>
  Scope required: `tags.write`
</Info>

This endpoint allows for bulk deletion of tags

### Parameters

<ParamField body="merchant_id" type="string" required>
  Merchant ID
</ParamField>

<ParamField body="user_ids" type="array<string>" required>
  User IDs (500 max per request)
</ParamField>

<Warning>
  `user_ids` must be each user's Thanx identifier — the value returned as `id` by
  [Get Users](/partner/users/get-users). An ID copied from a dashboard URL or a
  customer-data/SFTP export is a **different encoding** and will not match: the
  request returns `200` with **zero tags deleted** and no error. Confirm one test
  user matches before running a bulk delete.
</Warning>

<ParamField body="key" type="string" required>
  Tag Key
</ParamField>

### Response

<RequestExample>
  ```bash theme={null}
  curl https://api.thanxsandbox.com/partner/tags \
    -X DELETE \
    -H 'X-ClientId: {client_id}' \
    -H 'Accept-Version: v4.0' \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer {access_token}' \
    -d '{
      "merchant_id": "weroifs",
      "user_ids": [
        "wroeiu2304hfwf",
        "73bf1f46769dwr"
      ],
      "key": "allergens"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {}
  ```
</ResponseExample>