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

> Renommez un Topic avec l’ETag lu en dernier dans If-Match. Les associations aux prompts et les réponses conservées sont préservées quand le nom change.

Renomme un Topic. Ses associations aux prompts et ses réponses conservées sont préservées.

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.

**keywordId** `string` *required*

Identifiant du Topic dans ce workspace.

**text** `string` *required*

Texte du Topic, 1 à 255 caractères après suppression des espaces en bordure.

## Réponse

Renvoie `200` avec un objet `topic` de la même forme que [Obtenir un Topic](https://docs.qwairy.co/fr/developers/endpoints/keywords/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 Topic actuel](https://docs.qwairy.co/fr/developers/endpoints/keywords/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/keywords/$TOPIC_ID" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN" \
  -H 'If-Match: "4"' \
  -H "Content-Type: application/json" \
  -d '{"text":"Pricing and plans"}'
```

```json theme={null}
{
  "topic": {
    "id": "11111111-0000-4000-8000-000000000000",
    "text": "Pricing and plans",
    "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 Topic invalides |
| 404 | `RESOURCE_NOT_FOUND` | Workspace ou Topic absent ou inaccessible |
| 409 | `CONFLICT` | Un autre Topic 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.