Skip to main content
DELETE
Delete tag
Required scope: TAGS_WRITE

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.

Authorizations

Authorization
string
header
required

Path Parameters

id
string
required

Tag key (the identifier returned by GET /v2/api/tags).

Example:

"interested"

Response

Tag deleted