Skip to main content
GET
List runner activity

Authorizations

Authorization
string
header
required

Send a dashboard session token, an account API key (agt_t), or a command-line credential (afc_) as a Bearer token. Each endpoint lists accepted credential types.

Path Parameters

runner_id
string
required

Runner identifier (version 7 universally unique identifier, or UUID).

Query Parameters

starting_after
string

Use the previous response's next_cursor unchanged.

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, an RFC 3339 instant (inclusive).

until
string

Upper bound on occurred_at, an RFC 3339 instant (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.