Kanban

Create or update a kanban column

Mirrors the MCP create_column / update_column tools. Only valid on a todo-mode board. Creates a NEW column with a fresh UUID, OR updates an existing column in place if you pass its id. Max 200 columns per board (≤ 20 per row, ≤ 10 rows).

post/api/boards/{boardId}/columns

Request

  • Base URL: https://cnvs.app
  • URL: https://cnvs.app/api/boards/{boardId}/columns
  • Auth: none declared

Request body

idstring

Pass an existing id to UPDATE that column; omit to CREATE a new one.

titlestring required
sortnumber

Left-to-right position. Defaults to the end if omitted on create.

laneinteger

Optional row index for multi-lane layout. Defaults to 0 (top row).

color'red' | 'blue' | 'green'

Optional column title color — one of red / blue / green. Omit for the default.

Response

Column created or updated.

idstring required
titlestring required
sortnumber

Left-to-right order of the column.

laneinteger

Row index for multi-lane layout. Defaults to 0 (top row).

color'red' | 'blue' | 'green' | 'null' nullable

Column title color — one of red / blue / green, or null for the default.

authorstring nullable
last_updatedstring

UTC timestamp.

Changes

No recorded changes to this operation across all 1 revision of this API.