List workers

GET

/api/v2/workers

Self-hosted only. The scale-mode workers registered with this install, from Postgres: each one's host, state, jobs and last heartbeat. See Scale mode.

Authorization

apiKey

headerAuthorizationBearer <token>

An API key, sk-syn- and 32 characters. On SynapseOrch Cloud an owner or admin makes it under Settings → Developer; on a self-hosted install, under Settings → API Keys.

Response Body

The workers.

application/json

response

[index: integer]?

Self-hosted only

curl -X GET "http://localhost:3000/api/v2/workers" \  -H "Authorization: Bearer sk-syn-..."

[  {    "worker_id": "w-1bac81fcfb63-35985d6e",    "hostname": "worker-1",    "address": "10.0.0.12",    "status": "online",    "active_jobs": 2,    "max_jobs": 10,    "last_heartbeat": "2026-10-04 17:52:14+00:00",    "mcp_disabled": []  }]