update_task
Change a task's slug, title, goal or notes, by task_id or task_slug.
writesidempotentMCP toolTask
Fields left unset keep their values. The task's writer takes a new slug as its name. Changing the notes needs the notes_updated_at they were read with, and fails with failed_precondition when they changed since. Agents see the change the next time they read the task.
Calling it#
curl -X POST http://127.0.0.1:8787/komrad.task.v1.TaskService/UpdateTask \
-H 'Content-Type: application/json' \
-d '{
"task_id": "<task_id>"
}'komrad rpc update-task \
--task-id '<uuid>'{
"name": "update_task",
"arguments": {
"task_id": "<task_id>"
}
}Offered by the komrad MCP server to orchestrator agents.
Request#
UpdateTaskRequest#
| Field | Type | Description |
|---|---|---|
| one of* | The task to update. | |
task_id | uuid | The task, by id. |
task_slug | string not empty | The task, by slug. |
slug | string not empty at most 80 characters matching ^[a-z0-9]+(-[a-z0-9]+)*$ | The new slug. No other task may have used it. Unchanged when unset. |
title | string not empty at most 200 characters must not contain control characters | The new title. Unchanged when unset. |
goal | string at most 50000 characters | The new goal, in markdown. Unchanged when unset. |
notes | string at most 100000 characters | The new notes in full, in markdown. Unchanged when unset. |
notes_updated_at | timestamp | The |
Response#
UpdateTaskResponse#
Types#
Task#
Task is one piece of work that agents do.
| Field | Type | Description |
|---|---|---|
id | uuid* | The task's id. |
workflow_id | uuid* | The id of the workflow the task belongs to. |
slug | string | The task's slug, such as |
title | string | The task's title. |
goal | string | What the task is meant to achieve, in markdown. |
created_at | timestamp | When the task was created. |
updated_at | timestamp | When the task last changed. |
archived_at | timestamp | When the task was archived. Unset while the task is live. |
cwd | string | The directory of the task's checkout. Unset while the task has no checkout. |
branch | string | The git branch of the task's checkout. Unset when the task has no checkout or git cannot read the branch. |
repository_url | string | The canonical web address of the repository the task's checkout pushes to, such as |
head_sha | string | The commit checked out in the task's checkout. Unset when the checkout is gone or git cannot read it. |
worktree_removal_reason | WorktreeRemovalReason | Why the task's worktree is no longer on disk. Unspecified while it is. |
sequence | Sequence | The git operation stopped part way in the task's checkout. |
moved_since_snapshot | string | The commit of the task's newest snapshot, set while the checkout has changed since that snapshot. Empty otherwise. |
diff_stat | DiffStat | How many lines the task's checkout adds and removes since it left the base branch. Unset when there is no base branch to measure against. |
adopted_branch | string | The existing branch the task was put on. Unset when komrad created the branch. |
failure_reason | string | Why the task's last delete failed to remove its checkout. Empty unless a delete failed. |
notes | string | The task's notes, in markdown, written by its agents and the person. |
notes_updated_at | timestamp | When the task's notes were last written, or when the task was created if they never were. |
parent | Parent | The task this task depends on. Unset for a task on the workflow's base branch. |
snapshots | int32 | How many snapshots komrad has taken of the task's checkout. |
guides | int32 | How many guides agents have written for the task. |
DiffStat#
DiffStat counts the lines a checkout adds and removes, committed or not.
Parent#
Parent is the task a child depends on, and the fork point where the child's own commits begin on the parent's branch. Snapshots and line counts measure from fork_point.
| Field | Type | Description |
|---|---|---|
task_id | uuid* | The id of the parent task. |
fork_point | string | The commit of the parent's branch the child's own commits sit on. |
pull_request_id | uuid | The id of the parent's pull request, which komrad reads for the parent's newest commit and its merge. Empty until the parent has one. |
blocked | CascadeBlock | Why the cascade cannot rebase the child onto its parent. |
WorktreeRemovalReason#
WorktreeRemovalReason is why a task's worktree is no longer on disk.
Sequence#
Sequence is a git operation stopped part way in a task's checkout.
| Value | Description |
|---|---|
none | No git operation is stopped part way. |
rebase | A rebase stopped on a commit it could not replay. |
am | A |
merge | A merge stopped on conflicts. |
cherry_pick | A cherry-pick stopped on conflicts or paused between commits. |
revert | A revert stopped on conflicts or paused between commits. |
CascadeBlock#
CascadeBlock is why the cascade cannot rebase a child onto its parent.
| Value | Description |
|---|---|
conflicted | Rebasing the child's own commits onto its parent stopped on conflicts. |
orphaned | The child is orphaned: its branch holds neither its fork point nor any of its parent's own commits. |
parent_closed | The parent's pull request closed without merging. |