update_task
Transition task status to done, blocked, cancelled, or pending, enforcing role-based permissions and revision checks to keep collaborative plans accurate.
Instructions
Finish, block, cancel, or recover a task.
Claim owners may set done/blocked/cancelled on in_progress tasks. Roles with recover_task permission may set pending on blocked tasks. The Plan state is authoritative. Its corresponding audit Event is placed in the Plan Outbox and is retried idempotently if Event persistence fails.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"task_id": "<task_id>",
"actor_id": "<actor_id>",
"role": "<role>",
"status": "<status>",
"expected_revision": "<expected_revision>"
},
"name": "update_task"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role | Yes | ||
| status | Yes | ||
| plan_id | No | project | |
| task_id | Yes | ||
| actor_id | Yes | ||
| expected_revision | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||