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

# Delete Tag

> Delete a tag; every record carrying it loses it

<Warning>
  **This removes the tag from every record carrying it**, and cannot be undone.

  To take one tag off one record instead, send it with `mode: remove` to the
  record's tag endpoint — [Set An Account's
  Tags](/api-reference/set-account-record-tags), for example. That is a
  different act, and it is reversible.
</Warning>

Check how many records are affected first: `GET /tag-groups?with_counts=true`
reports a `subject_count` per tag.

## Path Parameters

<ParamField path="tagId" type="string" required>
  The tag's id, from [List Tags](/api-reference/list-tags).
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X DELETE "https://api.clustr-ai.com/api/public/tags/cbfd0074-57bd-4fa7-a5fc-8bb5392b16c9" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": { "deleted": true }
  }
  ```

  ```json 404 theme={null}
  {
    "success": false,
    "error": { "message": "tag not found", "code": "NOT_FOUND" }
  }
  ```
</ResponseExample>