Get pool worker summary via the Cloud Agents API

Return connected and in-use worker counts for the authenticated user and their team with GET https://api.cursor.com/v0/private-workers/summary. Official reference: Cloud Agents API → Get Worker Summary (Workers and Pools).

The Cloud Agents API v1 is in public beta. Paths under Workers and Pools keep the older private-workers name; they refer to the same Self-Hosted Machines workers. Authenticate with the pool's service account API key via Basic auth (-u "$CURSOR_API_KEY:") or Authorization: Bearer. Other API key types are rejected for these endpoints. Availability: Beta (all plans) per the API overview.

Use the summary to trigger scaling decisions when utilization is high. Durable pools stay registered after the last worker disconnects, so zero connected workers can still mean a registered pool waiting for capacity.

Request

curl --request GET \
  --url "https://api.cursor.com/v0/private-workers/summary" \
  -u "$CURSOR_API_KEY:"

Scaling check

The documented example reads teamSummary from the JSON body. When team.totalConnected > 0, utilization is team.inUse / team.totalConnected. Scale up when utilization is at or above 0.9:

const summary = await response.json();
const team = summary.teamSummary;
if (team && team.totalConnected > 0) {
  const utilization = team.inUse / team.totalConnected;
  if (utilization >= 0.9) {
    // Scale up: provision additional workers
  }
}

Pair this with List Workers (GET /v0/private-workers) when you need per-worker detail, and with List Pending Pool Requests when users are waiting for capacity.