Move a task through its statuses

An ordinary task has six statuses. Knowing which moves are legal is what stops a task list from drifting into fiction, because the platform refuses the rest.

The six statuses

Status	Means
backlog	Written down, not on the plate yet. A starting state only
open	Ready to be picked up. What a new task starts at
in progress	Being worked, usually by a run
blocked	Cannot proceed until something else changes
done	Finished and accepted
cancelled	Deliberately not doing it

The moves the platform allows

stateDiagram-v2
  [*] --> backlog
  [*] --> open
  backlog --> open
  backlog --> cancelled
  open --> in_progress
  open --> blocked
  open --> done
  open --> cancelled
  in_progress --> blocked
  in_progress --> done
  in_progress --> cancelled
  blocked --> open
  blocked --> in_progress
  blocked --> cancelled
  done --> open : reopen
  cancelled --> open : reopen

Legal task transitions. Done and cancelled are terminal unless the task is reopened.

Three consequences worth knowing:

• Nothing returns to backlog. It is a starting state, so once work is open it stays open, moves on, or is cancelled.
• Blocked is not a dead end. It goes back to open or straight to in progress once the blocker clears.
• Done and cancelled are terminal. They change only by reopening, which is its own action rather than an ordinary move.

Change a status

1. Open the task and select the status badge in the header.

2. Pick the new status. It saves at once, and the badge and banner update with it.

3. A move the lifecycle does not allow (backwards from done, say) comes back as an error and nothing changes.

The task list can do the same thing in bulk: select rows, then Change status in the bar that appears. Cancel selected is the same action pointed at cancelled.

Read the statuses in bulk

The task list is where a whole project’s statuses are legible at once. Filters narrows it: by Project, by assignee, by owner, or by type. The segments above it (Needs me, Live, Overdue, Mine, All) slice the same list by relevance, and every column header sorts.

Reading down the Status column is the fastest way to spot the two problems this page is about: work that has been in progress too long, and work that is blocked with nobody looking at it.

Unblock a stuck task

blocked means the task is waiting on something. The workspace banner names what:

• Waiting on other tasks. The banner counts them. Finish or cancel those, then move this one back to open or in progress.
• A failed run. The banner offers Diagnose, which opens the Execution tab where the last attempt and its error are. Fix the cause (a missing credential, a repository the agent cannot reach, a spec that was wrong), then set the task back to in progress to let it run again.
• Waiting on you. If the run paused for an approval, it is not blocked at all: the banner says the agent is paused, and Approve or Reject moves it.

Blocked is a real answer

Marking a task blocked and writing why in the Activity tab is better than leaving it in progress. Blocked tasks are counted on the cockpit’s Tasks tile, so they stay visible rather than looking like work in flight.

Reopen finished work

A task that turned out not to be done reopens to open, carrying its history, its runs, and its comments with it. Reopening is deliberate and separate from an ordinary move, so a finished task cannot be quietly walked backwards.

Specialized types do not use these statuses

Content, verification, approval, feedback, and scheduled-trigger tasks each replace the six statuses with a lifecycle of their own, and their transitions are enforced the same way. See task types for the map, and the guides for content, verification, approvals, and scheduled triggers.

Next steps

• Work in the Task Workspace: where every status change happens.
• Break work into subtasks and milestones: splitting a task that keeps getting blocked.
• Runs and attempts: what in progress usually means.