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

> Modifiez, archivez ou restaurez un prompt, dont son calendrier, son Topic, ses Tags, ses pays et ses modèles, avec l’ETag lu en dernier dans If-Match.

Ne met à jour que les champs fournis. Lisez d’abord le prompt avec `view=configuration`, y compris pour restaurer un prompt archivé. L’archivage préserve ses réponses enregistrées et son historique.

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.

**promptId** `string` *required*

UUID du prompt dans le workspace.

**text** `string`

Texte de remplacement, 1 à 500 caractères après suppression des espaces en bordure, comme dans le dashboard. Lorsque le texte change dans un workspace créé à partir de la v1.21, Qwairy pose de nouveau le Tag système `Branded` ou `Non-branded` d’après le nouveau texte.

**status** `string`

`ACTIVE` ou `ARCHIVED`. L’archivage conserve les réponses et l’historique ; définir `ACTIVE` restaure le prompt.

**frequency** `string | null`

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

**monitoringEnabled** `boolean`

Indique si le prompt participe au suivi planifié.

**keywordId** `string | null`

UUID d’un Topic de ce workspace, ou `null` pour détacher son Topic actuel.

**tagIds** `string[]`

Liste de remplacement complète d’au plus 50 UUID de Tags de ce workspace. Un tableau vide retire tous les Tags, sauf le Tag système `Branded` ou `Non-branded` que porte le prompt, s’il en a un. Dans un workspace créé à partir de la v1.21, Qwairy pose ce Tag d’après le texte du prompt. L’identifiant de l’un ou l’autre Tag système dans cette liste est ignoré, et celui que porte le prompt est conservé.

**countryCodes** `string[]`

Liste de remplacement complète d’au plus 50 codes de pays en majuscules sur deux lettres issus du catalogue de pays du workspace. Un tableau vide rétablit le pays par défaut du workspace.

**modelIds** `string[]`

Liste de remplacement complète d’au plus 30 identifiants de modèles pour ce prompt uniquement. Un tableau vide rétablit les modèles du workspace.

Fournissez au moins un champ modifiable.

## Réponse

Renvoie `200`, un `ETag` mis à jour et un objet `prompt` avec les champs ci-dessous, dont `countryCodes` et `modelIds` (des tableaux vides signifient les valeurs par défaut du workspace). Il n’y a pas de champ `success` au premier niveau. Les dates suivent le format ISO 8601. La `version` est une valeur de concurrence opaque.

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

```bash theme={null}
curl -i "https://www.qwairy.co/api/v1/brands/$BRAND_ID/prompts/$PROMPT_ID?view=configuration" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN"
# Assume the returned ETag is "2".
curl -X PATCH "https://www.qwairy.co/api/v1/brands/$BRAND_ID/prompts/$PROMPT_ID" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN" \
  -H 'If-Match: "2"' \
  -H "Content-Type: application/json" \
  -d '{"status":"ARCHIVED"}'
```

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

## Erreurs

| Statut | Code | Cause |
| - | - | - |
| 400 | `INVALID_REQUEST` | Aucun champ modifiable ou valeur de champ invalide |
| 404 | `RESOURCE_NOT_FOUND` | Workspace, prompt, Topic ou Tag absent ou inaccessible |
| 409 | `CONFLICT` | Texte de prompt en doublon ou workspace non modifiable |
| 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.