Create List

POST /v1/create-list

Create a new list (column/status) in a workspace. Lists represent workflow stages that contain records. Lists are ordered left-to-right; the response includes rank, the stable order key to sort by.

Request body

{
  "workspaceId": "string",
  "title": "string"
}

Response

{
  "id": "string",
  "uid": "string",
  "title": "string",
  "rank": "string",
  "completed": true,
  "isLocked": true,
  "isDisabled": true
}

Example

curl -X POST https://rest.blue.app/v1/create-list \
  -H "Authorization: Bearer $BLUE_TOKEN" \
  -H "blue-org-id: $BLUE_ORG_ID" \
  -H "Content-Type: application/json" \
  -d '{"workspaceId":"string","title":"string"}'