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

## Changes

- **2026-08-15** `a0daf9e59774` — 4 info
  - added the optional property `auth_url` to the response with the `401` status
  - added the optional property `auth_url` to the response with the `403` status
  - added the optional property `provider` to the response with the `401` status
  - added the optional property `provider` to the response with the `403` status

[Change history](https://skmtc.dev/warp/apis/oz-agent-api/changes/agent/connected-self-hosted-workers/get.md)

---

[API](https://skmtc.dev/warp/apis/oz-agent-api.md) · [All operations](https://skmtc.dev/warp/apis/oz-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/warp/oz-agent-api/revisions/a0daf9e59774/schema)