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

# Delete Tag

> Permanently delete a tag and remove it from all items.

## Path Parameters

<ParamField path="id" type="string" required>
  The tag ID. Example: `tag_n5j2x`.
</ParamField>

## Response

Returns `204 No Content` on success. The tag is removed from all items and permanently deleted.

<Warning>
  This action is irreversible. All items that had this tag will have it removed.
</Warning>

<RequestExample>
  ```bash cURL theme={null}
  curl -X DELETE https://api.getmatter.com/public/v1/tags/tag_n5j2x \
    -H "Authorization: Bearer mat_your_token_here"
  ```

  ```python Python theme={null}
  response = requests.delete(
      "https://api.getmatter.com/public/v1/tags/tag_n5j2x",
      headers={"Authorization": f"Bearer {token}"}
  )
  assert response.status_code == 204
  ```
</RequestExample>

<ResponseExample>
  ```json 204 theme={null}
  (No content)
  ```
</ResponseExample>