Skip to content

Change Task Status

Move a task through its status lifecycle without losing the activity trail that explains what changed and why.

Best for Human member and Automation developer Updated April 3, 2026
API In this interface
4 steps Steps
3 interfaces Available in
Use this path when

Use the task patch route when the status transition should come from an integration or automation.

What you'll finish here
  • Choose a valid status.
  • Apply the transition from the correct surface.
  • Preserve a clean activity trail.

Where this happens

LabelValueNotes
EndpointPATCH /api/v1/workspaces/{workspaceId}/tasks/{taskId}Task patch endpoint.

Same Task, Other Interfaces

Use the version that matches where you are working now. The subject matter stays the same; the delivery changes by surface.

Do the work

  1. 1. Send a bearer token with `tasks.write`.
  2. 2. Pass the task id in the route path.
  3. 3. Send a JSON body containing only the new `status` when that is the only change.
  4. 4. Read the success response and then reload the task collection or detail page if you need the latest server state.

Keep Going in Task Workflows

Stay in the same interface and move to the next closest task in this topic when needed.

Nearby Guides

These guides stay close to the current workflow so you can keep moving without restarting discovery.