ticktick_update_task
Update an existing TickTick task by providing only the fields to change; unmodified fields are preserved automatically.
Instructions
Update an existing task without wiping unmodified fields.
The TickTick API requires the entire editable task on every update;
any omitted field is wiped server-side. To prevent that we fetch the
current task, then overlay ONLY the fields the caller explicitly
set (exclude_unset=True).
Args:
task_object (TaskObject): Must include id. All other fields
are optional; set only the ones you want to change. When
dueDate is set you must also set expectedDayOfWeek.
Returns:
JSON object containing the updated task.
_verification_warnings is attached if the response did not
match what we sent.
On failure: {"error": "...", "status": "error"}.
Limitations:
- Read-only API fields (creator, etag, createdTime,
modifiedTime, deleted, kind, isFloating) are
stripped before the call.
Agent Usage Guide:
- To reschedule a task, send a single update with the new
dueDate + expectedDayOfWeek. Do NOT complete and
recreate.
Example: ticktick_update_task(task_object={ "id": "60ca9dbc8f08516d9dd56324", "projectId": "", "priority": 5, "dueDate": "2026-06-15T20:45:00+01:00", "expectedDayOfWeek": "Monday", "timeZone": "Europe/London", })
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task_object | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |