Read a workspace's compute
The machines of the workspace's projects, from those where the caller holds sandbox.read, with counts by status, and the regions machines can run in. The Macs that mount its environments, and which locations the workspace may run on, are not served yet, and are named in unavailable. A caller who cannot see the workspace (a member holding no project in it) gets the same 404 as a workspace that does not exist. API keys cannot call it. Off until the workspace API is enabled for this deployment: until then it answers 404 to everyone.
Authorization
bearerAuth A RemoteHost API key (rh_sk_...) or a user session token.
In: header
Path Parameters
Query Parameters
How many rows a list holds: 1 to 500, 100 by default. Disks and machines come most recently active first, preview links newest first, and egress project by project with each project's default environment first; the total says how many there are in all.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/orgs/string/workspaces/string/compute"{ "workspace": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "kind": "internal" }, "machines": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "projectId": "5a8591dd-4039-49df-9202-96385ba3eff8", "environment": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string" }, "volumeId": "9b13a6a1-9e32-41ed-a1c9-4cd00c4823c1", "status": "string", "template": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string" }, "profile": "string", "machineSize": "string", "size": { "vcpu": 0, "memoryGb": 0, "diskGb": 0 }, "location": { "region": "string", "vendor": "string", "selfHostedFleetId": "8573a143-ba38-49cd-a7aa-8daa512c642e" }, "labels": { "property1": null, "property2": null }, "endUserId": "string", "disk": { "usedBytes": 0, "totalBytes": 0, "sampledAt": "string" }, "createdAt": "string", "lastActivityAt": "string" } ], "summary": { "total": 0, "byStatus": { "property1": 0, "property2": 0 } }, "locations": [ { "id": "string", "label": "string", "locations": "string", "vendor": "string", "available": true, "isDefault": true } ], "unavailable": [ { "field": "macs", "reason": "not_metered", "message": "string" } ]}Read a workspace's storage GET
The durable disks of the environments in the workspace's projects, with their forks, checkpoints and last disk samples, from the projects where the caller holds `sandbox.read`. Stored bytes, this month's storage cost and storage backends are not served yet, and are named in `unavailable`. A caller who cannot see the workspace (a member holding no project in it) gets the same 404 as a workspace that does not exist. API keys cannot call it. Off until the workspace API is enabled for this deployment: until then it answers 404 to everyone.
Read a workspace's network GET
The preview links of the workspace's machines that still open, from the projects where the caller holds `sandbox.read`, and each environment's egress, from those where it holds `environments.read`. A workspace network (WireGuard, peers, Tailscale, private networks by label) and preview links' URLs are not served, and are named in `unavailable`. A caller who cannot see the workspace (a member holding no project in it) gets the same 404 as a workspace that does not exist. API keys cannot call it. Off until the workspace API is enabled for this deployment: until then it answers 404 to everyone.