Monitors
Get a run
Get one monitor run with GET /v1/monitors//runs/: its status, the results it returned, and the error if it failed.
GET
Get a run
Get one run.
results is null until the run completes, then holds the new pages, or [] when nothing was new.
When to use it
Poll it after you run a monitor now: the trigger response carries the run’sid. Stop when status is completed or failed. If your monitor has a webhook, the monitor.run.completed and monitor.run.failed events tell you the same without polling.
cancelled is reserved and not used yet. With an output_schema on the monitor, a completed run that found pages also carries output.
SDK, CLI and MCP
The SDK methods need SDK 0.2.0 or later. See SDKs → Monitors.
Related operations
- List runs lists every run, newest first.
- List results reads every result, whichever run returned it.
- Webhook events describes
monitor.run.completedandmonitor.run.failed.
Authorizations
Path Parameters
Response
The run