backlog_update
Update an existing task's status, title, parent, or schedule. Supports blocking reasons, completion evidence, and cron configuration.
Instructions
Update an existing item. For editing the markdown body, use write_resource with str_replace.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Task ID to update | |
| title | No | New title | |
| status | No | New status | |
| epic_id | No | Parent epic ID (null to unlink) | |
| parent_id | No | Parent ID (null to unlink). Takes precedence over epic_id. | |
| blocked_reason | No | Reason if status is blocked | |
| evidence | No | Proof of completion when marking done - links to PRs, docs, or notes | |
| references | No | Reference links. Formats: external URLs (https://...), task refs (mcp://backlog/tasks/TASK-XXXX.md), resources (mcp://backlog/resources/{path}). Local files must include extension (file:///path/to/file.md) | |
| due_date | No | Due date for milestones (ISO 8601). Null to clear. | |
| content_type | No | Content type for artifacts (e.g. text/markdown). Null to clear. | |
| schedule | No | Cron expression (5 fields). Validated on write. Only permitted on cron entities. | |
| command | No | Command string for external scheduler. Only permitted on cron entities. | |
| enabled | No | Whether the external scheduler should tick this cron. Separate from status. Only permitted on cron entities. | |
| last_run | No | ISO-8601 timestamp of most recent scheduler tick. Typically written by the scheduler. Null to clear (e.g. scheduler reset). | |
| next_run | No | ISO-8601 timestamp of next scheduled tick. Typically written by the scheduler. Null to clear. |