tasks_update
Update a task. Set status='done' to complete it, 'cancelled' to cancel. Reassign with assignee. Status and assignee changes are recorded in the task's comment thread.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | No | ||
| due_at | No | ISO datetime | |
| status | No | ||
| summary | No | Completion note (stored when marking done) | |
| tag_ids | No | Topics for the task: ids of workspace tags that apply to tasks (ai_tags.list with applies_to='task'). Replaces the current set; [] clears it. | |
| task_id | Yes | ID of the task to update | |
| agent_id | No | Act as this agent instead of as yourself. Optional. | |
| assignee | No | Who should do this: a workspace member (email, username, or user:<id> as workspace.members lists them), an AI agent (its name), or a contact (display name). Use 'me' for yourself. Call workspace.members to see who can be assigned. Where this listing offers assignee_user_id / assignee_agent_id / assigned_to_contact_id, they name an exact target instead. | |
| priority | No | ||
| description | No | ||
| repeat_unit | No | Unit for repeat_every. | |
| in_workspace | No | Run this one call in this workspace id instead of the session's. Nothing is stored; other sessions are not affected. | |
| repeat_every | No | Make the task repeat: completing it creates the next occurrence, due this many repeat_unit after the previous deadline. E.g. repeat_every=3, repeat_unit='month' for quarterly. Pass repeat_every=0 to stop repeating. | |
| clear_assignee | No | Unassign the task, returning it to the backlog | |
| target_session | No | Which desktop Claude session should run this, by the name shown in workspace.desktops. Only needed when the assignee is an AI agent that runs on a machine and more than one session is connected — otherwise the task is not dispatched at all, rather than sent to a machine you did not mean. | |
| assignee_user_id | No | ||
| assignee_agent_id | No | ||
| attachment_file_ids | No | Replace the task's attachments with these file IDs | |
| assigned_to_contact_id | No |