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

# Outils d’écriture des actions et du site

> Mettez à jour le statut d’une recommandation, ajoutez des pages au Diagnostic du site et lancez des audits de pages via MCP, à 5 crédits par page.

Ces outils mettent à jour le Centre d’actions et le Diagnostic du site. Lisez d’abord [Accès en écriture MCP](https://docs.qwairy.co/fr/mcp/write/overview.md) pour les offres, scopes, rôles, `dryRun`, `expectedVersion` et jetons de confirmation. Les exemples utilisent des données synthétiques.

| Outil | Scope | Rôle minimal | Confirmation | Équivalent REST |
| - | - | - | - | - |
| `update_action_status` | `write:actions` | Manager | `never` | [`PATCH /brands/{brandId}/actions/{actionId}`](https://docs.qwairy.co/fr/developers/endpoints/actions/update-status) |
| `add_site_pages` | `write:site` | Manager | `never` | [`POST /brands/{brandId}/site-diagnostics/pages`](https://docs.qwairy.co/fr/developers/endpoints/site-diagnostics/add-pages) |
| `start_site_audit` | `write:site` | Manager | `always` | [`POST /brands/{brandId}/site-diagnostics/audits`](https://docs.qwairy.co/fr/developers/endpoints/site-diagnostics/start-audit) |

## update\_action\_status

Fait passer une recommandation du Centre d’actions à un autre statut.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | Identifiant du workspace |
| `actionId` | string | Oui | Identifiant de l’action issu de `get_actions` |
| `status` | string | Oui | `SUGGESTED`, `PENDING`, `IN_PROGRESS`, `COMPLETED`, `DISMISSED` ou `RESOLVED` |
| `expectedVersion` | integer | Oui | `version` de l’action que vous avez lue en dernier |
| `dryRun` | boolean | Non | Aperçu sans modification |
| `confirmationToken` | string | Non | Jeton renvoyé par l’aperçu |

### Exemple

```text theme={null}
Vous : Passe la recommandation sur la page de tarifs en cours.

Assistant : lit get_actions, puis appelle update_action_status avec
  {"brandId": "brand_01", "actionId": "action_01", "status": "IN_PROGRESS", "expectedVersion": 2}

Qwairy : met à jour le statut et renvoie l’action avec sa nouvelle version.
```

***

## add\_site\_pages

Ajoute au Diagnostic du site jusqu’à 50 URL du domaine du workspace. Ajouter une page ne l’audite pas.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | Identifiant du workspace |
| `urls` | string\[] | Oui | De 1 à 50 URL du domaine du workspace, chacune jusqu’à 2048 caractères |
| `dryRun` | boolean | Non | Aperçu sans ajout |
| `confirmationToken` | string | Non | Jeton renvoyé par l’aperçu |

Les URL déjà suivies sont signalées comme telles au lieu d’être dupliquées.

### Exemple

```text theme={null}
Vous : Suis nos pages de tarifs et de fonctionnalités.

Assistant : appelle add_site_pages avec
  {"brandId": "brand_01", "urls": ["https://acme.example/pricing", "https://acme.example/features"]}

Qwairy : ajoute les deux pages et renvoie leurs identifiants. Aucun audit n’a démarré.
```

***

## start\_site\_audit

Audite jusqu’à 50 pages sélectionnées, ou toutes les pages suivies avec `all` (10 000 au maximum). L’appel MCP est gratuit. Comme dans le tableau de bord, chaque page auditée consomme 5 crédits : le solde est vérifié à l’acceptation, chaque page réserve ses crédits au démarrage de son audit et les consomme à l’enregistrement des résultats. `creditsReserved` est un budget, pas une réservation immédiate ni le montant final consommé. Chaque exécution exige un jeton de confirmation, lié aux pages exactes de l’aperçu.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | Identifiant du workspace |
| `pageIds` | string\[] | Non | Jusqu’à 50 identifiants de pages suivies. Ne peut pas être combiné avec `all` |
| `all` | boolean | Non | Audite toutes les pages suivies. Ne peut pas être combiné avec `pageIds` |
| `dryRun` | boolean | Non | Aperçu des pages et des crédits sans démarrer |
| `confirmationToken` | string | Non | Jeton renvoyé par l’aperçu |

Les pages déjà en cours d’audit sont ignorées. Un audit de plus de 100 pages à auditer est renvoyé immédiatement avec ses pages `QUEUED` ; une tâche d’arrière-plan qui s’exécute toutes les cinq minutes les met en file. La mise en file est relancée dans les 24 heures qui suivent l’acceptation, avec 12 tentatives au plus, et les pages que la file n’a pas prises à ce terme échouent. Suivez ce même audit avec [`get_site_audit`](https://docs.qwairy.co/fr/mcp/tools/strategic#get_site_audit). Pour être averti par vos propres systèmes, abonnez-vous à [`site_audit.completed`](https://docs.qwairy.co/fr/developers/integration-webhooks/events#site_audit-completed) avec l’API REST.

Un solde insuffisant détecté avant l’acceptation empêche le démarrage de l’audit. Si le solde est épuisé après l’acceptation, un refus de crédits n’est renvoyé que lorsqu’aucune page n’a démarré et que l’appel a mis lui-même l’audit en file (100 pages à auditer ou moins) ; il contient `details.auditId`, consultez donc cet audit conservé. Dans tous les autres cas, l’audit est renvoyé : les pages qui n’ont pas pu démarrer échouent et les pages déjà démarrées continuent. Un audit accepté reste consultable si sa mise en file est interrompue et reprend automatiquement avec le même identifiant. `COMPLETED` signifie que toutes les pages ont un résultat final, échecs et pages ignorées compris ; vérifiez les compteurs. Un audit ultérieur ne peut pas modifier ces résultats.

### Exemple

```text theme={null}
Vous : Audite les deux pages que je viens d’ajouter.

Assistant : appelle start_site_audit avec
  {"brandId": "brand_01", "pageIds": ["page_01", "page_02"]}

Qwairy : renvoie un aperçu. Deux pages seraient auditées, pour 10 crédits. Il
renvoie un confirmationToken et ne démarre rien.

Vous : Confirme.

Assistant : répète l’appel avec le jeton, puis interroge get_site_audit jusqu’à
ce que l’audit soit COMPLETED.
```

## Voir aussi

* [Auditer des pages jusqu’à site\_audit.completed](https://docs.qwairy.co/fr/developers/guides/page-audit-site-diagnostics.md) pour le workflow REST.
* [Outils stratégiques](https://docs.qwairy.co/fr/mcp/tools/strategic.md) pour les outils de lecture du Centre d’actions et du Diagnostic du site.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.