update_task
Modify task properties, relationships, and status by dart_id. Use add_to/remove_from for incremental relationship updates and add an optional comment.
Instructions
Update a task. Pass dart_id and any fields to change at the top level. Supports add_to/remove_from for incremental relationship changes and optional comment. Relationship arrays use full replacement unless using add_to/remove_from.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dart_id | Yes | Task dart_id (also accepts "id" or "task_id") | |
| title | No | Task title (max 500 chars) | |
| description | No | Task description (markdown supported) | |
| dartboard | No | Dartboard dart_id or name | |
| status | No | Status dart_id or name | |
| priority | No | Priority 1-5 | |
| size | No | Size estimate 1-5 | |
| assignees | No | Array of assignee dart_ids, names, or emails | |
| tags | No | Array of tag dart_ids or names | |
| due_at | No | Due date (ISO8601) | |
| start_at | No | Start date (ISO8601) | |
| parent_task | No | Parent task dart_id | |
| subtask_ids | No | IDs of subtask (child) tasks. Full replacement: set to [] to clear. | |
| blocker_ids | No | IDs of tasks that block this task. Full replacement: set to [] to clear. | |
| blocking_ids | No | IDs of tasks this task blocks. Full replacement: set to [] to clear. | |
| duplicate_ids | No | IDs of duplicate tasks. Full replacement: set to [] to clear. | |
| related_ids | No | IDs of related tasks. Full replacement: set to [] to clear. | |
| comment | No | Optional comment to add after updating (non-blocking) | |
| add_to | No | Append IDs to relationship arrays. Fetches current values, merges, deduplicates. Keys: subtask_ids, blocker_ids, blocking_ids, duplicate_ids, related_ids | |
| remove_from | No | Remove IDs from relationship arrays. Fetches current values, filters out specified IDs. Keys: subtask_ids, blocker_ids, blocking_ids, duplicate_ids, related_ids |