Board Blockers

curl --request GET \
  --url https://api.example.com/api/v1/boards/{board_id}/analytics/blockers \
  --header 'Authorization: Bearer <token>'

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "ctx": {},
      "input": "<unknown>"
    }
  ]
}

analytics

Board Blockers

Triage endpoint: every artifact blocking the funnel, classified by root cause so an agent can act directly instead of scanning each level.

Categories (non-overlapping; a card can appear in multiple):

dependency_blocked — card is not_started/started while at least one of its depends_on_id targets has NOT reached the DONE status.
on_hold — card is explicitly paused (status=on_hold).
stale — card is in_progress/started/validation but now() - updated_at > stale_hours.
spec_pending_validation — spec is approved but lacks an ‘approve’ validation gate (unable to promote to in_progress).
spec_no_cards — spec is validated/in_progress but has ZERO non-archived cards linked to it.
uncovered_scenarios — scenarios with no linked test cards.

GET

api

boards

{board_id}

analytics

blockers

Board Blockers

curl --request GET \
  --url https://api.example.com/api/v1/boards/{board_id}/analytics/blockers \
  --header 'Authorization: Bearer <token>'

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "ctx": {},
      "input": "<unknown>"
    }
  ]
}

Authorizations

Authorization

string

header

required

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

Path Parameters

board_id

string

required

Query Parameters

stale_hours

integer

default:72

Cards unchanged for more than this many hours while in an active state are flagged as stale.

Required range: x >= 1

filter_type

string | null

Optional: return only blockers of this type. One of: dependency_blocked, on_hold, stale, spec_pending_validation, spec_no_cards, uncovered_scenario.

Response

Successful Response

Last modified on May 17, 2026

Board Agents Board Coverage