update-task-status-tool

Sets a task's status. The is_finished flag is auto-synced — moving to finished sets it to true, and moving away from finished clears it back to false.

See also: update-task-tool when you also need to change the description, due date, assignee or other fields. This tool is the narrow status-only fast path.

Inputs

Name	Type	Required	Description
`id`	integer	yes	Task id.
`status`	string	yes	One of `on-hold`, `new`, `active`, `internal-test`, `external-test`, `finished`.

Permissions

Moving your own task: kanban::manage_self or kanban::manage_for_others.
Moving someone else's task: kanban::manage_for_others.

Example

{
  "id": 21,
  "status": "external-test"
}

Response

The updated task, in the same shape as a row from list-tasks-tool.

Errors

An invalid status value returns a validation error.
Moving a task you don't own without kanban::manage_for_others returns an authorization error.
A non-existent id returns a 404-style error.