Get pool worker by ID via the Cloud Agents API

Retrieve a single pool worker by its ID with GET https://api.cursor.com/v0/private-workers/{id}. Official reference: Cloud Agents API → Get Worker By ID (Workers and Pools).

The Cloud Agents API v1 is in public beta. Paths 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. Availability: Beta (all plans) per the API overview.

Use this when you already know the worker id (for example pw_123 from a claim, or a workerId returned by List Workers) and need that one worker without paging the full list.

Path parameters

Param	Meaning
id	Unique identifier for the worker (for example, pw_123).

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

Response

The docs page shows the curl call and path parameter only; it does not publish a dedicated response example for Get Worker By ID. The endpoint returns a single pool worker. For the field shape of a worker object, use the List Workers response field table (workerId, isInUse, repoOwner, repoName, repoUrl, workspaceRootPath, connectedAtMs, userId, teamId, serviceAccountId, activeBcId, name). Confirm the live JSON against your own call or the OpenAPI specification linked from the same docs set.

Pair with Get Worker Summary (GET /v0/private-workers/summary) for aggregate counts, and with Claim A Pending Request when you reserved a specific workerId before start.