skip to content

heartbeats API

OpenAPI specification

Create API keys at account. Send Authorization: Bearer YOUR_KEY. Browser requests use secure session cookies. Mutations require an Origin header matching the application origin; command-line clients must include it too. Data belongs to the authenticated account. Invalid credentials return 401; account outages return 503.

curl -H 'Authorization: Bearer YOUR_KEY' https://heartbeats.dorianmarie.com/api/identity
MethodPathPurpose
GET/apiPublic application metadata
GET/api/identityAuthenticated identity
GET/api/overviewRead monitors and incidents
POST/api/monitorsCreate monitor with name, interval_seconds, grace_seconds
PATCH/api/monitors/{id}Update owned monitor
DELETE/api/monitors/{id}Delete owned monitor

Monitor and ping request bodies. Existing heartbeat tokens remain accepted for compatibility.

open application