List Lists

List all lists (columns/statuses) in a workspace.

POST /v1/list-lists

List all lists (columns/statuses) in a workspace. Lists represent workflow stages and contain records. Use this to get list IDs needed by create-record and move-record.

Request body

FieldTypeRequiredDescription
workspaceIdstringYesThe workspace ID
{
  "workspaceId": "string"
}

Response

[
  {
    "id": "string",
    "uid": "string",
    "title": "string",
    "rank": "string",
    "completed": true,
    "isLocked": true,
    "isDisabled": true,
    "todosCount": 0
  }
]

Example

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