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

# Update an action status

> Move an Action Center recommendation to another status, such as In progress or Completed, using the action version from List actions in If-Match.

Moves an Action Center recommendation to another status. Sending the current
status again changes nothing and returns the unchanged action.

Requires an active Business, Agency Business or Enterprise plan, and an API token with write access enabled by an Owner or Manager. See [Writing data](https://docs.qwairy.co/developers/writing-data.md) for activation, idempotency, conditional requests and error handling.

**Authorization** `string` *required*

Bearer token for your team.

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

The action `version` returned by [List actions](https://docs.qwairy.co/developers/endpoints/actions/list.md),
quoted. Use `*` to write unconditionally.

**brandId** `string` *required*

Workspace identifier. The workspace must belong to the token's team.

**actionId** `string` *required*

Action identifier returned by [List actions](https://docs.qwairy.co/developers/endpoints/actions/list.md).

**status** `string` *required*

Target status: `SUGGESTED`, `PENDING`, `IN_PROGRESS`, `COMPLETED`,
`DISMISSED` or `RESOLVED`.

## Response

Returns `200`, the new `ETag` and the action, with the same fields as the
[List actions](https://docs.qwairy.co/developers/endpoints/actions/list.md) items plus `version`. The
`version` is an opaque concurrency value: copy it unchanged.

## Synthetic request and response

This example assumes the action `version` you last read is `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
}
```

## Errors

| Status | Code | Cause |
| - | - | - |
| `400` | `INVALID_REQUEST` | Missing or unknown `status` |
| `404` | `RESOURCE_NOT_FOUND` | The workspace or action is missing or inaccessible |
| `412` | `PRECONDITION_FAILED` | The action changed since your read |
| `428` | `PRECONDITION_REQUIRED` | `If-Match` is missing |

See [Error codes](https://docs.qwairy.co/developers/errors.md) for authentication, plan, idempotency and server errors. A token without write access returns `403 API_KEY_READ_ONLY`. On `429`, honor `Retry-After`. If the write limiter is unavailable or writes are suspended, the request returns `503 SERVICE_UNAVAILABLE` and nothing changes.


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