Skip to main content
GET
List code runs

Authorizations

Authorization
string
header
required

API key (dh_live_...) or Auth0 JWT token

Headers

X-DevHelm-Client
string

Calling surface and version, e.g. cli/1.4.0 or sdk-js/2.0.0

Query Parameters

phase
string

Filter by run phase; not_finished excludes finished runs

outcome
string

Outcomes, repeated or comma-separated; not_passed includes retries

region
string

Filter by probe region

source
string

Filter by what triggered the run

environmentId
string<uuid>

Only return runs executed in this environment

from
string<date-time>

Inclusive enqueue lower bound (default last 24 hours; clamped to 90 days)

to
string<date-time>

Inclusive enqueue upper bound (default now)

q
string

Substring match on monitor name or headline

cursor
string

Opaque cursor from the previous page

limit
integer<int32>

Page size (1–100, default 50)

Required range: 1 <= x <= 100
monitorId
string<uuid>

Only runs for this monitor

revisionId
string<uuid>

Only runs for this revision

monitorType
string

Monitor type: BROWSER or MULTI_STEP_API

incidentId
string<uuid>

Runs in the incident window, intersected with from and to

branch
string

Exact branch from revision provenance

flaky
boolean

Select monitors currently flaky over the last seven days

sessionId
string

Caller-provided CI session identifier

evaluationCycleId
string<uuid>

Only runs in this evaluation cycle, including retries

excludeSource
string

Exclude this source; omitted preserves all sources

sort
string

Enqueue order: asc or desc (default: desc)

step
integer<int32>

Zero-based failed step index; requires monitor and caseIndex

Required range: x >= 0
caseIndex
integer<int32>

Zero-based case index qualifying the failed step

Required range: x >= 0
adhoc
boolean

Include ad-hoc validation runs that have no monitor (default: false)

bucket
string

Histogram width: 30m, 1h or 1d; at most 1000 buckets

Response

OK

Cursor-paginated response for time-series and append-only data

data
object[]
required

Items on this page

hasMore
boolean
required

Whether more results exist beyond this page

nextCursor
string | null

Opaque cursor for the next page; null when there are no more results