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

# Overview

> Discover available call tags for filtering conversations

The Tags API lets you list all tags configured on your team. Use tag names when filtering conversations by tags in the search endpoints.

## Tag constraints

| Field      | Constraint                                                                                                  |
| ---------- | ----------------------------------------------------------------------------------------------------------- |
| Name       | Required. Max 255 characters.                                                                               |
| Key        | Auto-generated from the name (lowercase, alphanumeric). Used as the identifier in the API.                  |
| Color      | Optional. Hex format, max 7 characters (e.g., `#FF0000`).                                                   |
| Uniqueness | Tag keys are unique per team. Names are case-insensitive — `Support` and `support` resolve to the same tag. |

Tags can only be created from the Allo dashboard. The API lets you list existing tags and add or remove them from calls.

## Endpoints

<CardGroup cols={1}>
  <Card title="List tags" href="/en/v2/api-reference/tags/list-tags">
    All available call tags with name and color
  </Card>

  <Card title="Add tags" href="/en/v2/api-reference/tags/add-tags">
    Add one or more tags to a call
  </Card>

  <Card title="Remove tag" href="/en/v2/api-reference/tags/remove-tag">
    Remove a tag from a call
  </Card>
</CardGroup>