> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oktolabs.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.



## OpenAPI

````yaml /openapi.json get /api/v1/boards/{board_id}/analytics/blockers
openapi: 3.1.0
info:
  description: >-
    Okto Pulse REST API schema generated from okto-pulse-core 0.2.0 source for
    docs.oktolabs.ai.
  title: Okto Pulse
  version: 0.2.0
servers: []
security: []
paths:
  /api/v1/boards/{board_id}/analytics/blockers:
    get:
      tags:
        - analytics
      summary: Board Blockers
      description: >-
        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.
      operationId: board_blockers_api_v1_boards__board_id__analytics_blockers_get
      parameters:
        - in: path
          name: board_id
          required: true
          schema:
            title: Board Id
            type: string
        - description: >-
            Cards unchanged for more than this many hours while in an active
            state are flagged as stale.
          in: query
          name: stale_hours
          required: false
          schema:
            default: 72
            description: >-
              Cards unchanged for more than this many hours while in an active
              state are flagged as stale.
            minimum: 1
            title: Stale Hours
            type: integer
        - description: >-
            Optional: return only blockers of this type. One of:
            dependency_blocked, on_hold, stale, spec_pending_validation,
            spec_no_cards, uncovered_scenario.
          in: query
          name: filter_type
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Optional: return only blockers of this type. One of:
              dependency_blocked, on_hold, stale, spec_pending_validation,
              spec_no_cards, uncovered_scenario.
            title: Filter Type
      responses:
        '200':
          content:
            application/json:
              schema: {}
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
        - HTTPBearer: []
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    ValidationError:
      properties:
        ctx:
          title: Context
          type: object
        input:
          title: Input
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
  securitySchemes:
    HTTPBearer:
      scheme: bearer
      type: http

````