> ## 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 Group

> Delete a group and every tag in it

<Warning>
  **This deletes the group's tags too**, and every record carrying one loses it.
  It cannot be undone.

  Check the damage first: `GET /tag-groups?with_counts=true` reports a
  `subject_count` per tag.
</Warning>

A group marked `is_system` is built in and returns `422` instead. Rename it if
its name no longer fits.

## Path Parameters

<ParamField path="groupId" type="string" required>
  The group's id, from [List Tag Groups](/api-reference/list-tag-groups).
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X DELETE "https://api.clustr-ai.com/api/public/tag-groups/5a1c3f88-92d4-4b0e-8e7a-1f2b3c4d5e60" \
    -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 group not found", "code": "NOT_FOUND" }
  }
  ```

  ```json 422 theme={null}
  {
    "success": false,
    "error": { "message": "this group is built in and cannot be deleted", "code": "UNPROCESSABLE_ENTITY" }
  }
  ```
</ResponseExample>