update_task
Update an existing task's status, title, owner, notes, due date, or recurrence. Only specified fields are changed; marking a recurring task done creates its next occurrence.
Instructions
Update an existing task — its status, title, owner, notes, due date, or recurrence.
The companion to create_task and get_tasks: use this to mark a task done or
blocked, reschedule it, reassign it, or edit its details. Only the fields you
pass are changed; empty arguments leave the existing value untouched. Marking
a recurring task "done" automatically creates its next occurrence. Find a
task_id with get_tasks; use delete_task to remove a task entirely.
Args:
task_id: ID of the task to update (as shown by get_tasks). Required.
status: New status — "open", "done", or "blocked". Empty = unchanged.
title: New title. Empty = unchanged.
owner: New owner. Empty = unchanged.
notes: New notes/details. Empty = unchanged.
due_date: New due date in "YYYY-MM-DD" format. Empty = unchanged.
recurrence: New repeat — "daily", "weekly", "monthly", or "yearly".
Empty = unchanged; pass "none" to clear an existing recurrence.
Returns:
A confirmation listing the changed fields (and the next-occurrence id if a
recurring task was completed), or a note if the task_id was not found.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task_id | Yes | ||
| status | No | ||
| title | No | ||
| owner | No | ||
| notes | No | ||
| due_date | No | ||
| recurrence | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |