Skip to main content
GET
List fleet runner events

Authorizations

Authorization
string
header
required

Obtain a token via the CLI auth flow (POST /v1/auth/sessions) or GitHub OAuth

Path Parameters

runner_id
string
required

UUIDv7 of the runner.

Query Parameters

starting_after
string

An opaque cursor from a previous page's next_cursor.

limit
string

Rows per page (1-100).

event_type
string

Filter to one runner event type, or a comma-separated set returning the union (multi-value equality). Allowed tags: runner_registered, runner_online, runner_offline, lease_acquired, lease_released, runner_cordoned, runner_draining, runner_drained, runner_revoked. An unrecognised tag or an empty value refuses the whole request.

since
string

Lower bound on occurred_at, epoch milliseconds (inclusive).

until
string

Upper bound on occurred_at, epoch milliseconds (inclusive). Must be >= since.

Response

OK

A page of runner history.

items
object[]
required

The rows in this page.

total
integer<int64>
required

Total rows matching the query.

next_cursor
string | null

Cursor for the next page, or null at the end.