# Delete tag

> Soft-deletes a tag by its key. Tags synced from a CRM integration cannot be deleted via the API.

`DELETE /v2/api/tags/{id}`

<Note>
**Required scope:** `TAGS_WRITE`
</Note>

## Behavior

Deletes a tag by its **key** (the `id` returned by `GET /v2/api/tags`). The tag is soft-deleted: it stops appearing in the list and can no longer be applied to calls, while historical call tagging is preserved.

- Deleting a tag that doesn't exist returns a `404` with code `TAG_NOT_FOUND`.
- Tags synced from a CRM integration cannot be deleted via the API and return a `409` with code `CRM_SYNCED_TAG_READONLY`. Manage those from the connected CRM instead.

## Idempotency

This endpoint supports the `Idempotency-Key` header. If a request succeeds and you retry with the same key, the stored response is returned without re-executing the operation. See [Idempotency](/docs/guides/error-handling#idempotency).
