Create a kanban column

Create a kanban column and append it to the board.

Requires a valid bearer token and an active company. Board structure changes are gated to manager-and-above (ADR-005 P4, ticket.create capability → 403 for lower roles). When project_id is set, access to that project is verified (403 on cross-company access).

Authorization

HTTPBearer

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Payload to create a new kanban column (board lane).

name*Name

Display name of the column / board lane.

color?Color

CSS color for the column header (hex or CSS variable).

Default"var(--text-dim)"

icon?Icon

Material Symbols icon name shown on the column header.

Default"view_column"

triggers_workflow?Triggers Workflow

When true, moving a ticket into this column auto-starts an agent workflow.

Defaultfalse

project_id?|

UUID of the project this column belongs to. Null → a global (project-less) column.

Response Body

`application/json`

curl -X POST "https://example.com/kanban/columns" \  -H "Content-Type: application/json" \  -d '{    "color": "#8ff5ff",    "icon": "rate_review",    "name": "In Review",    "project_id": "3f2504e0-4f89-41d3-9a0c-0305e82c3301",    "triggers_workflow": false  }'

null

Empty

{  "detail": [    {      "loc": [        "string"      ],      "msg": "string",      "type": "string",      "input": null,      "ctx": {}    }  ]}

Create a kanban column

Authorization

Request Body

Response Body

201application/json

401

403

422application/json

`application/json`

`application/json`