> ## Documentation Index
> Fetch the complete documentation index at: https://docs.open.cx/llms.txt
> Use this file to discover all available pages before exploring further.

# Tags

> The Tags API lets you manage tags and tag categories for your organization and control AI auto-tagging.

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

<CardGroup>
  <Card title="List / Search Tags" icon="list" href="./list">
    List or search tags (filter by keyword, category, limit)
  </Card>

  <Card title="Tags in Use" icon="chart-bar" href="./in_use">
    List tags currently applied to sessions
  </Card>

  <Card title="Create/Update Tag" icon="plus" href="./upsert">
    Create or update a tag
  </Card>

  <Card title="Delete Tag" icon="trash" href="./delete">
    Remove a tag
  </Card>

  <Card title="List / Search Categories" icon="folder-tree" href="./categories/list">
    List or search tag categories
  </Card>

  <Card title="Create Category" icon="folder-plus" href="./categories/create">
    Create a tag category
  </Card>

  <Card title="Update Category" icon="pen" href="./categories/update">
    Update a tag category
  </Card>

  <Card title="Delete Category" icon="folder-minus" href="./categories/delete">
    Delete a tag category
  </Card>

  <Card title="Auto-tagging Status" icon="robot" href="./auto_tagging_get">
    Check if AI auto-tagging is enabled
  </Card>

  <Card title="Toggle Auto-tagging" icon="toggle-on" href="./auto_tagging_set">
    Enable or disable AI auto-tagging
  </Card>
</CardGroup>