Hyperping

Hyperping Monitors API

Create, retrieve, update, and delete uptime monitors.

Documentation GitHub OpenAPI

Business capability

Observability Management BC-4220.20

Operations 5

GET /v1/monitors List all monitors #

POST /v1/monitors Create a monitor #

GET /v1/monitors/{uuid} Get a monitor #

PUT /v1/monitors/{uuid} Update a monitor #

DELETE /v1/monitors/{uuid} Delete a monitor #

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/hyperping:hyperping-monitors-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  title: Hyperping Monitors API
  description: Hyperping is an uptime monitoring platform and status page service. This API allows you to programmatically manage monitors, healthchecks, status pages, incidents, outages, maintenance windows, and access uptime reports.
  version: 1.0.0
  contact:
    name: Hyperping Support
    email: hello@hyperping.io
    url: https://hyperping.com
  x-logo:
    url: https://hyperping.com/icons/icon-512x512.png
servers:
- url: https://api.hyperping.io
  description: Production API server
security:
- bearerAuth: []
tags:
- name: Monitors
  description: Uptime monitors for websites and APIs
paths:
  /v1/monitors:
    get:
      tags:
      - Monitors
      summary: List all monitors
      description: Returns a list of all monitors for a project.
      operationId: listMonitors
      responses:
        '200':
          description: List of monitors
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Monitor'
        '401':
          $ref: '#/components/responses/Unauthorized'
    post:
      tags:
      - Monitors
      summary: Create a monitor
      description: Creates a new uptime monitor.
      operationId: createMonitor
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MonitorCreate'
      responses:
        '201':
          description: Monitor created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Monitor'
        '401':
          $ref: '#/components/responses/Unauthorized'
  /v1/monitors/{uuid}:
    get:
      tags:
      - Monitors
      summary: Get a monitor
      description: Retrieve details of a specific monitor.
      operationId: getMonitor
      parameters:
      - $ref: '#/components/parameters/MonitorUuid'
      responses:
        '200':
          description: Monitor details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Monitor'
        '404':
          $ref: '#/components/responses/NotFound'
    put:
      tags:
      - Monitors
      summary: Update a monitor
      description: Update an existing monitor's configuration.
      operationId: updateMonitor
      parameters:
      - $ref: '#/components/parameters/MonitorUuid'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MonitorCreate'
      responses:
        '200':
          description: Monitor updated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Monitor'
    delete:
      tags:
      - Monitors
      summary: Delete a monitor
      description: Permanently delete a monitor.
      operationId: deleteMonitor
      parameters:
      - $ref: '#/components/parameters/MonitorUuid'
      responses:
        '200':
          description: Monitor deleted
components:
  responses:
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
                example: Resource not found
    Unauthorized:
      description: Invalid or missing API key
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
                example: Invalid or missing API key
  schemas:
    MonitorCreate:
      type: object
      required:
      - name
      - url
      properties:
        name:
          type: string
          example: My Website
        url:
          type: string
          example: https://acme.com
        protocol:
          type: string
          enum:
          - http
          - port
          - icmp
          default: http
        http_method:
          type: string
          enum:
          - GET
          - POST
          - PUT
          - HEAD
          - DELETE
          - PATCH
          - OPTIONS
          default: GET
        check_frequency:
          type: integer
          enum:
          - 10
          - 20
          - 30
          - 60
          - 120
          - 180
          - 300
          - 600
          - 1800
          - 3600
          - 21600
          - 43200
          - 86400
          default: 30
        regions:
          type: array
          items:
            type: string
            enum:
            - sanfrancisco
            - nyc
            - london
            - paris
            - frankfurt
            - seoul
            - mumbai
            - bangalore
            - saopaulo
            - california
            - virginia
            - sydney
            - toronto
            - amsterdam
            - singapore
            - tokyo
            - bahrain
            - capetown
        expected_status_code:
          type: string
          description: Use "2xx" for 200-299, "1xx-3xx" for 100-399, or a specific code like "200"
          default: 2xx
        required_keyword:
          type: string
        follow_redirects:
          type: boolean
          default: true
        ip_version:
          type: integer
          enum:
          - 4
          - 6
          default: 4
          description: IP version used to reach the target. 6 = checked over IPv6 only (http, port and icmp protocols), from the selected regions that have an IPv6 probe; rejected if none of them has one.
        port:
          type: integer
        paused:
          type: boolean
          default: false
        alerts_wait:
          type: integer
          enum:
          - -1
          - 0
          - 1
          - 2
          - 3
          - 5
          - 10
          - 30
          - 60
          default: 0
        request_body:
          type: string
        request_headers:
          type: array
          items:
            type: object
            properties:
              name:
                type: string
              value:
                type: string
        escalation_policy:
          type: string
          description: Policy UUID or 'none' to unlink
    Monitor:
      type: object
      properties:
        uuid:
          type: string
          example: mon_OYKr5fpSDHqbP2
        name:
          type: string
          example: API
        url:
          type: string
          example: https://api.acme.com
        protocol:
          type: string
          enum:
          - http
          - port
          - icmp
        http_method:
          type: string
          enum:
          - GET
          - POST
          - PUT
          - HEAD
          - DELETE
          - PATCH
          - OPTIONS
        check_frequency:
          type: integer
          description: Check interval in seconds
          example: 30
        regions:
          type: array
          items:
            type: string
          example:
          - paris
          - london
          - frankfurt
        status:
          type: string
          enum:
          - up
          - down
        paused:
          type: boolean
        expected_status_code:
          type: string
          description: Use "2xx" for 200-299, "1xx-3xx" for 100-399, or a specific code like "200"
          example: 2xx
        required_keyword:
          type: string
        follow_redirects:
          type: boolean
        ip_version:
          type: integer
          enum:
          - 4
          - 6
          description: IP version used to reach the target. 6 = checked over IPv6 only (http, port and icmp protocols), from the selected regions that have an IPv6 probe; rejected if none of them has one.
        port:
          type:
          - integer
          - 'null'
        ssl_expiration:
          type: integer
          description: Days until SSL expiration
        alerts_wait:
          type: integer
          description: Minutes before alerting (-1 to disable)
        escalation_policy:
          type:
          - object
          - 'null'
          properties:
            uuid:
              type: string
            name:
              type: string
  parameters:
    MonitorUuid:
      name: uuid
      in: path
      required: true
      schema:
        type: string
      description: Monitor UUID
      example: mon_OYKr5fpSDHqbP2
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key from https://app.hyperping.io/project/developers
externalDocs:
  description: Hyperping API Documentation
  url: https://hyperping.com/docs/api/overview
x-provenance:
  method: harvested
  publisher: Hyperping
  source: https://hyperping.com/openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)