> ## 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 le suivi

> Modifiez le calendrier de suivi et les modèles d’un workspace, mettez le suivi en pause ou validez un changement avec dryRun avant de l’enregistrer avec l’ETag.

Met à jour les réglages de suivi fournis. Lisez d’abord [Obtenir le suivi](https://docs.qwairy.co/fr/developers/endpoints/brands/monitoring.md) et copiez son ETag. Lorsque le GET renvoie des valeurs par défaut calculées, l’ETag initial est `"0"` ; ce PATCH enregistre les premiers réglages. Les champs omis gardent les valeurs par défaut : aucun modèle et pas de réponses automatiques.

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.

**frequency** `string`

`NONE`, `DAILY`, `WEEKLY` ou `MONTHLY`. `NONE` arrête le calendrier du workspace : les prompts qui en héritent s’arrêtent, ceux qui ont leur propre fréquence continuent, comme dans le dashboard.

**analysisWeekDay** `integer | null`

Jour de 1 à 7 pour le suivi hebdomadaire. Pour les premiers réglages enregistrés, une valeur omise ou null utilise le jour de la semaine en cours ; les mises à jour suivantes peuvent enregistrer null.

**analysisMonthDay** `integer | null`

Jour de 1 à 28 pour le suivi mensuel. Pour les premiers réglages enregistrés, une valeur omise ou null utilise le jour 1 ; les mises à jour suivantes peuvent enregistrer null.

**autoGenerateAnswers** `boolean`

Indique si l’analyse planifiée génère automatiquement des réponses.

**models** `string[]`

Liste de remplacement de 1 à 20 codes de modèles Qwairy activés. Lisez les codes actuellement sélectionnés avec GET. Les codes inconnus ou désactivés sont rejetés.

**dryRun** `boolean` (default: false)

Valide le changement et renvoie le résultat sans rien modifier.

Fournissez au moins un champ modifiable. Passer à `NONE` conserve les réglages de suivi de chaque prompt. Le travail accepté avant le changement peut encore se terminer.

## Réponse

Renvoie `200`, un nouvel `ETag` et un objet `monitoring` avec les mêmes champs que [Obtenir le suivi](https://docs.qwairy.co/fr/developers/endpoints/brands/monitoring.md). `paused` indique si `frequency` vaut `NONE` ; `isDefault` est faux une fois les réglages enregistrés.

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

Cet exemple suppose que l’ETag actuel du suivi est `"3"`.

```bash theme={null}
curl -X PATCH "https://www.qwairy.co/api/v1/brands/$BRAND_ID/monitoring" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN" \
  -H 'If-Match: "3"' \
  -H "Content-Type: application/json" \
  -d '{"frequency":"NONE"}'
```

```json theme={null}
{
  "monitoring": {
    "brandId": "b1c2d3e4-0000-4000-8000-000000000000",
    "frequency": "NONE",
    "paused": true,
    "analysisWeekDay": 1,
    "analysisMonthDay": 1,
    "autoGenerateAnswers": true,
    "models": ["openai-gpt"],
    "lastAnalysisDate": null,
    "version": 4,
    "isDefault": false
  }
}
```

## Erreurs

| Statut | Code | Cause |
| - | - | - |
| 400 | `INVALID_REQUEST` | Calendrier invalide ou sélection de modèles vide ou indisponible |
| 403 | `INSUFFICIENT_PLAN` | Un modèle sélectionné est un modèle premium non inclus dans votre offre |
| 404 | `RESOURCE_NOT_FOUND` | Workspace absent ou inaccessible |
| 412 | `PRECONDITION_FAILED` | Le suivi a changé depuis votre lecture |
| 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.