update_task
Update a task: title, day, time, reminders, size, subtasks. /doc/update (Full Access Token). Categories/projects: update_category_or_project; priority and frog: set_priority; completion: mark_done.
Instructions
Update a task: title, day, time, reminders, size, subtasks. /doc/update (Full Access Token). Categories/projects: update_category_or_project; priority and frog: set_priority; completion: mark_done. Changing the day does what the app does: reminderTime and the server entry T move to the new day, own reminders (M) stay and are listed in the response. New clock time: new T, own reminders (including 'X min before') keep their time. time='' removes the clock time in the app's form. If the day is removed (day='unassigned') the clock time and T are removed as in the app; own reminders stay. Subtasks are written with dotted keys. parent_id or subtasks on a recurring occurrence give a warning: the recurring task stays as it is, so future occurrences follow it — change it with update_recurring_task. Strategy-dependent fields are stored even when the strategy is off in the app. A sporadic 500 on /doc/update is transient (retried once); a permanent 500 = the document does not exist.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| day | No | Schedule on YYYY-MM-DD, 'today', or 'unassigned' to unschedule | |
| note | No | New note (replaces the existing one) | |
| size | No | Size XS/S/M/L/XL (taskSize 1-5), '' removes (false) | |
| time | No | Clock time HH:MM (requires a day). Writes the app's form: taskTime, title prefix 'HH:MM ', reminderTime and a server entry of type T — the app reminds at that time. '' removes the time (update_task) | |
| orbit | No | Orbit strategy: True = put in orbit (verified in the app 2026-08-29: shows in the Orbit view + orbit icon in Today). UNDOCUMENTED field (missing from the official data types) | |
| title | No | New title | |
| item_id | Yes | Task ID | |
| due_date | No | Deadline YYYY-MM-DD, or '' to remove | |
| end_date | No | Soft deadline YYYY-MM-DD (Start & End Dates strategy), '' removes | |
| label_ids | No | New labels (IDs from get_labels; replaces existing ones, [] removes all) | |
| parent_id | No | Move to category/project ID (not validated by the server — a wrong ID yields an orphan, live-tested 2026-08-29; repaired by running FIX_CYCLES() in the app's console) | |
| reminders | No | Own reminders: 'HH:MM' on the task's day, or 'before:N' = N minutes before the clock time. Stored as the reminders list + one server entry of type M per reminder; before values are saved as an absolute time, as in the app. Without a day, today applies. Replaces the list; [] removes all own reminders | |
| backburner | No | True = put in the backburner, False = take out. NOTE: only effective on an UNSCHEDULED task — set day='unassigned' at the same time; scheduling trumps the flag in the UI (verified in the app 2026-08-29) | |
| start_date | No | Start date YYYY-MM-DD, '' removes. Mechanics (verified in the app 2026-08-29): the Start Dates strategy hides BACKBURNER items until their start date — combine with backburner=true and day='unassigned'; a scheduled task is not affected | |
| review_date | No | Review date YYYY-MM-DD, '' removes. Verified in the app 2026-08-29: shows in the Review view on the date; the day-view banner additionally requires the Review Alert workflow snippet | |
| planned_week | No | Plan into a week: the week's Monday YYYY-MM-DD (Planning Ahead strategy; verified in the app 2026-08-29 — also shows in the month view), '' removes. The app's view: clearing propagates server-side, but with Planning Ahead on (2026-08-29) the task stayed in the month view even after switching views — ask the user to reload the client (F5 in the web app/PWA, restart of the desktop app) before a missing render is taken for an error | |
| subtasks_add | No | New subtasks (titles), added last | |
| bonus_section | No | 'Essential' or 'Bonus' (bonusStructure strategy), '' removes | |
| daily_section | No | Day section 'Morning'/'Afternoon'/'Evening' (dailyStructure strategy), '' removes | |
| no_auto_orbit | No | Orbit strategy: True = exempt the task from automatic orbiting (auto-orbit otherwise pulls in scheduled tasks). UNDOCUMENTED field (bool type verified in live data 2026-08-29) | |
| planned_month | No | Plan into a month: YYYY-MM (Planning Ahead strategy, verified in the app 2026-08-29), '' removes | |
| reward_points | No | Reward points the task AWARDS on completion (coin + points in the list row when the Rewards strategy is on, verified in the app 2026-08-29), 0 removes. Do not set together with isReward | |
| subtasks_done | No | Subtask ids to check off (ids from the task's subtasks) | |
| custom_section | No | ID of a custom section from strategySettings.customStructure, '' removes | |
| subtasks_rename | No | Subtask id → new title | |
| perma_snooze_time | No | Hide the task every day until HH:mm (permaSnoozeTime), '' removes. Verified in the app 2026-08-29 | |
| time_block_section | No | Time block ID (from get_today_time_blocks, or time_block_id from create_time_block), '' removes. Shows under the block's section in Today when Time Block Sections is on, the day view is grouped by time block (per device, not synced) and the task is scheduled on the block's day — see create_task | |
| snooze_until_unix_ms | No | Snooze the task until unix time in milliseconds (itemSnoozeTime), 0 removes. Verified in the app 2026-08-29: hides from Today AND the category view (the wiki's 'everywhere except the master list' does not hold for the category view) | |
| time_estimate_minutes | No | Time estimate in minutes, 0 removes it |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||