Delete tag
Tags
Delete tag
Soft-deletes a tag by its key. Tags synced from a CRM integration cannot be deleted via the API.
DELETE
Delete tag
Required scope:
TAGS_WRITEBehavior
Deletes a tag by its key (theid 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
404with codeTAG_NOT_FOUND. - Tags synced from a CRM integration cannot be deleted via the API and return a
409with codeCRM_SYNCED_TAG_READONLY. Manage those from the connected CRM instead.
Idempotency
This endpoint supports theIdempotency-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.