Columns

Create column

Add a column to the end of a project's board. The slug is derived from the name.

post/column/{projectId}

Path parameters

projectIdstring required

Request body

namestring required

iconstring

colorstring

isFinalboolean

Response

The created column

idstring required

projectIdstring required

namestring required

slugstring required

Stable identifier derived from the name; tasks store this as their status.

positionnumber required

Board order, ascending. Columns are always returned sorted by it.

iconstring nullable required

colorstring nullable required

isFinalboolean required

Marks the column as a done state, which stops overdue reminders for tasks in it.

createdAtstring date-time required

updatedAtstring date-time required

Changes

Changed in 4 of the 23 revisions of this API.215

Aug 24, 2026200744ae0bef1See the full diff
- ○
  added the non-success response with the status 409
  response-non-success-status-added
Aug 24, 202608bbb5bedb5d13See the full diff
- ○
  added the non-success response with the status 400
  response-non-success-status-added
- ○
  added the non-success response with the status 401
  response-non-success-status-added
- ○
  added the non-success response with the status 403
  response-non-success-status-added
- ○
  added the required property color to the response with the 200 status
  response-required-property-added
- ○
  added the required property createdAt to the response with the 200 status
  response-required-property-added
- ○
  added the required property icon to the response with the 200 status
  response-required-property-added
- ○
  added the required property id to the response with the 200 status
  response-required-property-added
- ○
  added the required property isFinal to the response with the 200 status
  response-required-property-added
- ○
  added the required property name to the response with the 200 status
  response-required-property-added
- ○
  added the required property position to the response with the 200 status
  response-required-property-added
- ○
  added the required property projectId to the response with the 200 status
  response-required-property-added
- ○
  added the required property slug to the response with the 200 status
  response-required-property-added
- ○
  added the required property updatedAt to the response with the 200 status
  response-required-property-added
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 11, 202632cece1ebe432See the full diff
- ▲
  request body became required
  request-body-became-required
- ▲
  the response's body type/format changed from / to object/ for status 200
  response-body-type-changed
Feb 21, 20263a866dc993261See the full diff
- ○
  endpoint added
  endpoint-added

Full history