update_subtask
Partially update a subtask to mark it complete, rename it, or change its assignee. Only send the fields you want to change; omitted fields remain unchanged.
Instructions
Partial update of an existing subtask. Returns the updated Subtask.
Only kwargs the caller passes are sent — None means omit, not
clear. Use this to mark complete (is_completed=True), rename
(name="..."), or change the assignee (assigned_user_id=42).
The position field is read-only on this endpoint; use
reorder_subtasks to change ordering.
Common 422 (KanbanToolValidationError with parsed field_errors):
assigned_user_id not a collaborator on the parent task's board —
use list_board_collaborators(board_id) to confirm before retrying.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| subtask_id | Yes | ||
| name | No | ||
| is_completed | No | ||
| assigned_user_id | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| name | Yes | ||
| is_completed | No | ||
| position | No | ||
| task_id | No | ||
| assigned_user_id | No | ||
| deleted_at | No |