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

# Vue d'ensemble

> Decouvrez les tags d'appel disponibles pour filtrer les conversations

L'API Tags vous permet de lister tous les tags configures sur votre equipe. Utilisez les noms de tags pour filtrer les conversations par tags dans les endpoints de recherche.

## Contraintes des tags

| Champ   | Contrainte                                                                                                                         |
| ------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| Name    | Requis. 255 caracteres maximum.                                                                                                    |
| Key     | Genere automatiquement a partir du nom (minuscules, alphanumerique). Utilise comme identifiant dans l'API.                         |
| Color   | Optionnel. Format hexadecimal, 7 caracteres maximum (ex. `#FF0000`).                                                               |
| Unicite | Les cles de tags sont uniques par equipe. Les noms sont insensibles a la casse — `Support` et `support` correspondent au meme tag. |

L'API vous permet de gerer le cycle de vie des tags — lister, creer et supprimer — et de les ajouter ou retirer des appels.

## Endpoints

<CardGroup cols={1}>
  <Card title="Lister les tags" href="/fr/v2/api-reference/tags/list-tags">
    Tous les tags d'appel disponibles avec nom et couleur
  </Card>

  <Card title="Creer un tag" href="/fr/v2/api-reference/tags/create-tag">
    Creer un nouveau tag a partir d'un nom d'affichage
  </Card>

  <Card title="Supprimer un tag" href="/fr/v2/api-reference/tags/delete-tag">
    Supprimer un tag par sa cle
  </Card>

  <Card title="Ajouter des tags" href="/fr/v2/api-reference/tags/add-tags">
    Ajouter un ou plusieurs tags a un appel
  </Card>

  <Card title="Supprimer un tag d'un appel" href="/fr/v2/api-reference/tags/remove-tag">
    Retirer un tag d'un appel
  </Card>
</CardGroup>