Skip to main content
GET
Read a runner

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).

Response

OK

One runner with its live and lifetime counters.

assigned_policy
object
required

Policy currently assigned to the host.

created_at
string<date-time>
required

Enrolment instant.

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
string<date-time>
required

Last heartbeat instant.

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.

status
enum<string>
required

Operator-controlled admission state.

Available options:
active,
cordoned,
draining,
drained,
revoked
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
object | null

Capability report most recently supplied by the host.

degraded_reason
string | null

Stored explanation for a degraded verdict.

selftest
object | null

Latest complete self-test report.

selftest_completed_at
string<date-time> | null

Latest self-test completion instant.

selftest_requested_at
string<date-time> | null

Outstanding self-test request instant.