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

# Delete a Contact Tag via the ChatbotX REST API

> Permanently delete a tag from your ChatbotX workspace by its unique ID. Contacts that held the tag will no longer have it assigned.

Use this endpoint to permanently remove a tag from your workspace. Once deleted, the tag will be unassigned from all contacts that previously held it. This action is irreversible, so confirm you no longer need the tag before proceeding.

<Info>
  **DELETE** `/api/v1/tags/{id}`
</Info>

## Path Parameters

<ParamField path="id" type="string" required>
  The numeric ID of the tag to delete. Must match the pattern `\d+`.
</ParamField>

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl --request DELETE \
    --url https://app.chatbotx.io/api/v1/tags/203 \
    --header 'Authorization: Bearer <token>'
  ```

  ```python Python theme={null}
  import requests

  url = "https://app.chatbotx.io/api/v1/tags/203"

  headers = {"Authorization": "Bearer <token>"}

  response = requests.delete(url, headers=headers)
  print(response.status_code)  # 204 on success
  ```

  ```javascript JavaScript theme={null}
  const options = {
    method: 'DELETE',
    headers: { Authorization: 'Bearer <token>' }
  };

  fetch('https://app.chatbotx.io/api/v1/tags/203', options)
    .then(res => {
      if (res.status === 204) console.log('Tag deleted successfully.');
    })
    .catch(err => console.error(err));
  ```
</CodeGroup>

## Response

Returns `204 No Content` on success. No response body is returned.

<Warning>
  Deleting a tag is permanent. All contacts that carried this tag will no longer have it, and the tag cannot be recovered.
</Warning>