Skip to content

List All Schedule Runs

GET/v1/deployment_runs

List durable DeploymentRun records across every Schedule, with optional Schedule, Agent, time, outcome, trigger, and error filters.

Query parameters

Optional<string>deployment_id

Filter by the underlying Schedule Deployment ID.

Optional<string>agent_id

Filter by Agent ID.

Optional<string · RFC 3339>created_at[gt]

Created strictly after this timestamp.

Optional<string · RFC 3339>created_at[gte]

Created at or after this timestamp.

Optional<string · RFC 3339>created_at[lt]

Created strictly before this timestamp.

Optional<string · RFC 3339>created_at[lte]

Created at or before this timestamp.

Optional<boolean>has_error

Select runs with or without a recorded error.

Optional<schedule | manual[]>trigger_type

Repeat or comma-separate values.

Optional<pending | succeeded | failed[]>status

Repeat to select creation outcomes. Status is a filter but is not included in the response object.

Optional<integer>limit

Page size from 1 to 1000.

Default: 20

Optional<string>page

Opaque next_page cursor from the previous response.

API resource names

The product calls these Schedule runs. The compatibility API returns DeploymentRun objects with drun_* IDs.