---
title: "List connected self-hosted workers"
method: GET
path: "/agent/connected-self-hosted-workers"
tags: ["agent"]
---

# List connected self-hosted workers

`GET /agent/connected-self-hosted-workers`

Retrieve currently connected self-hosted workers for the authenticated principal's team.
Worker presence is derived from worker websocket heartbeats and may be briefly stale.

## Response `200`

List of currently connected self-hosted workers

- ListConnectedSelfHostedWorkersResponse
  - `workers` ConnectedSelfHostedWorker[], required — Connected self-hosted workers for the authenticated principal's team
    - `worker_host` string, required — Logical host identifier provided by the self-hosted worker
    - `connection_count` integer, required — Number of active websocket connections currently observed for this worker host
    - `connected_at` string, date-time, required — Earliest connection timestamp across active connections for this worker host
    - `last_seen_at` string, date-time, required — Most recent heartbeat timestamp across active connections for this worker host

## Other responses

- `401` — Authentication required
- `403` — Not authorized to list connected workers

---

[API](https://skmtc.net/warp/apis/oz-agent-api.md) · [All operations](https://skmtc.net/warp/apis/oz-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/warp/oz-agent-api/versions/97be876c33e3/schema)