Skip to main content
GET
Get a fleet runner

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.

Response

OK

One runner with its live and lifetime counters.

admin_state
enum<string>
required

Operator-controlled admission state.

Available options:
active,
cordoned,
draining,
drained,
revoked
created_at
integer<int64>
required

Enrolment instant in epoch milliseconds.

degraded
boolean
required

Whether the assignment exceeds the reported capability.

host_id
string
required

Stable host identity supplied at enrolment.

id
string
required

Canonical runner identifier.

labels
string[]
required

Placement labels.

last_seen_at
integer<int64>
required

Last heartbeat instant in epoch milliseconds.

liveness
enum<string>
required

Runtime state derived from heartbeat and leases.

Available options:
registered,
busy,
online,
offline
sandbox_tier
string
required

Assigned isolation tier spelling.

active_fleet_count
integer<int64>
required

Fleets represented by live leases.

active_lease_count
integer<int64>
required

Live leases currently held.

leases_acquired
integer<int64>
required

Lifetime acquired count.

leases_expired
integer<int64>
required

Lifetime expired count.

leases_failed
integer<int64>
required

Lifetime failed count.

leases_succeeded
integer<int64>
required

Lifetime successful count.

achievable
null | object

Capability report most recently supplied by the host.

assigned_policy
null | object

Policy currently assigned to the host.

degraded_reason
string | null

Stored explanation for a degraded verdict.

selftest
null | object

Latest complete self-test report.

selftest_completed_at
integer<int64> | null

Latest self-test completion instant.

selftest_requested_at
integer<int64> | null

Outstanding self-test request instant.