Developers & API
REST API

Everything the UI does, over HTTPS.

A full REST API over your monitors, incidents, executions and reports. Authenticate with a scoped bearer key, bootstrap monitors from an OpenAPI spec or a gRPC service, and lean on idempotency keys and per-key rate limits for automation you can run twice.

The API covers the same resources the dashboard does — create and update monitors, read execution and check history, drive incidents, and pull reports — authenticated with a scoped bearer key. Bootstrap a whole surface by parsing an OpenAPI spec into one monitor per operation, or discover a gRPC service to scaffold a request; then make every mutating call safe to retry with an Idempotency-Key while per-key rate limits keep runaway automation in check.

  • Monitors, incidents, executions & reports — the same resources as the app.
  • Bootstrap from OpenAPI or gRPC — parse a spec or discover a service to scaffold monitors.
  • Idempotency-Key + per-key rate limits for safe, repeatable calls.
create-monitor.shbash
# Create a monitor with a scoped API key
curl -X POST https://api.pulsetrace.app/api/v1/monitors \
  -H "Authorization: Bearer $PULSETRACE_API_KEY" \
  -H "Idempotency-Key: 9f3c-checkout-01" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Checkout API",
    "type": "http",
    "target": "https://api.acme.io/health",
    "interval_seconds": 60,
    "region_codes": ["us-east", "eu-west"],
    "config": { "assertions": [{ "type": "status", "equals": 200 }] }
  }'