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

# Health check

> Returns health status and system information including upgrade count and binary details
Also includes last upgrade attempt status with detailed error information if available



## OpenAPI

````yaml https://raw.githubusercontent.com/blaxel-ai/sandbox/refs/heads/main/sandbox-api/docs/openapi.yml get /health
openapi: 3.0.0
info:
  contact: {}
  description: API for manipulating filesystem, processes and network.
  title: Sandbox API
  version: 0.0.1
servers:
  - url: https://sbx-{sandbox_id}-{workspace_id}.{region}.bl.run
    variables:
      sandbox_id:
        default: unknown
      workspace_id:
        default: unknown
      region:
        default: unknown
security:
  - BearerAuth: []
paths:
  /health:
    get:
      tags:
        - system
      summary: Health check
      description: >-
        Returns health status and system information including upgrade count and
        binary details

        Also includes last upgrade attempt status with detailed error
        information if available
      responses:
        '200':
          description: Health status
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HealthResponse'
components:
  schemas:
    HealthResponse:
      properties:
        arch:
          example: amd64
          type: string
        buildTime:
          example: '2026-01-29T17:36:52.000Z'
          type: string
        gitCommit:
          example: abc123
          type: string
        goVersion:
          example: go1.25.0
          type: string
        lastUpgrade:
          $ref: '#/components/schemas/UpgradeStatus'
        os:
          example: linux
          type: string
        startedAt:
          example: '2026-01-29T18:45:49.000Z'
          type: string
        status:
          example: ok
          type: string
        upgradeCount:
          example: 0
          type: integer
        uptime:
          example: 1h30m
          type: string
        uptimeSeconds:
          example: 5400.5
          type: number
        version:
          example: v0.1.0
          type: string
      required:
        - arch
        - buildTime
        - gitCommit
        - goVersion
        - lastUpgrade
        - os
        - startedAt
        - status
        - upgradeCount
        - uptime
        - uptimeSeconds
        - version
      type: object
    UpgradeStatus:
      properties:
        binaryPath:
          description: Path to downloaded binary
          example: /tmp/sandbox-api-new
          type: string
        bytesDownloaded:
          description: Bytes downloaded
          example: 25034936
          type: integer
        downloadUrl:
          description: URL used for download
          example: https://github.com/...
          type: string
        error:
          description: Error message if failed
          example: Failed to download binary
          type: string
        lastAttempt:
          description: When the upgrade was attempted
          type: string
        status:
          allOf:
            - $ref: '#/components/schemas/process.UpgradeState'
          description: Current state (idle, running, completed, failed)
          example: running
        step:
          description: >-
            Current/last step (none, starting, download, validate, replace,
            completed, skipped)
          example: download
          type: string
        version:
          description: Version being upgraded to
          example: latest
          type: string
      required:
        - status
        - step
        - version
      type: object
    process.UpgradeState:
      enum:
        - idle
        - running
        - completed
        - failed
      type: string
      x-enum-comments:
        UpgradeStateCompleted: Upgrade completed successfully
        UpgradeStateFailed: Upgrade failed
        UpgradeStateIdle: No upgrade in progress
        UpgradeStateRunning: Upgrade is currently running
      x-enum-descriptions:
        - No upgrade in progress
        - Upgrade is currently running
        - Upgrade completed successfully
        - Upgrade failed
      x-enum-varnames:
        - UpgradeStateIdle
        - UpgradeStateRunning
        - UpgradeStateCompleted
        - UpgradeStateFailed
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````