`GET /api/runners/config` — read the runner-subsystem config (system-admin). Exposes `hub_mode_enabled` (the `SUPACLOUD_HUB_MODE` runtime switch) and `least_loaded_dispatch` (the RUNG 4 lever) so the fleet UI can render both.
const url = 'https://example.com/api/runners/config';const options = {method: 'GET'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://example.com/api/runners/configResponses
Section titled “Responses”Fleet config (hub-mode + least-loaded)
Read-only fleet-config status, surfaced so the runners UI can show how the fleet dispatches. Both are instance-global levers.
object
Whether SUPACLOUD_HUB_MODE is enabled on the server. Runners only
receive dispatched work when this is true.
ADR 0046 RUNG 4 — whether weighted least-loaded dispatch ordering is on
(the persisted global dispatch_least_loaded switch; default off = RUNG-0
registry order).
ADR 0046 Phase 0 (decision #9) — whether org/workspace owners may onboard
edge runners scoped to workspaces they own (the persisted global
runner_onboarding_by_owner switch; default off = system-admin-only
onboarding).
ADR 0046 RUNG 4c — whether per-workspace fairness admission control is on
(the persisted global workspace_fairness switch; default off = no admission
control, byte-identical claim). When on, a single workspace cannot monopolise
a shared runner pool — over-share work waits queue-pending at claim time
(the runner skips claiming it) instead of being run.
Examplegenerated
{ "hub_mode_enabled": true, "least_loaded_dispatch": true, "owner_onboarding_enabled": true, "workspace_fairness_enabled": true}Authentication required
The canonical JSON body of every error response — the single source of truth
the frontend binds to. Every AppError serializes as this exact shape, and
the generated OpenAPI component ApiErrorBody (with its ErrorCode enum) is
what the frontend error schema is generated from, so there is no hand-written
error schema on either end.
object
Machine-readable, stable error code.
Present only on a quota-exceeded 403 — the inline upgrade-CTA payload.
object
The entitlement feature key that was hit, e.g. apps.max_count.
The plan’s limit for this key.
Where to send the user to upgrade.
Current usage (count or bytes, per the key).
Human-readable message (the server’s English text; the client may localize
by code).
Example
{ "code": "not_found"}Permission denied
The canonical JSON body of every error response — the single source of truth
the frontend binds to. Every AppError serializes as this exact shape, and
the generated OpenAPI component ApiErrorBody (with its ErrorCode enum) is
what the frontend error schema is generated from, so there is no hand-written
error schema on either end.
object
Machine-readable, stable error code.
Present only on a quota-exceeded 403 — the inline upgrade-CTA payload.
object
The entitlement feature key that was hit, e.g. apps.max_count.
The plan’s limit for this key.
Where to send the user to upgrade.
Current usage (count or bytes, per the key).
Human-readable message (the server’s English text; the client may localize
by code).
Example
{ "code": "not_found"}Structured server error
The canonical JSON body of every error response — the single source of truth
the frontend binds to. Every AppError serializes as this exact shape, and
the generated OpenAPI component ApiErrorBody (with its ErrorCode enum) is
what the frontend error schema is generated from, so there is no hand-written
error schema on either end.
object
Machine-readable, stable error code.
Present only on a quota-exceeded 403 — the inline upgrade-CTA payload.
object
The entitlement feature key that was hit, e.g. apps.max_count.
The plan’s limit for this key.
Where to send the user to upgrade.
Current usage (count or bytes, per the key).
Human-readable message (the server’s English text; the client may localize
by code).
Example
{ "code": "not_found"}