Skip to main content
GET
List Monitor Events

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

monitor_id
string
required

Query Parameters

cursor
string | null

Pass next_cursor from a previous response to retrieve more events.

event_group_id
string | null

Filter to a single execution. Values come from event_group_id in webhook events and listed events. Pagination params are ignored when set.

include_completions
boolean
default:false

When true, include completion events for executions that ran but detected no material changes. Useful for auditing execution history.

limit
integer | null

Maximum number of events to return. Defaults to 20. Between 1 and 100.

Required range: 1 <= x <= 100

Response

Monitor events retrieved successfully.

Paginated list of monitor events, newest first.

events
(MonitorEventStreamEvent · object | MonitorSnapshotEvent · object | MonitorCompletionEvent · object | MonitorErrorEvent · object)[]
required

Monitor events returned by this request, ordered newest first.

Append-only event from an event_stream monitor.

Each event represents a distinct material change detected since the previous execution. Events are net-new relative to the cursor; clients should treat them as an append-only log.

next_cursor
string | null

Pass as cursor to retrieve more events. Absent when there are no more events.

warnings
Warning · object[] | null

Execution caveats for this page of events, e.g. compute limits.