Update a task
update_taskChange ONE existing task by id (from get_tasks): time, date, title, duration, done, repeat, steps, checklist, priority, alert type and more. Only the fields you send change. Use it to move, rename or tick off a task; use delete_task to remove it and update_routine for a routine. On a repeating task, hour/min/date move EVERY day; occurrence_date moves one day and done_date ticks one day. subTasks and checklist REPLACE the whole list (send every item). Returns {id, updated, ...}; ok:false or an error such as not_found means nothing was saved. Preview rule: if this is the second task or routine change within about 90 seconds, nothing is saved and the result is needs_preview with the pending and saved changes - show them to the user and call again with confirm:true only after they agree.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>"
},
"name": "update_task"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The task id from get_tasks, e.g. "aB3dE9". A repeating task's projected id (<id>_recur_YYYYMMDD) also works. | |
| min | No | New start minute, 0-59 (default 0 when hour is sent). | |
| date | No | Move the task to this date, YYYY-MM-DD. On a repeating task this moves the whole series; for one day use occurrence_date. | |
| done | No | Mark the task done (true) or not done (false). On a REPEATING task this is ONE day: the projected id's day (<id>_recur_YYYYMMDD), else today - pass done_date for another day, never `date`. | |
| hour | No | New start hour, 0-23 local time (send min too; default 0). | |
| title | No | New title. | |
| allDay | No | Make it an all-day event (true) or a timed task (false). | |
| repeat | No | Change how the task repeats. Once->recurring keeps its current date as the series origin; recurring->Once keeps past per-day completions but stops future occurrences. Edits IN PLACE - never delete+recreate. One of: Once | Daily | Weekly | Monthly | Yearly. | |
| anytime | No | Flexible anytime task (true) vs fixed-time (false). | |
| confirm | No | Set true ONLY after the user has seen and approved this change in a preview you showed them (needed when a request changes more than one task or routine). Never set it on your own. Default false. | |
| context | No | Change the task type/context tag. One of: calls | commute | errands | deep. | |
| category | No | New category label, e.g. Work or Health. | |
| priority | No | Priority: 4 Very High, 3 High, 2 Medium, 1 Low; 0 clears it. Only when the user re-prioritizes. | |
| subTasks | No | REPLACE the task's steps with this COMPLETE ordered list (read the current steps with get_tasks first and send the whole edited list, unchanged steps included). An EMPTY array removes all steps. A step that keeps its name keeps its done tick. On a REPEATING task the steps change for EVERY day. | |
| checklist | No | The task's "Bring / prep" checklist - things to bring or have ready ("bring the contract to my meeting with Ash"). REPLACES the list with this COMPLETE list: read it with get_tasks first and send every item, unchanged ones included. An item that keeps its text keeps its tick. An EMPTY array removes the list. Never put these items in the description or the steps. | |
| day_times | No | A STANDING per-weekday time: set a DIFFERENT start time on some weekdays of a REPEATING task, EVERY week from now on ("Tuesdays at 5:15, other days 7:30"). List only the days that differ from its usual time; REPLACES any earlier per-day times. Pass an EMPTY array [] to go back to one time every day. NEVER for one date ("just for today", "only this Saturday", "just this once", "back to normal tomorrow"): weekday 6 moves EVERY Saturday. For one day use occurrence_date. | |
| done_date | No | YYYY-MM-DD: the DAY a done / not-done is for on a REPEATING task ("I did yesterday's workout" -> yesterday). Defaults to the projected id's day, else today. Must be a day the task happens on, never in the future. NEVER pass `date` for this - on a repeating task `date` moves the whole series. | |
| alert_type | No | Change how the reminder fires: "alarm" | "push" | "default" (clear the override). | |
| daysOfWeek | No | Set SPECIFIC weekdays (1=Monday..7=Sunday) the task repeats on, e.g. [1,2,3,4,5] for weekdays only. Pass an EMPTY array [] to CLEAR back to the plain cadence. Only meaningful on a recurring task (repeat is coerced to Weekly when needed). | |
| description | No | Set or replace the task detail (a number, an address, a reference, a note). Pass an EMPTY string to clear it. It REPLACES what is there - to add to an existing note, read the task first and send the combined text. | |
| durationMin | No | New length in minutes, e.g. 45. | |
| in_progress | No | true when the user says they are STARTING / doing this task NOW. Records the start; never re-times the task - do not pass hour/min with it. | |
| contact_name | No | Set/replace who a CALL task is to. | |
| delegated_to | No | The NAME of the person who covers this task instead of the user ("my wife will do the pickup" -> "Wife"); "" = the user does it again. A delegated task never counts as an overlap and gets no start reminder. "Assindo" is the built-in delegate - the user's AI phone assistant app: it makes the phone call or posts to social media for this task. Use delegated_to "Assindo" only when the user asks Assindo to do it; Habidu sends it the task when it is saved (it needs Assindo connected in Settings - Connected apps). | |
| restore_date | No | YYYY-MM-DD: bring back ONE skipped day of a REPEATING task (a day get_tasks lists under `skipped`). Takes that day off the task's excluded days; nothing else changes. Only when the user wants it back on that day. | |
| alarm_mission | No | A MISSION that must be done before this ALARM stops ringing (Android and iPhone): "math" = solve math problems, "shake" = shake the phone, "steps" = walk a number of steps, "qr" = scan a QR code / barcode the user registered in Settings > Reminders & alarms > Mission codes. "none" removes it. Setting a mission makes the task an alarm. Set it ONLY when the user explicitly asks ("make me solve math to turn it off", "an alarm I have to shake to stop", "make me walk 200 steps"). Never unprompted. | |
| contact_phone | No | Set/replace the phone number for a CALL task, as the user gave it — NEVER invent one. | |
| checklist_date | No | YYYY-MM-DD: the DAY a checklist_tick / checklist_untick is for on a REPEATING task ("packed the gym bag for tomorrow" -> tomorrow's date). Defaults to today. NEVER pass `date` for this - on a repeating task `date` moves the whole series. | |
| checklist_tick | No | Item TEXTS (from get_tasks checklist) the user says they have ready / packed - ticks them. On a repeating task only the asked day. | |
| delegated_date | No | YYYY-MM-DD: the day a one-day delegation is for (default: the occurrence id's day, else today). | |
| delegated_scope | No | With delegated_to on a REPEATING task: "occurrence" (the default) hands over ONE day only ("Mom takes the kids today"); "series" = every day, ONLY when the user says always / every time / from now on. | |
| occurrence_date | No | YYYY-MM-DD: move ONLY this one day of a REPEATING task or routine ("just for today", "tonight only", "only this Saturday", "back to normal tomorrow"). Send it with the new hour/min (and durationMin if the length changes): that day becomes its own one-off at the new time and the usual time is skipped that day; every other day keeps its time. One call per task. Never day_times or `date` for a one-day move. | |
| checklist_untick | No | Item TEXTS to untick again (the user does not have them after all). | |
| alarm_mission_count | No | How many problems (math, 1-10, default 3), shakes (shake, 10-100, default 30) or steps (steps, 20-1000, default 100). Only with alarm_mission. | |
| alarm_mission_level | No | Math difficulty: easy | medium (default) | hard. Only with alarm_mission "math". |