task_update
Destructive
Edits a task or bug (shared team data); only the passed fields change: title, spec, gist, result, priority, labels, placement (featureID or featureKey, featureID null removes it from the feature; versionID; productID), work iteration, bug fields (build, bugType, stage, browser, devices, fuzzy), type within its kind, modules and components (full new lists), stage assignees and ord. Stage assignees: employee uuid, "any" (any employee) or null (no such stage; the work stage always exists). Status is not changed here; returns link, status, specRevision and changed.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "task_update"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ID | No | Task ID; preferred over key. | |
| key | No | Task number, if the ID is unknown. | |
| ord | No | Position in lists, as drag-and-drop in the web UI; tasks go by ord descending (a feature's tasks follow its plan top down): a value between two neighbours' ord goes between them, above the largest - on top, 0 - last. When neighbours are under 100 apart, the feature's tasks, closed included, are renumbered top down from Date.now() in steps of -10000. | |
| gist | No | Gist: one or two plain-text sentences "problem → solution", up to 300 characters, without Markdown, links or task keys, in the language of the workspace data; an empty string clears it. | |
| spec | No | New spec (requirements): Markdown in the language of the workspace data, HTML is rejected. Replaces the whole field - text, `::: doc` sections and `attach:`, `design:`, `color:` tokens left out are removed. | |
| type | No | New type: the work type for a task, the criticality for a bug; a task does not become a bug or back. | |
| build | No | Build where the defect was reproduced (bugs only). | |
| fuzzy | No | Intermittent bug: does not reproduce every time (bugs only). | |
| stage | No | Stand where the bug was reproduced: dev - development and autotests, alpha - manual QA, prod - production data. | |
| title | No | New name | |
| labels | No | Labels; an empty array removes all. | |
| result | No | Report on the work done: Markdown in the language of the workspace data, HTML is rejected; replaces the whole field, like spec. | |
| browser | No | Browser where the bug was reproduced (bugs only). | |
| bugType | No | Defect nature (bugs only): ui - interface, fn - functionality, ux - usability, spec - documentation; not the severity, which is type. | |
| devices | No | IDs of devices from the company's QA devices where the bug was reproduced; an unknown ID is rejected. Bugs only; full new list, [] clears it. | |
| priority | No | Priority; a human decision, set only at the user's explicit request. | |
| featureID | No | Feature to move the task to; null removes it from its feature. | |
| moduleIDs | No | Full new list of module IDs, replacing the current one; [] removes all. | |
| productID | No | Product to move the task to; it lands in the product's current development version. | |
| specPatch | No | Part of the spec, ops in order: replace / insertBefore / insertAfter / delete a section by heading ("## Chat"; text - whole section), append, find an exact unique fragment → replace. With expectedSpecRevision. | |
| versionID | No | Version to move the task to when no feature fits. | |
| featureKey | No | Key of the feature to move the task to (#F12), instead of featureID. | |
| resultPatch | No | Like specPatch, for result except QA notes; apart from spec. | |
| componentIDs | No | Full new list of the actually affected component IDs, replacing the current one; [] removes all, adding means the current ones plus new. | |
| designUnlink | No | true lets a spec / result write drop design markers (designs left unlinked are deleted); otherwise it is rejected. | |
| testAssignee | No | Tester; a bug always keeps its testing stage, null is rejected. | |
| workAssignee | No | Assignee. | |
| workTimePlan | No | Planned work time in minutes, per the assignee's role level | |
| reviewAssignee | No | Reviewer. | |
| approvalAssignee | No | Approver. | |
| workIterationDate | No | A date within the work iteration, YYYY-MM-DD; moves the work to that iteration. | |
| expectedSpecRevision | No | The task's current specRevision; required when spec or specPatch changes. A spec with a revision goes in a separate request, with only gist and designUnlink alongside. |