Conversation Tags

Get tag by ID

Returns a single conversation tag by its Featurebase tag ID. Archived tags can still be retrieved directly by ID, while permanently deleted tags return 404.

GET

/v2/tags/{id}

Get tag by ID

curl --request GET \
  --url https://do.featurebase.app/v2/tags/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Featurebase-Version: 2026-08-19.orbit'

{
  "id": "67ec1234abcd5678ef901234",
  "name": "Churn",
  "type": "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-08-19.orbit, 2026-01-01.nova, 2025-12-12.clover

Example: 2026-08-19.orbit

Response

Success

idstringrequired

Unique tag identifier

Example: 67ec1234abcd5678ef901234

namestringrequired

Current tag name

Example: Churn

typeenum<string>required

Object type identifier for a tag

Available options: tag

Example: tag

Still need help? Ask the team