move_task
Move a task to a different column, swimlane, or position within its board. Specify the task ID and optionally column, swimlane, or position to update.
Instructions
Move a task between columns, swimlanes, or positions on its board.
At least one of column_id / swimlane_id / position must be set,
otherwise raises ValueError before issuing HTTP. column_id matches
the Task.lane_id on fetched tasks. Moves are scoped to the task's
current board — there is no cross-board move surface.
Common 422s (KanbanToolValidationError with parsed field_errors):
column_id doesn't belong to the task's board → fetch valid column
ids via get_board(get_task(task_id).board_id).columns and pick from
those; swimlane_id doesn't exist on the task's board → same fix via
.swimlanes on the same Board.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task_id | Yes | ||
| column_id | No | ||
| swimlane_id | No | ||
| position | 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. |