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
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 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.