Update an action status
curl --request PATCH \
--url https://www.qwairy.co/api/v1/brands/{brandId}/actions/{actionId} \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'If-Match: <if-match>' \
--data '
{
"status": "<string>"
}
'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/actions/{actionId}"
payload = { "status": "<string>" }
headers = {
"Authorization": "<authorization>",
"If-Match": "<if-match>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {
Authorization: '<authorization>',
'If-Match': '<if-match>',
'Content-Type': 'application/json'
},
body: JSON.stringify({status: '<string>'})
};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/actions/{actionId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Actions
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.
PATCH
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
actions
/
{actionId}
Update an action status
curl --request PATCH \
--url https://www.qwairy.co/api/v1/brands/{brandId}/actions/{actionId} \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'If-Match: <if-match>' \
--data '
{
"status": "<string>"
}
'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/actions/{actionId}"
payload = { "status": "<string>" }
headers = {
"Authorization": "<authorization>",
"If-Match": "<if-match>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {
Authorization: '<authorization>',
'If-Match': '<if-match>',
'Content-Type': 'application/json'
},
body: JSON.stringify({status: '<string>'})
};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/actions/{actionId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));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 for activation, idempotency, conditional requests and error handling.
See Error codes for authentication, plan, idempotency and server errors. A token without write access returns
The action
version returned by List actions,
quoted. Use * to write unconditionally.Action identifier returned by List actions.
Response
Returns200, the new ETag and the action, with the same fields as the
List actions items plus version. The
version is an opaque concurrency value: copy it unchanged.
Synthetic request and response
This example assumes the actionversion you last read is 2.
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"}'
{
"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 |
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.
