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

# Créer un Tag

> Créez un Tag réutilisable dans le workspace, avec une couleur facultative. Il n’est rattaché à aucun prompt tant qu’un prompt n’est pas mis à jour.

Crée un Tag sans le rattacher à aucun prompt. Pour l’appliquer, [mettez à jour un prompt](https://docs.qwairy.co/fr/developers/endpoints/prompts/update.md) ou utilisez les [mises à jour de prompts en masse](https://docs.qwairy.co/fr/developers/endpoints/prompts/bulk.md).

`Branded` et `Non-branded` sont des noms de Tags système réservés, quelle que soit la casse. Dans un workspace créé à partir de la v1.21, Qwairy crée lui-même ces deux Tags et en pose un sur chaque prompt d’après son texte. Dans tout workspace, une requête qui utilise l’un de ces noms comme `name` est refusée.

Nécessite une offre Business, Agency Business ou Enterprise active. Utilisez un jeton d’API dont l’accès en écriture est activé. Consultez [Écrire des données](https://docs.qwairy.co/fr/developers/writing-data.md) pour l’idempotence, les requêtes conditionnelles et la gestion des erreurs.

**Authorization** `string` *required*

Jeton bearer de votre équipe.

**Idempotency-Key** `string` *required*

Clé unique pour cette opération. Les réponses terminées sont rejouées pendant 24 heures.

**brandId** `string` *required*

Identifiant du workspace. Le workspace doit appartenir à l’équipe du jeton.

**name** `string` *required*

Nom du Tag, 1 à 120 caractères après suppression des espaces en bordure.

**color** `string | null`

Couleur hexadécimale facultative à six chiffres, comme `#7B3AEE`. `null` par défaut.

## Réponse

Renvoie `201` avec `Location`, `ETag` et un objet `tag` contenant `id`, `name`, `color` (nullable), `version`, `createdAt` et `updatedAt`.

## Requête et réponse synthétiques

```bash theme={null}
curl -X POST "https://www.qwairy.co/api/v1/brands/$BRAND_ID/tags" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN" \
  -H "Idempotency-Key: tag-pricing-001" \
  -H "Content-Type: application/json" \
  -d '{"name":"Pricing","color":"#7B3AEE"}'
```

```json theme={null}
{
  "tag": {
    "id": "22222222-0000-4000-8000-000000000000",
    "name": "Pricing",
    "color": "#7B3AEE",
    "version": 0,
    "createdAt": "2026-09-01T09:00:00.000Z",
    "updatedAt": "2026-09-01T09:00:00.000Z"
  }
}
```

## Erreurs

Des champs invalides, ou un nom de Tag système réservé (`Branded` ou `Non-branded`, quelle que soit la casse), renvoient `400 INVALID_REQUEST` ; un workspace absent renvoie `404 RESOURCE_NOT_FOUND` ; un nom en doublon renvoie `409 CONFLICT`.

Consultez [Codes d’erreur](https://docs.qwairy.co/fr/developers/errors.md) pour les erreurs d’authentification, d’offre, d’idempotence et de serveur. Sur `429`, respectez `Retry-After` ; les écritures peuvent renvoyer `503 SERVICE_UNAVAILABLE` si le limiteur d’écriture est indisponible.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.