Skip to main content
The Tags API lets you manage tags and tag categories for your organization and control AI auto-tagging. Tags categorize chat sessions (e.g. “billing”, “refund”, “feature-request”) and help with filtering, reporting, and routing.

​
Key Concepts

  • Tag — A label that can be applied to chat sessions, with an optional description and auto-tagging setting
  • Tag category — A group of related tags (e.g. “Billing”, “Product Area”) so the AI can tag scalably across large taxonomies
  • Tags in use — Tags that are actually applied to sessions
  • Auto-tagging — When enabled, the AI automatically applies relevant tags to sessions based on conversation content
  • Search — List endpoints accept optional search, category_id (tags only), and limit query params for substring filtering

​
Available Endpoints

List / Search Tags

List or search tags (filter by keyword, category, limit)

Tags in Use

List tags currently applied to sessions

Create/Update Tag

Create or update a tag

Delete Tag

Remove a tag

List / Search Categories

List or search tag categories

Create Category

Create a tag category

Update Category

Update a tag category

Delete Category

Delete a tag category

Auto-tagging Status

Check if AI auto-tagging is enabled

Toggle Auto-tagging

Enable or disable AI auto-tagging