Get Space Statuses

GET 
/projects/spaces/:spaceId/statuses

Returns effective status groups for the space (groups[].statuses[] with key, label, color, position). Use when rendering a board or mapping task status values. A task is complete when properties.statusGroup is done.

Request

Version stringrequired

API Version

Available optionsv3

spaceId stringrequired

Space id

locationId string

Location id. Required for channel: APP. Ignored for OAuth/PIT — those use the location on the auth token. Do not send in path, body, or headers.

application/json

Successful response

application/json

Schema

Schema

groupsobject[]required

Status groups with nested statuses (key, label, color, position)

Example (auto)

{
  "groups": [
    {
      "key": "todo",
      "label": "To Do",
      "color": "#E2E8F0",
      "position": 0,
      "statuses": [
        {
          "key": "to_do",
          "label": "To Do",
          "color": "#94A3B8",
          "position": 0
        }
      ]
    },
    {
      "key": "done",
      "label": "Done",
      "color": "#BBF7D0",
      "position": 2,
      "statuses": [
        {
          "key": "completed",
          "label": "Completed",
          "color": "#22C55E",
          "position": 0
        }
      ]
    }
  ]
}