Manage Task Checklist
checklistChange the checklist on a task. action: "add" appends items, unchecked, after the existing ones: pass every title for a multi-item list in one call (titles keeps the given order, while parallel single adds land in arrival order). action: "edit" renames an item and/or checks it (completed: true) or unchecks it (completed: false). action: "remove" deletes one. Read the list, with each item's id and state, from task_show.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| item | No | Checklist item UUID or prefix (>= 4 chars). Required to edit or remove | |
| task | Yes | Workspace-scoped task number, encoded as a string | |
| title | No | One item title to add, or the new title on an edit | |
| action | Yes | What to do to the checklist | |
| titles | No | Several item titles to add, kept in the given order (use instead of `title`) | |
| context | Yes | Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): "Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization." | |
| completed | No | Check (true) or uncheck (false) the item, on an edit | |
| workspace | No | Workspace id, slug, or name | |
| idempotency_key | No | Stable key that makes retries safe: repeated calls with the same key create only one record and return the same id. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| count | Yes | ||
| items | Yes | The items the call created or changed | |
| action | Yes | ||
| taskId | Yes |