> ## 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. |

The API lets you manage the tag lifecycle — list, create, and delete 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="Create tag" href="/en/v2/api-reference/tags/create-tag">
    Create a new tag from a display name
  </Card>

  <Card title="Delete tag" href="/en/v2/api-reference/tags/delete-tag">
    Delete a tag by its key
  </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>