update_task
Update a task's title, description, status, assignees, and other fields in a workspace to keep project management accurate.
Instructions
Update a task
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| Space | No | Optional sub-space ID for further scoping inside the workspace. | |
| extra | No | ||
| order | No | Pass to reposition the task inside its status. | |
| title | No | ||
| status | No | Move task to a new status (on the same or different board). | |
| task_id | Yes | Task UUID or slug. | |
| complete | No | Marking a task complete is rejected if the task has incomplete blockers or a running timer. | |
| due_date | No | ||
| priority | No | ||
| tags_add | No | Composite field — tag names to add. Toolkit calls POST /tasks/{id}/tags/ with {"add": [...]} after the PATCH. | |
| start_date | No | ||
| description | No | Plain text task description. This is the field agents and CLI users should set. The toolkit converts it to a Quill Delta and writes `rich_description` automatically. | |
| tags_remove | No | Composite field — tag names to remove. Toolkit calls POST /tasks/{id}/tags/ with {"remove": [...]} after the PATCH. | |
| Organization | No | Workspace (organization) ID the request is scoped to. | |
| assignees_add | No | Integer user IDs to add as assignees (get from listWorkspaceMembers). Toolkit calls POST /tasks/{id}/assignees/ with {"add": [...]} after the PATCH. | |
| custom_fields | No | ||
| estimated_hours | No | ||
| assignees_remove | No | Integer user IDs to remove from assignees (get from listWorkspaceMembers). Toolkit calls POST /tasks/{id}/assignees/ with {"remove": [...]} after the PATCH. | |
| rich_description | No | INTERNAL — Quill Delta representation. Set automatically by the toolkit when you pass `description`. Do not pass directly unless you have a pre-built Delta and know what you're doing. |