puzaricloud-in

puzaricloud-in Heartbeats API

The heartbeats API from puzaricloud-in — 5 operation(s) for heartbeats.

GitHub OpenAPI

Operations 15

POST /ping/{token} Heartbeat ping (job succeeded) #
GET /ping/{token} Heartbeat ping (job succeeded) #
HEAD /ping/{token} Heartbeat ping (job succeeded) #
POST /ping/{token}/start Heartbeat ping (job started) #
GET /ping/{token}/start Heartbeat ping (job started) #
HEAD /ping/{token}/start Heartbeat ping (job started) #
POST /ping/{token}/log Heartbeat log entry (no state change) #
GET /ping/{token}/log Heartbeat log entry (no state change) #
HEAD /ping/{token}/log Heartbeat log entry (no state change) #
POST /ping/{token}/fail Heartbeat ping (job failed) #
GET /ping/{token}/fail Heartbeat ping (job failed) #
HEAD /ping/{token}/fail Heartbeat ping (job failed) #
POST /ping/{token}/{exit_code} Heartbeat ping with exit code (0 = ok) #
GET /ping/{token}/{exit_code} Heartbeat ping with exit code (0 = ok) #
HEAD /ping/{token}/{exit_code} Heartbeat ping with exit code (0 = ok) #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/puzaricloud-in/openapi/puzaricloud-in-heartbeats-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/puzaricloud-in/json-schema/puzaricloud-in-monitor-in-schema.json
📊
JSONSchema
https://artifacts.apis.io/puzaricloud-in/json-schema/puzaricloud-in-monitor-out-schema.json
📊
JSONSchema
https://artifacts.apis.io/puzaricloud-in/json-schema/puzaricloud-in-status-page-in-schema.json
📊
JSONSchema
https://artifacts.apis.io/puzaricloud-in/json-schema/puzaricloud-in-check-out-schema.json
📊
JSONSchema
https://artifacts.apis.io/puzaricloud-in/json-schema/puzaricloud-in-agent-report-schema.json
📊
JSONSchema
https://artifacts.apis.io/puzaricloud-in/json-schema/puzaricloud-in-incident-out-schema.json

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/puzaricloud-in:puzaricloud-in-heartbeats-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.

GitHub Google LinkedIn

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

OpenAPI Specification

puzaricloud-in-heartbeats-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Vigil Heartbeats API
  description: 'Uptime, API checks with assertions, cron heartbeats, SSL expiry, website change detection and status pages.


    Authenticate with `Authorization: Bearer ` (find your key under Settings). API access requires a paid plan.


    Alert integration recipes: Spike.sh (webhook body template with `"source": "vigil"`), Apprise (send Apprise notifications into alert ingestion), MCP server, OpenTelemetry.'
  version: 1.0.0
tags:
- name: heartbeats
paths:
  /ping/{token}:
    post:
      tags:
      - heartbeats
      summary: Heartbeat ping (job succeeded)
      operationId: ping_ping__token__post
      parameters:
      - name: token
        in: path
        required: true
        schema:
          type: string
          title: Token
      responses:
        '200':
          description: Successful Response
          content:
            text/plain:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - heartbeats
      summary: Heartbeat ping (job succeeded)
      operationId: getPingByToken
      parameters:
      - name: token
        in: path
        required: true
        schema:
          type: string
          title: Token
      responses:
        '200':
          description: Successful Response
          content:
            text/plain:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-operation-id-source: normalized
      x-operation-id-original: ping_ping__token__post
    head:
      tags:
      - heartbeats
      summary: Heartbeat ping (job succeeded)
      operationId: headPingByToken
      parameters:
      - name: token
        in: path
        required: true
        schema:
          type: string
          title: Token
      responses:
        '200':
          description: Successful Response
          content:
            text/plain:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-operation-id-source: normalized
      x-operation-id-original: ping_ping__token__post
  /ping/{token}/start:
    post:
      tags:
      - heartbeats
      summary: Heartbeat ping (job started)
      operationId: ping_start_ping__token__start_post
      parameters:
      - name: token
        in: path
        required: true
        schema:
          type: string
          title: Token
      responses:
        '200':
          description: Successful Response
          content:
            text/plain:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - heartbeats
      summary: Heartbeat ping (job started)
      operationId: getPingByTokenStart
      parameters:
      - name: token
        in: path
        required: true
        schema:
          type: string
          title: Token
      responses:
        '200':
          description: Successful Response
          content:
            text/plain:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-operation-id-source: normalized
      x-operation-id-original: ping_start_ping__token__start_post
    head:
      tags:
      - heartbeats
      summary: Heartbeat ping (job started)
      operationId: headPingByTokenStart
      parameters:
      - name: token
        in: path
        required: true
        schema:
          type: string
          title: Token
      responses:
        '200':
          description: Successful Response
          content:
            text/plain:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-operation-id-source: normalized
      x-operation-id-original: ping_start_ping__token__start_post
  /ping/{token}/log:
    post:
      tags:
      - heartbeats
      summary: Heartbeat log entry (no state change)
      operationId: ping_log_ping__token__log_post
      parameters:
      - name: token
        in: path
        required: true
        schema:
          type: string
          title: Token
      responses:
        '200':
          description: Successful Response
          content:
            text/plain:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - heartbeats
      summary: Heartbeat log entry (no state change)
      operationId: getPingByTokenLog
      parameters:
      - name: token
        in: path
        required: true
        schema:
          type: string
          title: Token
      responses:
        '200':
          description: Successful Response
          content:
            text/plain:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-operation-id-source: normalized
      x-operation-id-original: ping_log_ping__token__log_post
    head:
      tags:
      - heartbeats
      summary: Heartbeat log entry (no state change)
      operationId: headPingByTokenLog
      parameters:
      - name: token
        in: path
        required: true
        schema:
          type: string
          title: Token
      responses:
        '200':
          description: Successful Response
          content:
            text/plain:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-operation-id-source: normalized
      x-operation-id-original: ping_log_ping__token__log_post
  /ping/{token}/fail:
    post:
      tags:
      - heartbeats
      summary: Heartbeat ping (job failed)
      operationId: ping_fail_ping__token__fail_post
      parameters:
      - name: token
        in: path
        required: true
        schema:
          type: string
          title: Token
      responses:
        '200':
          description: Successful Response
          content:
            text/plain:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - heartbeats
      summary: Heartbeat ping (job failed)
      operationId: getPingByTokenFail
      parameters:
      - name: token
        in: path
        required: true
        schema:
          type: string
          title: Token
      responses:
        '200':
          description: Successful Response
          content:
            text/plain:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-operation-id-source: normalized
      x-operation-id-original: ping_fail_ping__token__fail_post
    head:
      tags:
      - heartbeats
      summary: Heartbeat ping (job failed)
      operationId: headPingByTokenFail
      parameters:
      - name: token
        in: path
        required: true
        schema:
          type: string
          title: Token
      responses:
        '200':
          description: Successful Response
          content:
            text/plain:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-operation-id-source: normalized
      x-operation-id-original: ping_fail_ping__token__fail_post
  /ping/{token}/{exit_code}:
    post:
      tags:
      - heartbeats
      summary: Heartbeat ping with exit code (0 = ok)
      operationId: ping_exit_ping__token___exit_code__post
      parameters:
      - name: token
        in: path
        required: true
        schema:
          type: string
          title: Token
      - name: exit_code
        in: path
        required: true
        schema:
          type: string
          title: Exit Code
      responses:
        '200':
          description: Successful Response
          content:
            text/plain:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - heartbeats
      summary: Heartbeat ping with exit code (0 = ok)
      operationId: getPingByTokenByExitCode
      parameters:
      - name: token
        in: path
        required: true
        schema:
          type: string
          title: Token
      - name: exit_code
        in: path
        required: true
        schema:
          type: string
          title: Exit Code
      responses:
        '200':
          description: Successful Response
          content:
            text/plain:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-operation-id-source: normalized
      x-operation-id-original: ping_exit_ping__token___exit_code__post
    head:
      tags:
      - heartbeats
      summary: Heartbeat ping with exit code (0 = ok)
      operationId: headPingByTokenByExitCode
      parameters:
      - name: token
        in: path
        required: true
        schema:
          type: string
          title: Token
      - name: exit_code
        in: path
        required: true
        schema:
          type: string
          title: Exit Code
      responses:
        '200':
          description: Successful Response
          content:
            text/plain:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-operation-id-source: normalized
      x-operation-id-original: ping_exit_ping__token___exit_code__post
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError