Skip to navigation
Project ManagerStatuses

PM · Statuses · Add a new status column to a board (returns ID needed for createTask)

View as Markdown

Add a new column to a board. Required field: title. Optional: color (hex string e.g. #008CD3), order (integer position; appended at end if omitted). The new status id is returned and should be cached — it is required for createTask and searchTasks.

Authentication

AuthorizationApi-Key

Header authentication of the form Api-Key <token>

OR
AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

board_idstringRequiredformat: "uuid"

Headers

OrganizationstringOptional

Workspace (organization) ID the request is scoped to.

SpacestringOptional

Optional sub-space ID for further scoping inside the workspace.

Request

This endpoint expects an object.
titlestringRequired<=32 characters
descriptionstringOptional
colorstringOptional
Hex color string.
orderintegerOptional
Optional explicit order index.

Response

Status created.