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

> Créez un libellé de Topic pour organiser les prompts d’un workspace. Le chemin de l’API garde le nom keywords ; affectez le Topic via une mise à jour de prompt.

Crée un libellé de Topic. Le chemin de l’API garde le nom `keywords` ; la ressource est un Topic. Utilisez [Mettre à jour un prompt](https://docs.qwairy.co/fr/developers/endpoints/prompts/update.md) pour l’affecter.

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.

**text** `string` *required*

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

## Réponse

Renvoie `201` avec `Location`, `ETag` et un `topic` contenant `id`, `text`, `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/keywords" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN" \
  -H "Idempotency-Key: topic-pricing-001" \
  -H "Content-Type: application/json" \
  -d '{"text":"Pricing"}'
```

```json theme={null}
{
  "topic":{
    "id":"11111111-0000-4000-8000-000000000000",
    "text":"Pricing",
    "version":0,
    "createdAt":"2026-09-01T09:00:00.000Z",
    "updatedAt":"2026-09-01T09:00:00.000Z"
  }
}
```

## Opérations liées

* [Obtenir un Topic](https://docs.qwairy.co/fr/developers/endpoints/keywords/get.md), [le mettre à jour](https://docs.qwairy.co/fr/developers/endpoints/keywords/update.md) ou [le supprimer](https://docs.qwairy.co/fr/developers/endpoints/keywords/delete.md).
* [Lister les Topics](https://docs.qwairy.co/fr/developers/endpoints/keywords/list.md) avec `view=configuration` pour inclure les libellés sans réponse et leurs versions actuelles.
* [Créer un Tag](https://docs.qwairy.co/fr/developers/endpoints/tags/create.md) pour des libellés secondaires réutilisables.

## Erreurs

Un texte invalide renvoie `400 INVALID_REQUEST` ; un workspace inaccessible renvoie `404 RESOURCE_NOT_FOUND` ; un libellé 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.