---
title: "List runner locations"
method: GET
path: "/api/v3/workspaces/{workspace}/runners"
tags: ["Workspace Configuration"]
---

# List runner locations

`GET /api/v3/workspaces/{workspace}/runners`

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

## Path parameters

- `workspace` string, required

## Response `200`

Runner locations with per-pool worker status

- AuthorizedRunner[]
  - `name` string — Runner/location display name.
  - `value` string — Location identifier (`{workspace}--{location}`).
  - `health` 'online' | 'stale' | 'unknown' — Derived from heartbeat freshness.
  - `lastHeartbeat` string, date-time, nullable
  - `secondsSinceHeartbeat` number, nullable
  - `workerPools` object, nullable — Codebundle worker pools on this runner, keyed by pool id; each value reports the pool's live worker health and throughput.

---

[API](https://skmtc.dev/runwhen/apis/runwhen-platform-api.md) · [All operations](https://skmtc.dev/runwhen/apis/runwhen-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/runwhen/runwhen-platform-api/revisions/9d1a64d4b1c1/schema)