API

A small, deliberately scoped REST API for provisioning monitors and reading incident/uptime data. Available on Pro and up.

Full endpoint reference: OpenAPI spec (YAML).

Base URL & auth

https://pingdeck.logicues.com/v1

Authenticate with an API key from Settings → API keys, sent as a bearer token:

Authorization: Bearer pd_live_xxxxxxxxxxxx

Never pass a key in a query string — it would end up in logs and CDN caches.

What you can do

  • CRUD monitors, clients, status pages, custom domains, alert channels, and alert rules
  • Manage report schedules and maintenance windows
  • Read incidents and their event timeline
  • Read uptime/response-time rollups
  • Acknowledge or manually resolve an incident

Conventions

  • Cursor-based pagination — sort is creation-time descending unless noted.
  • Every write endpoint accepts an optional Idempotency-Key header, honored for 24 hours.
  • Rate limits are per API key: 120 req/min sustained on Pro, 300 req/min on Agency. Limit headers are returned on every response.
  • Heartbeat pings (a separate, credential-free capability URL) are rate-limited to 60/min per token — comfortably above a normal ping schedule, enough to absorb a retry storm.