> ## 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 statut d’une action

> Faites passer une recommandation du Centre d’actions à un autre statut, comme En cours ou Terminée, avec la version de l’action dans If-Match.

Fait passer une recommandation du Centre d’actions à un autre statut. Renvoyer le statut actuel ne change rien et renvoie l’action inchangée.

Nécessite une offre Business, Agency Business ou Enterprise active, et un jeton d’API dont l’accès en écriture a été activé par un Propriétaire ou un Manager. Consultez [Écrire des données](https://docs.qwairy.co/fr/developers/writing-data.md) pour l’activation, l’idempotence, les requêtes conditionnelles et la gestion des erreurs.

**Authorization** `string` *required*

Jeton bearer de votre équipe.

**If-Match** `string` *required*

La `version` de l’action renvoyée par [Lister les actions](https://docs.qwairy.co/fr/developers/endpoints/actions/list.md), entre guillemets. Utilisez `*` pour écrire sans condition.

**brandId** `string` *required*

Identifiant du workspace. Le workspace doit appartenir à l’équipe du jeton.

**actionId** `string` *required*

Identifiant de l’action renvoyé par [Lister les actions](https://docs.qwairy.co/fr/developers/endpoints/actions/list.md).

**status** `string` *required*

Statut cible : `SUGGESTED`, `PENDING`, `IN_PROGRESS`, `COMPLETED`, `DISMISSED` ou `RESOLVED`.

## Réponse

Renvoie `200`, le nouvel `ETag` et l’action, avec les mêmes champs que les éléments de [Lister les actions](https://docs.qwairy.co/fr/developers/endpoints/actions/list.md) plus `version`. La `version` est une valeur de concurrence opaque : copiez-la telle quelle.

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

Cet exemple suppose que la `version` de l’action que vous avez lue en dernier est `2`.

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

```json theme={null}
{
  "id": "66666666-0000-4000-8000-000000000000",
  "type": "CONTENT_GAP",
  "category": "CONTENT",
  "sourceType": "QUESTION_GAP",
  "scope": "ON_SITE",
  "title": "Cover pricing questions on the pricing page",
  "description": "Stored answers raise pricing questions that this page does not address.",
  "sourceUrl": null,
  "targetProvider": null,
  "evidenceProviders": ["example-provider"],
  "evidenceScope": "OBSERVED",
  "forceTier": "HIGH",
  "priorityScore": 53,
  "demandBadge": 3,
  "isQuickWin": false,
  "effort": "MEDIUM",
  "status": "IN_PROGRESS",
  "signals": null,
  "impactJustification": null,
  "effortJustification": null,
  "baselineMetric": null,
  "targetMetric": null,
  "questionId": null,
  "checklist": [],
  "createdAt": "2026-10-01T09:00:00.000Z",
  "updatedAt": "2026-10-12T14:30:00.000Z",
  "version": 3
}
```

## Erreurs

| Statut | Code | Cause |
| - | - | - |
| `400` | `INVALID_REQUEST` | `status` absent ou inconnu |
| `404` | `RESOURCE_NOT_FOUND` | Le workspace ou l’action est absent ou inaccessible |
| `412` | `PRECONDITION_FAILED` | L’action 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. Un jeton sans accès en écriture renvoie `403 API_KEY_READ_ONLY`. Sur `429`, respectez `Retry-After`. Si le limiteur d’écriture est indisponible ou si les écritures sont suspendues, la requête renvoie `503 SERVICE_UNAVAILABLE` et rien ne change.


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