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

# Get Kg Health Endpoint

> Return the live KG health snapshot for ``board_id``.

Compute is in-process: SQL aggregations on the app DB and
per-node-type queries against the board's Kùzu graph. Kùzu errors
degrade gracefully (zeros), so the endpoint stays available even when
Kùzu hasn't been bootstrapped or is under a transient lock.



## OpenAPI

````yaml /openapi.json get /api/v1/kg/health
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/kg/health:
    get:
      tags:
        - kg-health
      summary: Get Kg Health Endpoint
      description: |-
        Return the live KG health snapshot for ``board_id``.

        Compute is in-process: SQL aggregations on the app DB and
        per-node-type queries against the board's Kùzu graph. Kùzu errors
        degrade gracefully (zeros), so the endpoint stays available even when
        Kùzu hasn't been bootstrapped or is under a transient lock.
      operationId: get_kg_health_endpoint_api_v1_kg_health_get
      parameters:
        - description: Board ID (uuid)
          in: query
          name: board_id
          required: true
          schema:
            description: Board ID (uuid)
            title: Board Id
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KGHealthResponse'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
        - HTTPBearer: []
components:
  schemas:
    KGHealthResponse:
      description: Live KG health snapshot for one board.
      properties:
        avg_relevance:
          title: Avg Relevance
          type: number
        contradict_warn_count:
          title: Contradict Warn Count
          type: integer
        dead_letter_count:
          title: Dead Letter Count
          type: integer
        default_score_count:
          title: Default Score Count
          type: integer
        default_score_ratio:
          title: Default Score Ratio
          type: number
        last_decay_tick_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Last Decay Tick At
        nodes_recomputed_in_last_tick:
          default: 0
          title: Nodes Recomputed In Last Tick
          type: integer
        oldest_pending_age_s:
          title: Oldest Pending Age S
          type: number
        queue_depth:
          title: Queue Depth
          type: integer
        schema_version:
          title: Schema Version
          type: string
        tick_in_progress:
          default: false
          title: Tick In Progress
          type: boolean
        top_disconnected_nodes:
          items:
            $ref: '#/components/schemas/TopDisconnectedNode'
          title: Top Disconnected Nodes
          type: array
        total_nodes:
          title: Total Nodes
          type: integer
      required:
        - queue_depth
        - oldest_pending_age_s
        - dead_letter_count
        - total_nodes
        - default_score_count
        - default_score_ratio
        - avg_relevance
        - top_disconnected_nodes
        - schema_version
        - contradict_warn_count
      title: KGHealthResponse
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    TopDisconnectedNode:
      properties:
        degree:
          title: Degree
          type: integer
        id:
          title: Id
          type: string
        type:
          title: Type
          type: string
      required:
        - id
        - type
        - degree
      title: TopDisconnectedNode
      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

````