Skip to main content
PATCH
Update an action status
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.
string
required
Bearer token for your team.
string
required
The action version returned by List actions, quoted. Use * to write unconditionally.
string
required
Workspace identifier. The workspace must belong to the token’s team.
string
required
Action identifier returned by List actions.
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 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.

Errors

See Error codes 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.