Docs / Ping

Heartbeat endpoints for jobs that already run elsewhere.

Use /ping when a simple heartbeat is enough. Use /start and /finish when you want run timing. Use /fail when the job should open an incident right away.

Semantics

/ping records a successful check-in.
/start opens a tracked run.
/finish closes the run and captures duration.
/fail records a failure and opens an incident.
X-Run-Id makes repeated events idempotent per run.

cURL examples

curl -X POST https://cronbro.com/ping/your-code

curl -X POST -H "X-Run-Id: nightly-backup-2026-04-03" https://cronbro.com/start/your-code

curl -X POST -H "X-Run-Id: nightly-backup-2026-04-03" https://cronbro.com/finish/your-code

curl -X POST -H "X-Run-Id: nightly-backup-2026-04-03" https://cronbro.com/fail/your-code