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

> Ajoutez un prompt suivi, avec calendrier, Topic, Tags, pays et modèles facultatifs. Créer un prompt ne lance pas de collecte de réponses facturable.

Crée un prompt sans lancer de collecte de réponses facturable. Utilisez [Lancer un run](https://docs.qwairy.co/fr/developers/endpoints/runs/manage.md) pour demander de nouvelles réponses pour un workspace live.

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 prompt, 1 à 500 caractères après suppression des espaces en bordure, comme dans le dashboard.

**frequency** `string | null`

`NONE`, `DAILY`, `WEEKLY`, `MONTHLY`, ou null. Omettez-le ou utilisez null pour hériter du calendrier du workspace.

**keywordId** `string | null`

UUID d’un Topic de ce workspace. Omettez-le ou utilisez null pour créer un prompt non affecté.

**tagIds** `string[]`

Jusqu’à 50 UUID de Tags de ce workspace. Aucun Tag par défaut. Dans un workspace créé à partir de la v1.21, Qwairy pose le Tag système `Branded` ou `Non-branded` d’après le texte du prompt. L’identifiant de l’un ou l’autre Tag système est ignoré si vous l’envoyez.

**countryCodes** `string[]`

Jusqu’à 50 codes de pays en majuscules sur deux lettres issus du catalogue de pays du workspace, les pays dans lesquels ce prompt s’exécute. Omettez-le ou envoyez un tableau vide pour utiliser le pays par défaut du workspace. Gérez le catalogue avec [Mettre à jour un workspace](https://docs.qwairy.co/fr/developers/endpoints/brands/update.md).

**modelIds** `string[]`

Jusqu’à 30 identifiants de modèles pour ce prompt uniquement. Omettez-le ou envoyez un tableau vide pour utiliser les modèles du workspace.

## Réponse

Renvoie `201` avec `Location`, `ETag` et un `prompt` contenant `id`, `text`, `status`, `frequency` (nullable), `monitoringEnabled`, `keywordId` (nullable), `tagIds`, `countryCodes`, `modelIds`, `version`, `createdAt` et `updatedAt`. Un nouveau prompt a `status: ACTIVE`. Dans un workspace créé à partir de la v1.21, il porte aussi un Tag système : `tagIds` inclut donc son identifiant ; un workspace créé avant n’a pas de Tags système. `countryCodes` et `modelIds` reprennent ce que le prompt enregistre : un tableau vide signifie que le prompt utilise le pays ou les modèles par défaut du workspace.

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

```bash theme={null}
curl -X POST "https://www.qwairy.co/api/v1/brands/$BRAND_ID/prompts" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN" \
  -H "Idempotency-Key: prompt-crm-001" \
  -H "Content-Type: application/json" \
  -d '{"text":"Which CRM tools support small sales teams?","frequency":"WEEKLY"}'
```

```json theme={null}
{
  "prompt":{
    "id":"33333333-0000-4000-8000-000000000000",
    "text":"Which CRM tools support small sales teams?",
    "status":"ACTIVE",
    "frequency":"WEEKLY",
    "monitoringEnabled":true,
    "keywordId":null,
    "tagIds":["55555555-0000-4000-8000-000000000000"],
    "countryCodes":[],
    "modelIds":[],
    "version":0,
    "createdAt":"2026-09-01T09:00:00.000Z",
    "updatedAt":"2026-09-01T09:00:00.000Z"
  }
}
```

## Opérations liées

* [Mettre à jour, archiver ou restaurer un prompt](https://docs.qwairy.co/fr/developers/endpoints/prompts/update.md).
* [Mettre à jour des prompts en masse](https://docs.qwairy.co/fr/developers/endpoints/prompts/bulk.md).
* [Lister les prompts](https://docs.qwairy.co/fr/developers/endpoints/prompts/list.md) avec `view=configuration` pour récupérer les champs modifiables et les prompts archivés.

## Erreurs

Des champs invalides renvoient `400 INVALID_REQUEST` ; des identifiants de workspace ou de libellé inaccessibles renvoient `404 RESOURCE_NOT_FOUND`. Un texte en doublon, y compris celui d’un prompt archivé, renvoie `409 CONFLICT` ; restaurez le prompt archivé au lieu de le recréer.

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.