ticktick_update_task
Updates a TickTick task by overlaying only the fields you explicitly set, preserving all other existing data to prevent accidental erasure.
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 |