v1

latestOpenAPI 3.1.02026-08-047777149.4 KB

Workspace Configuration

List runner locations

Runner locations where scripts/tasks can execute (used as the location for author runs and runbooks). Each location includes heartbeat-derived health and, per codebundle worker pool, live worker health and throughput under workerPools.

get/api/v3/workspaces/{workspace}/runners

Path parameters

workspacestring required

Workspace short name

Response

Runner locations with per-pool worker status

namestring

Runner/location display name.

valuestring

Location identifier ({workspace}--{location}).

health'online' | 'stale' | 'unknown'

Derived from heartbeat freshness.

lastHeartbeatstring date-time nullable

secondsSinceHeartbeatnumber nullable

workerPoolsobject nullable

Codebundle worker pools on this runner, keyed by pool id; each value reports the pool's live worker health and throughput.