update-task-tool

Update any editable field on a task. Use update-task-status-tool for status-only changes.

Updates the whitelisted fields below on a task. The model keeps status and is_finished in sync — moving to finished flips is_finished to true, and moving away from finished flips it back. Reassigning to another user requires kanban::manage_for_others.

See also: update-task-status-tool when you only need to change the kanban column.

Inputs

Name	Type	Required	Description
`id`	integer	yes	Task id.
`due_date`	string (`Y-m-d`)	no	Due date.
`minutes`	integer	no	Estimated effort in minutes, ≥0.
`description`	string	no	Short description (max 255).
`comment`	string \| null	no	Longer comment, or null to clear.
`user_id`	integer \| null	no	Assignee user id, or null to unassign.
`team_id`	integer \| null	no	Team id, or null to clear.
`status`	string	no	One of `on-hold`, `new`, `active`, `internal-test`, `external-test`, `finished`.
`is_finished`	boolean	no	Auto-synced with `status`.
`is_billable`	boolean	no	Billable flag.

Permissions

Updating your own task: kanban::manage_self or kanban::manage_for_others.
Updating someone else's task: kanban::manage_for_others.
Reassigning a task to another user (or unassigning it): kanban::manage_for_others, even when the caller already passes the policy gate.

Example

{
  "id": 21,
  "task": "2026-06-08",
  "minutes": 600
}

Response

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

Errors

An invalid status value returns a validation error.
A non-existent id, user_id or team_id returns an error.
Updating a task you don't own without kanban::manage_for_others returns an authorization error.
Reassigning to another user without kanban::manage_for_others returns an authorization error.