Conversation Tags

Delete a tag

Deletes a conversation tag from the workspace catalog and removes it from aggregate conversation tag state. A live tag is archived and deleted in the same call. Historical part applications remain part of the audit trail where applicable. A tag that a workflow uses cannot be deleted (409).

DELETE

/v2/tags/{id}

Delete a tag

curl --request DELETE \
  --url https://do.featurebase.app/v2/tags/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Featurebase-Version: 2026-09-03.pulsar' \
  --header 'Content-Type: application/json' \
  --data '
{
  "actingAdminId": "507f1f77bcf86cd799439011"
}
'

{
  "deleted": true,
  "id": "67ec1234abcd5678ef901234",
  "object": "tag"
}

Authorizations

Authorizationstringheaderrequired

API key as Bearer token. Use: Authorization: Bearer sk_...

Path Parameters

idstringrequired

The Featurebase tag ID

Example: 67ec1234abcd5678ef901234

Headers

Featurebase-Versionenum<string>header

API version for this request. Defaults to your organization's configured API version if not specified.

Available options: 2026-09-03.pulsar, 2026-08-19.orbit, 2026-01-01.nova, 2025-12-12.clover

Example: 2026-09-03.pulsar

Body

actingAdminIdstring

Optional admin ID for actor attribution and permission checks.

Example: 507f1f77bcf86cd799439011

Response

Success

deletedenum<boolean>required

Whether the tag has been deleted

Available options: true

Example: true

idstringrequired

Unique tag identifier

Example: 67ec1234abcd5678ef901234

objectenum<string>required

Object type identifier

Available options: tag

Example: tag

Still need help? Ask the team