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

id
string<uuid>
required

Runner id (UUIDv7).

Response

The runner.

A single runner as the operator plane reads it. Carries the summary fields (including the assigned-vs-achievable policy pair and the degraded verdict), a live-work snapshot, and lifetime counters from durable lease and event rows. The auth token_hash and stored auth state are never returned.

degraded
boolean
required

True when the assigned policy exceeds what the host reported it can enforce (or no report has arrived). A degraded runner is issued no leases.

id
string<uuid>
required
host_id
string
required
sandbox_tier
enum<string>
required

Isolation strength the operator assigns to a runner. The host applies it and reports what it can deliver. A host that cannot meet the assignment is marked degraded and receives no work. Only tiers with real enforcement are assignable.

Available options:
landlock_full,
container_nested,
dev_none
admin_state
enum<string>
required

Operator setting. Only active accepts runner requests.

Available options:
active,
cordoned,
draining,
drained,
revoked
liveness
enum<string>
required

Derived runtime liveness. registered = minted, never seen; busy = holds a live lease; online = heartbeat fresh; offline = heartbeat stale.

Available options:
registered,
busy,
online,
offline
labels
string[]
required
last_seen_at
integer<int64>
required

Epoch milliseconds of the last heartbeat; 0 if never seen.

created_at
integer<int64>
required

Epoch milliseconds the runner was registered.

active_lease_count
integer<int64>
required

Leases currently live (status active and deadline in the future). A stale active row past its deadline counts as neither live nor expired until reclaim marks it.

active_fleet_count
integer<int64>
required

Distinct fleets across the live leases only.

leases_acquired
integer<int64>
required

Every lease this runner has ever been issued (lifetime, from durable rows).

leases_succeeded
integer<int64>
required

Reported leases whose Fleet event settled processed.

leases_failed
integer<int64>
required

Reported leases whose Fleet event settled fleet_error.

leases_expired
integer<int64>
required

Leases the runner stopped renewing; the work was re-leased to another runner.

assigned_policy
object | null

The assignment this runner must satisfy. Null only for a runner enrolled before policy assignment existed; such a runner reads degraded until an operator assigns a policy.

achievable
object | null

The host's last capability report. Null until the runner's first report arrives.

degraded_reason
string | null

The specific missing mechanism (for example cgroup controllers not delegated), mapping to a step in the runner bootstrap playbook. Null when not degraded.