create_task
Create a new task on a Kanban board. Requires only a task name and board ID; supports optional lane, assignee, priority, due date, and tags.
Instructions
Create a new task on a board. Only name and board_id are required.
lane_id is the target column (matches Task.lane_id on fetched tasks).
assigned_user_id sets the single assignee — Kanban Tool tasks have one
assignee, not a list. (The API silently ignores a legacy assignees: [int]
payload on writes, so this kwarg is the wire field name directly.)
priority accepts the string enum or the raw integer; tags is a
comma-separated string; due_date is an ISO 8601 string forwarded as-is.
Unset kwargs are omitted from the request, never sent as explicit null.
Common 422s (KanbanToolValidationError with parsed field_errors):
name empty/missing → fix by passing a non-empty string;
lane_id belongs to a different board → resolve column ids on the
target board first via get_board(board_id).columns;
assigned_user_id not a board collaborator → check via
list_board_collaborators(board_id).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| board_id | Yes | ||
| description | No | ||
| lane_id | No | ||
| position | No | ||
| assigned_user_id | No | ||
| due_date | No | ||
| priority | No | ||
| tags | 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. |