ticktick_delete_tasks
Delete one or more tasks by their IDs. Supports removal of completed tasks when the project ID is provided.
Instructions
Delete one or more tasks.
Args:
task_ids (str | list[str]): A single task ID, or a list of IDs.
An empty list returns an error.
project_id (str, optional): Used to construct a minimal delete
payload when get_by_id cannot find the task locally
(typical for completed tasks).
Returns:
{"status": "success", "deleted_count": N, "tasks_deleted_ids":
[...]} on success. Tasks that could not be matched at all are
returned as status="not_found" with missing_ids /
invalid_ids arrays. Partial success surfaces warnings.
Empty input: {"status": "error", "message": "No task IDs..."}.
Agent Usage Guide:
- For tasks already completed in TickTick, supply project_id
-- get_by_id does not see completed tasks.
Example: ticktick_delete_tasks( task_ids=["abc123", "def456"], project_id="", )
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task_ids | Yes | ||
| project_id | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |