update_task
Update a task. Pass only the fields to change. Use this to mark a task done (status: 'done') or move it between epics. Descriptions are summaries. If the task has a detailed spec, create a document and link it with documentId. Work only on items assigned to the user unless told otherwise; see list_tasks assignee='me'. When setting status to 'blocked', include a blockedReason. Don't invent priority — leave it unset if unknown.
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": {
"taskId": "<taskId>"
},
"name": "update_task"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| size | No | ||
| type | No | ||
| title | No | ||
| epicId | No | Move to this epic, or null to make standalone | |
| labels | No | Replaces the full label set. Free-form tags, e.g. ['ui', 'auth'] | |
| status | No | ||
| taskId | Yes | ||
| assignee | No | "me", a person's name, the email shown for members without a name, or id, or null to unassign (inherits from the epic owner). | |
| priority | No | ||
| surfaces | No | Surface names or ids this task concerns. Replaces the full set; [] = inherit the epic's surfaces. | |
| documentId | No | Link a detail/spec document. Pass null to unlink. | |
| description | No | ||
| blockedReason | No | Why the task is blocked. Only used when status is 'blocked'. |