Monitors
Get a monitor
Get one monitor with GET /v1/monitors/: its query, status, schedule, webhook and next three run times.
GET
Get a monitor
Get one monitor.
upcoming_runs lists its next three run times in UTC.
When to use it
Check a monitor’sstatus after a monitor.disabled event, or confirm that an update took effect. next_run_at and upcoming_runs show when the schedule runs next. Both are empty when the monitor has no schedule or isn’t active. To find an id, list your monitors.
The response never carries webhook.secret. Your webhook handler needs the one from the create response to verify deliveries.
SDK, CLI and MCP
The SDK methods need SDK 0.2.0 or later. See SDKs → Monitors.
Related operations
- Update a monitor changes it, or pauses and resumes it.
- List runs shows what its runs returned.
- Statuses explains each
statusand how it changes.
Authorizations
Response
The monitor