LastPing Management API

The REST API behind the LastPing console. It manages monitors, alert destinations, routing, status pages and API keys — the same capabilities available in the web console, over MCP, and through the Terraform provider.

Base URL: https://app.lastping.dev
Authentication: an API key sent as X-Api-Key: <key> or Authorization: Bearer <key>. Create one in the console under Settings → API keys.
Machine-readable spec: /openapi.yaml (OpenAPI 3.1).

52 documented operations:

Agents

• GET /api/v1/agents — List agents
• POST /api/v1/agents — Create an agent
• DELETE /api/v1/agents/{id} — Delete an agent
• GET /api/v1/agents/{id} — Get an agent
• PATCH /api/v1/agents/{id} — Update an agent
• GET /api/v1/agents/{id}/open-incidents — List an agent's open incidents (the failure inbox)

ApiKeys

• GET /api/v1/api-keys — List API keys
• POST /api/v1/api-keys — Create an API key
• DELETE /api/v1/api-keys/{id} — Revoke an API key

Auth

• GET /api/v1/me — Get authenticated principal
• GET /api/v1/whoami — Auth smoke-test

CI

• GET /api/v1/checks/{id}/runs — List run history for a check (CI/CD runs and agent/heartbeat runs)
• POST /ci/{id}/detail — Attach CI failure detail to the open incident

Channels

• GET /api/v1/channels — List notification channels
• POST /api/v1/channels — Create a notification channel
• DELETE /api/v1/channels/{id} — Delete a notification channel
• GET /api/v1/channels/{id} — Get a notification channel
• PATCH /api/v1/channels/{id} — Update a notification channel
• POST /api/v1/channels/{id}/resend-verification — Resend email channel verification
• POST /api/v1/channels/{id}/test — Send a test alert to a channel

Checks

• GET /api/v1/checks — List checks
• POST /api/v1/checks — Create or upsert a check
• DELETE /api/v1/checks/{id} — Delete a check
• GET /api/v1/checks/{id} — Get a check
• PATCH /api/v1/checks/{id} — Update a check
• GET /api/v1/checks/{id}/assertions — Get output assertions for a check
• PUT /api/v1/checks/{id}/assertions — Replace output assertions for a check
• POST /api/v1/checks/{id}/ci/regenerate — Regenerate CI webhook secret
• GET /api/v1/checks/{id}/guards — Get metric guards for a check
• PUT /api/v1/checks/{id}/guards — Replace metric guards for a check
• POST /api/v1/checks/{id}/pause — Pause a check
• GET /api/v1/checks/{id}/ping-instructions — Get ping instructions for a check
• POST /api/v1/checks/{id}/resume — Resume a check
• POST /api/v1/checks/{id}/runs/{rid}/expectations — Declare a run's success criteria before its outcome is known
• POST /api/v1/checks/{id}/snooze — Set or clear a maintenance window
• GET /api/v1/checks/{id}/templates — Get alert templates for a check
• PUT /api/v1/checks/{id}/templates — Replace alert templates for a check

Discovery

• POST /api/v1/discovery/reconcile — Reconcile a discovery scan into monitors

Events

• GET /api/v1/checks/{id}/incidents — List incidents for a check
• GET /api/v1/checks/{id}/pings — List pings for a check

Export

• GET /api/v1/export/terraform — Export monitors, destinations, routes, templates and status pages as Terraform HCL

Health

• GET /healthz — Health check

Incidents

• POST /api/v1/incidents/{id}/notes — Write back what you found out about an incident

Metrics

• GET /api/v1/metrics — Prometheus metrics scrape endpoint

Routes

• GET /api/v1/checks/{id}/routes — List routes for a check
• DELETE /api/v1/checks/{id}/routes/{event_type} — Delete a route
• PUT /api/v1/checks/{id}/routes/{event_type} — Upsert a route

StatusPages

• GET /api/v1/status-pages — List status pages
• POST /api/v1/status-pages — Create a status page
• DELETE /api/v1/status-pages/{id} — Delete a status page
• GET /api/v1/status-pages/{id} — Get a status page
• PATCH /api/v1/status-pages/{id} — Update a status page