> For the complete documentation index, see [llms.txt](https://zumo.fusion.ac/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://zumo.fusion.ac/api-reference/http/get-workers.md).

# GET /replays/workers

List connected replay bots and whether they are busy.

**Authentication:** `API-Key` required

## Response

| Status | Description                |
| ------ | -------------------------- |
| `200`  | Worker list                |
| `401`  | Missing or invalid API key |

### `200` body

| Field                       | Type           | Description                   |
| --------------------------- | -------------- | ----------------------------- |
| `workers`                   | array          | Connected replay workers      |
| `workers[].socketId`        | string         | Socket id                     |
| `workers[].botId`           | string         | Worker id (e.g. `"replay-1"`) |
| `workers[].busy`            | boolean        | Currently recording           |
| `workers[].currentReplayId` | string \| null | Active replay id              |
| `workers[].connectedAt`     | number         | Connect time (ms epoch)       |

## Example

```bash
curl -s -H "API-Key: zk_your_key" "https://zed.fusion.ac/replays/workers"
```