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

# Agent Heartbeat



## OpenAPI

````yaml /api-reference/openapi.json post /api/runtime-security/agent/heartbeat
openapi: 3.1.0
info:
  title: Blindsight API
  version: 0.1.0
  description: >-
    The full Blindsight REST surface, generated from the running application.
    Replace the server host with your own deployment.


    For the Runtime Security integration surface (scan, proxy, tool calls) see
    the Runtime Security spec, which is hand written and carries worked
    examples.
servers:
  - url: https://api.your-blindsight.com
    description: Your Blindsight deployment
security: []
paths:
  /api/runtime-security/agent/heartbeat:
    post:
      tags:
        - runtime-security-agent
      summary: Agent Heartbeat
      operationId: agent_heartbeat_api_runtime_security_agent_heartbeat_post
      parameters:
        - name: X-Blindsight-Device-Token
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Blindsight-Device-Token
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/HeartbeatRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    HeartbeatRequest:
      properties:
        agent_version:
          anyOf:
            - type: string
              maxLength: 32
            - type: 'null'
          title: Agent Version
        host_rules_version:
          anyOf:
            - type: string
              maxLength: 32
            - type: 'null'
          title: Host Rules Version
        policy_revision:
          anyOf:
            - type: integer
            - type: 'null'
          title: Policy Revision
        protection_state:
          anyOf:
            - type: string
              maxLength: 16
            - type: 'null'
          title: Protection State
        hardware_id:
          anyOf:
            - type: string
              maxLength: 128
            - type: 'null'
          title: Hardware Id
        effective_settings:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Effective Settings
        install_kind:
          anyOf:
            - type: string
              maxLength: 8
            - type: 'null'
          title: Install Kind
      type: object
      title: HeartbeatRequest
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````