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

# Mettre à jour un Tag

> Modifiez le nom ou la couleur d’un Tag avec l’ETag lu en dernier dans If-Match. Les champs omis gardent leur valeur et les liens avec les prompts restent.

Met à jour les champs fournis d’un Tag. Les champs omis gardent leur valeur actuelle.

`Branded` et `Non-branded` sont des noms de Tags système réservés, quelle que soit la casse. Vous ne pouvez pas mettre à jour l’un de ces deux Tags système ni renommer un autre Tag avec l’un de ces noms.

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.

**If-Match** `string` *required*

Copiez l’`ETag` complet du dernier GET, guillemets compris.

**brandId** `string` *required*

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

**tagId** `string` *required*

Identifiant du Tag dans ce workspace.

**name** `string`

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

**color** `string | null`

Couleur hexadécimale à six chiffres, comme `#7B3AEE`. Définissez `null` pour l’effacer.

Fournissez au moins `name` ou `color`.

## Réponse

Renvoie `200` avec un objet `tag` de la même forme que [Obtenir un Tag](https://docs.qwairy.co/fr/developers/endpoints/tags/get.md) et un nouvel `ETag`. La réponse de mutation n’a pas de champ `success` au premier niveau. Traitez les versions comme des valeurs opaques, et non comme des compteurs.

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

Lisez d’abord [le Tag actuel](https://docs.qwairy.co/fr/developers/endpoints/tags/get.md). Cet exemple suppose que son ETag est `"4"`.

```bash theme={null}
curl -X PATCH "https://www.qwairy.co/api/v1/brands/$BRAND_ID/tags/$TAG_ID" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN" \
  -H 'If-Match: "4"' \
  -H "Content-Type: application/json" \
  -d '{"name":"Pricing and plans"}'
```

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

## Erreurs

| Statut | Code | Cause |
| - | - | - |
| 400 | `INVALID_REQUEST` | Champs du Tag invalides, Tag système ou nom de Tag système réservé |
| 404 | `RESOURCE_NOT_FOUND` | Workspace ou Tag absent ou inaccessible |
| 409 | `CONFLICT` | Un autre Tag utilise déjà ce nom |
| 412 | `PRECONDITION_FAILED` | L’ETag est périmé ou invalide |
| 428 | `PRECONDITION_REQUIRED` | `If-Match` est absent |

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.