Modify Task
task_modifyUpdate one or multiple tasks by filter criteria. Modify descriptions, projects, priorities, dates, tags, dependencies, or assignments using partial updates—only specified fields change while existing values remain untouched.
Instructions
Update one or more tasks matching a filter. Only provided fields are changed — omitted fields are left untouched (partial update). The filter can match multiple tasks; all matches are updated with the same changes. Returns the count of modified tasks. Use task_done/task_delete/task_start/task_stop for status changes instead.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| filter | Yes | Filter to select tasks. Can be a numeric ID ('1'), UUID, or filter expression ('project:backend priority:H'). Matches may update multiple tasks. | |
| description | No | New description text (max 500 chars). Only set if you want to change it. | |
| project | No | New project name. Pass empty string to clear. | |
| tags | No | Tags to add (+) or remove (-). E.g. '+frontend,+urgent' or '-old,+new'. Prefix with + to add, - to remove. Without prefix, tags are added. | |
| priority | No | New priority. Pass empty string to clear priority entirely. | |
| due | No | New due date. Accepts ISO dates, relative ('3d'), named ('friday', 'eow'). Pass empty string to clear. | |
| depends | No | New dependency UUIDs (comma-separated). Replaces existing dependencies. Pass empty string to clear. | |
| wait | No | New wait date. Task hidden from default views until this date. Pass empty string to clear. | |
| scheduled | No | New scheduled start date. Pass empty string to clear. | |
| recur | No | New recurrence pattern ('daily', 'weekly', '3d', etc). Pass empty string to clear. | |
| until | No | End date for recurrence. Pass empty string to clear. | |
| agent | No | Agent identity. Pass empty string to unassign. | |
| extra | No | Space-separated additional attributes or +tag/-tag modifiers. |