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).

84 documented operations:

Agents

• GET /api/v1/agents — List agents
• POST /api/v1/agents — Create an agent
• GET /api/v1/agents/discovered — List discovered agents (trace sources no agent claims)
• POST /api/v1/agents/discovered/{id}/adopt — Adopt a discovered agent, or merge it into an existing one
• GET /api/v1/agents/usage — Tokens and cost per model per day, for the whole project
• 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}/calls — An agent's calls, outgoing and incoming
• GET /api/v1/agents/{id}/dependencies — What an agent calls
• GET /api/v1/agents/{id}/fleet — Get an agent's per-monitor fleet detail
• GET /api/v1/agents/{id}/open-incidents — List an agent's open incidents (the failure inbox)
• GET /api/v1/agents/{id}/usage — An agent's tokens and cost per model per day
• GET /api/v1/dependencies — Everything the project's agents call

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
• POST /api/v1/api-keys/{id}/regenerate — Regenerate an API key ("same key, new secret")
• POST /api/v1/checks/{id}/ingest-keys — Create a tracing key for a monitor

Auth

• GET /api/v1/me — Get authenticated principal
• POST /api/v1/me/delete — Permanently delete the session's own account
• POST /api/v1/me/email — Request a new-address verification for the session's own account
• POST /api/v1/me/password — Change the session's own password
• 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}/analytics — Get the monitor detail page's analytics panel data for 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}/first-ping — Get the first-ping waiting/received card data for a check
• 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
• GET /api/v1/checks/{id}/signal — Get the 90-day signal exception strip for a check
• 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
• POST /api/v1/checks/{id}/test-ping — Send a synthetic success ping
• GET /api/v1/checks/{id}/trace-setup — Get the trace set-up for a monitor

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
• GET /api/v1/checks/{id}/runs/{rid} — One run's full detail
• GET /api/v1/deliveries — List alert delivery records across every check in the project
• GET /api/v1/incidents — List incidents across every check in the project
• GET /api/v1/routes — The project-wide routing grid
• GET /api/v1/runs — List runs across every check in the project
• GET /api/v1/runs/by-monitor — Run totals per monitor across the project

Export

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

Health

• GET /healthz — Health check

Incidents

• GET /api/v1/incidents/{id} — One incident with its recorded timeline
• POST /api/v1/incidents/{id}/notes — Write back what you found out about an incident

Metrics

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

Monitors

• GET /api/v1/checks/{id}/trace-diagnostics — Trace ingest diagnostics for one monitor

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

Traces

• POST /v1/logs — Ingest OTLP logs (Bearer-authenticated)
• POST /v1/metrics — Ingest OTLP metrics (Bearer-authenticated)
• POST /v1/traces — Ingest OTLP traces for a run (Bearer-authenticated)
• POST /{monitor_id}/v1/logs — Ingest OTLP logs (monitor-URL form)
• POST /{monitor_id}/v1/metrics — Ingest OTLP metrics (monitor-URL form)
• POST /{monitor_id}/v1/traces — Ingest OTLP traces for a run (monitor-URL form)