AmpleRun Health API

Liveness, readiness and public status. No credential needed.

Operations 3

GET /api/v1/health/live Liveness (public minimal) #
GET /api/v1/health/ready Readiness (public minimal); schema/DB/worker/clock with redacted degraded… #
GET /api/v1/status Public status (minimal) #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/amplerun-com:amplerun-com-health-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

amplerun-com-health-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Amplerun Com Health API
  version: 3.0.0
  description: 'Operations tagged health across 2 of this provider''s published API definitions: openapi.json, amplerun-com-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://amplerun-api.spiry.org
  description: Production machine API (direct origin)
- url: https://amplerun.com
  description: Production frontend-compatible API origin
tags:
- name: Health
  description: Liveness, readiness and public status. No credential needed.
paths:
  /api/v1/health/live:
    get:
      operationId: getLiveness
      tags:
      - Health
      summary: Liveness (public minimal)
      security: []
      responses:
        '200':
          description: Process alive.
          content:
            application/json:
              schema:
                type: object
                required:
                - ok
                properties:
                  ok:
                    const: true
    servers:
    - url: https://amplerun-api.spiry.org
      description: Production machine API (direct origin)
    - url: https://amplerun.com
      description: Production frontend-compatible API origin
  /api/v1/health/ready:
    get:
      operationId: getReadiness
      tags:
      - Health
      summary: Readiness (public minimal); schema/DB/worker/clock with redacted degraded…
      security: []
      responses:
        '200':
          description: Ready.
          content:
            application/json:
              schema:
                type: object
                required:
                - ready
                properties:
                  ready:
                    const: true
        '503':
          description: Degraded; redacted reasons.
          content:
            application/json:
              schema:
                type: object
                required:
                - ready
                - degraded
                properties:
                  ready:
                    const: false
                  degraded:
                    type: array
                    items:
                      enum:
                      - schema
                      - database
                      - worker
    servers:
    - url: https://amplerun-api.spiry.org
      description: Production machine API (direct origin)
    - url: https://amplerun.com
      description: Production frontend-compatible API origin
  /api/v1/status:
    get:
      operationId: getStatus
      tags:
      - Health
      summary: Public status (minimal)
      description: While admissions_paused is true, new reservations are refused with 403 ADMISSION_PAUSED; running rentals are unaffected.
      security: []
      responses:
        '200':
          description: Status.
          content:
            application/json:
              schema:
                type: object
                required:
                - service
                - contract_version
                - admissions_paused
                - time
                properties:
                  service:
                    const: AmpleRun
                  contract_version:
                    type: integer
                  admissions_paused:
                    anyOf:
                    - type: boolean
                    - type: 'null'
                    description: null when the state could not be read.
                  time:
                    $ref: '#/components/schemas/Rfc3339Utc'
    servers:
    - url: https://amplerun-api.spiry.org
      description: Production machine API (direct origin)
    - url: https://amplerun.com
      description: Production frontend-compatible API origin
components:
  schemas:
    Rfc3339Utc:
      type: string
      format: date-time
      pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]+)?Z$
      example: '2026-09-25T12:00:00Z'
  securitySchemes:
    sessionAuth:
      type: http
      scheme: bearer
      description: 'Bearer credential. Programs and agents send a scoped API key as `Authorization: Bearer ark_...` (renter and/or host scope; created once at https://amplerun.com/account#api-keys or POST /api/v1/account/api-keys; the secret is shown only at creation). The web app uses a pinned Better Auth session. API keys never reach /api/v1/admin/*. Step-up (recent re-auth) is required where noted.'
externalDocs:
  description: Guides, SDKs, CLI and the MCP server for AI agents
  url: https://amplerun.com/docs/api
x-refined-from:
- openapi.json
- amplerun-com-openapi.json