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

id
string<uuid>
required

Runner id (UUIDv7).

Query Parameters

starting_after
string

An opaque cursor from a previous page's next_cursor.

limit
integer
default:50

Rows per page (1-100).

Required range: 1 <= x <= 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
integer<int64>

Lower bound on occurred_at, epoch milliseconds (inclusive).

until
integer<int64>

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

Response

A page of runner events.

items
object[]
required
total
integer<int64> | null
required

The filtered history's full count; stable across pages.

next_cursor
string | null
required

Cursor for the next page; null on the final page.