update_task
Update specific fields of a Kanban Tool task—name, priority, due date, assignee, or tags—without altering other fields. Only provided values are sent; null fields are omitted.
Instructions
Partially update a task's fields. Only the kwargs you pass are sent;
None means omit, not clear (the API ignores nulls, doesn't wipe).
Field set mirrors create_task; same wire conventions for priority,
tags, and date fields. assigned_user_id sets the single assignee —
Kanban Tool tasks have one assignee, not a list. For column/lane/position
changes prefer move_task — it's the intent-revealing surface for that
workflow.
Raises ValueError if every field is None (no-op guard).
Common 422s (KanbanToolValidationError with parsed field_errors):
lane_id from a different board → use get_board(board_id).columns
on the destination board first; assigned_user_id not a board
collaborator → list_board_collaborators(board_id) to confirm.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task_id | Yes | ||
| name | No | ||
| description | No | ||
| board_id | No | ||
| lane_id | No | ||
| swimlane_id | No | ||
| position | No | ||
| priority | No | ||
| color | No | ||
| due_date | No | ||
| start_date | No | ||
| tags | No | ||
| assigned_user_id | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| name | Yes | ||
| description | No | ||
| board_id | No | ||
| workflow_stage_id | No | ||
| swimlane_id | No | ||
| position | No | ||
| priority | No | ||
| color | No | ||
| due_date | No | ||
| start_date | No | ||
| tags | No | ||
| assigned_user_id | No | ||
| archived_at | No | ||
| block_reason | No | ||
| subtasks_count | No | ||
| subtasks | No | ||
| comments_count | No | ||
| timers_total | No | ||
| time_trackers | No | ||
| created_at | No | ||
| updated_at | No | ||
| size_estimate | No | ||
| size_estimate_description | No | ||
| time_estimate | No | ||
| search_tags | No | ||
| card_color | No | ||
| card_color_in_rgb | No | ||
| card_color_invert | No | ||
| card_type_id | No | ||
| recurring_schedule | No | ||
| reminders_schedule | No | ||
| linked_tasks | No | ||
| linked_tasks_status | No | ||
| task_dependencies | No | ||
| collaborators | No | ||
| attachments | No | ||
| attachments_count | No | ||
| created_by_id | No | ||
| moved_at | No | ||
| postponed_until | No | ||
| subtasks_completed_count | No | ||
| external_id | No | ||
| external_link | No | ||
| custom_fields | No | ||
| is_archived | Yes | True iff the task has an archival timestamp. | |
| is_blocked | Yes | True iff the task has a non-empty block reason. |