update_tasks
Update multiple OmniFocus tasks simultaneously with uniform field changes like status, flags, dates, tags, or project assignments using batch operations.
Instructions
Update multiple tasks with the same field values (batch operation - NEW API).
This is the batch version of update_task(). It applies uniform changes to multiple tasks simultaneously.
Key differences from update_task():
Accepts Union[str, list[str]] for task_ids (single or multiple)
Does NOT accept task_name or note (require unique values per task)
Returns count-based summary instead of single success/failure
Continues processing when individual tasks fail
Args: task_ids: Single task ID (str) or list of task IDs to update flagged: Flag/unflag all tasks (optional) status: Set status for all tasks - "active" or "dropped" (optional) completed: Mark all tasks complete/incomplete (optional) project_id: Move all tasks to this project (optional). Mutually exclusive with parent_task_id — a subtask inherits its parent's project. parent_task_id: Make all tasks subtasks of this parent (optional). Mutually exclusive with project_id — a subtask inherits its parent's project. tags: Full replacement - set exact tag list for all tasks (optional, conflicts with add_tags) add_tags: Add these tags to all tasks (optional, conflicts with tags) remove_tags: Remove these tags from all tasks (optional) due_date: Set due date for all tasks in ISO 8601 format, or empty string to clear. Omitting means no change. (optional) defer_date: Set defer date for all tasks in ISO 8601 format, or empty string to clear. Omitting means no change. (optional) estimated_minutes: Set estimated time in minutes for all tasks (optional)
Returns: Summary message with counts of successful/failed updates
Examples: update_tasks(["task-001", "task-002"], flagged=True) # Flag multiple tasks update_tasks("task-123", completed=True) # Complete single task (Union type) update_tasks(["task-001", "task-002", "task-003"], status="dropped") # Drop multiple
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task_ids | Yes | ||
| flagged | No | ||
| status | No | ||
| completed | No | ||
| project_id | No | ||
| parent_task_id | No | ||
| tags | No | ||
| add_tags | No | ||
| remove_tags | No | ||
| due_date | No | ||
| defer_date | No | ||
| estimated_minutes | No |