Pinging API

The pinging API is the core interface your applications use to communicate with HealthyCron. No authentication headers are required, making it trivial to integrate with bash scripts and legacy systems.

GET/POST /ping/{uuid}

The success ping. Call this when your job completes successfully. This resets the timer and updates the monitor state to Healthy.

curl -fsS https://healthycron.io/ping/{uuid}

var client = new HttpClient();
await client.GetAsync("https://healthycron.io/ping/{uuid}");

import requests
requests.get('https://healthycron.io/ping/{uuid}')

fetch('https://healthycron.io/ping/{uuid}');

GET/POST /ping/{uuid}/start

The start ping. Call this at the very beginning of the job execution. This does not mark the job as complete, but rather informs HealthyCron that the job is currently running so it can measure exact duration upon the success ping.

curl -fsS https://healthycron.io/ping/{uuid}/start

var client = new HttpClient();
await client.GetAsync("https://healthycron.io/ping/{uuid}/start");

import requests
requests.get('https://healthycron.io/ping/{uuid}/start')

fetch('https://healthycron.io/ping/{uuid}/start');

GET/POST /ping/{uuid}/fail

The failure ping. Call this inside your catch or error handler. It immediately transitions the monitor to the failed state and triggers alerts, bypassing any remaining grace period.

curl -fsS https://healthycron.io/ping/{uuid}/fail

var client = new HttpClient();
await client.GetAsync("https://healthycron.io/ping/{uuid}/fail");

import requests
requests.get('https://healthycron.io/ping/{uuid}/fail')

fetch('https://healthycron.io/ping/{uuid}/fail');