Get work-item board projection

Returns a read-only board projection grouped by canonical Execute status bucket. The board is a view over execute_work_item.status_bucket, not an independent placement system.

GET/api/v1/work-items/board

Authorization

work-items:readapi key scoperequired

Required scope when calling with an API key.

Query parameters

team_idstringoptional

Include team/account flow-state metadata for this team

Example: team_abc123

sprint_idstringoptional

Filter board items by sprint

Example: sprint_abc123

assignee_user_idstringoptional

Filter board items by assignee

Example: user_abc123

status_bucketstringoptional

Repeat or comma-separate canonical buckets

Example: todo,in_progress

limitnumberoptional

Maximum items before grouping, 1–100

Example: 50

Request

GET /api/v1/work-items/board

curl -X GET "https://www.digitalstack360.com/api/v1/work-items/board" \
  -H "Authorization: Bearer $DS_API_KEY"

Examples use a placeholder key from your environment. Store your key in $DS_API_KEY — never commit it.

Response

200 OK

{
  "data": {
    "columns": [
      {
        "id": "todo",
        "title": "To do",
        "status_bucket": "todo",
        "items": [
          {
            "id": "work_01k2...",
            "key": "DSN-42",
            "title": "Implement board projection API",
            "status_bucket": "todo"
          }
        ]
      }
    ],
    "projection": {
      "source_of_truth": "execute_work_item.status_bucket",
      "coordinate_policy": "read_only_projection",
      "flow_state_layer": "team"
    },
    "flow_states": [
      {
        "id": "state_todo",
        "name": "Backlog",
        "canonical_kind": "todo",
        "display_order": 10,
        "is_terminal": false
      }
    ]
  },
  "meta": {
    "limit": 50,
    "count": 1
  }
}

Errors

401

missing_auth

No credentials provided

401

invalid_api_key

API key is invalid or revoked

403

scope_insufficient

Key lacks work-items:read scope

400

invalid_limit

limit is outside the 1–100 range

400

invalid_status_bucket

status_bucket is not a canonical Execute bucket