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

# Annotation Tags - Delete

> Delete a specific annotation tag from the organization.

This endpoint deletes a specific annotation tag by ID. It supports:

* Verifying tag ownership (tags can only be deleted by the organization that owns them)
* Automatic validation that the tag exists before deletion

### Path

<ParamField path="id" type="string" required>
  The unique identifier (CUID) of the annotation tag to delete.
</ParamField>

### Response

<ResponseField name="success" type="boolean">
  Indicates whether the deletion was successful. Always `true` on successful deletion.
</ResponseField>

### Error Responses

| Status Code | Type         | Description                                                                          |
| ----------- | ------------ | ------------------------------------------------------------------------------------ |
| 401         | UNAUTHORIZED | Missing or invalid authentication session.                                           |
| 404         | NOT\_FOUND   | The tag with the specified ID does not exist or does not belong to the organization. |

<RequestExample>
  ```bash cURL theme={null}
  curl --location --request DELETE 'https://dashboard.laburen.com/api/annotations/tags/clxxxxxxxxxxxxxxxxx' \
  --header 'Authorization: Bearer <API_KEY>'
  ```

  ```javascript JavaScript theme={null}
  const apiUrl = 'https://dashboard.laburen.com/api';
  const apiKey = '<API_KEY>';

  const response = await fetch(`${apiUrl}/annotations/tags/clxxxxxxxxxxxxxxxxx`, {
    method: 'DELETE',
    headers: {
      'Authorization': `Bearer ${apiKey}`,
    },
  });

  const data = await response.json();
  console.log(data);
  ```

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

  api_url = "https://dashboard.laburen.com/api"
  api_key = "<API_KEY>"

  response = requests.delete(
      f"{api_url}/annotations/tags/clxxxxxxxxxxxxxxxxx",
      headers={
          "Authorization": f"Bearer {api_key}",
      },
  )

  data = response.json()
  print(data)
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true
  }
  ```
</ResponseExample>
