Read a workspace's storage
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.
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/storage"{ "workspace": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "kind": "internal" }, "volumes": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "title": "string", "projectId": "5a8591dd-4039-49df-9202-96385ba3eff8", "environment": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string" }, "kind": "volume", "forkedFrom": { "volumeId": "9b13a6a1-9e32-41ed-a1c9-4cd00c4823c1", "checkpointId": "16673a5e-107b-463f-be42-5cfae1eaa8fe" }, "status": "string", "lifetimePolicy": "string", "ownerUserId": "283eeac5-beea-465a-80a5-763009480d0f", "lease": { "machineId": "9f61f395-8150-4531-9240-2cb221ad2692", "live": true, "expiresAt": "string" }, "checkpoints": { "count": 0, "lastDurableAt": "string" }, "lastDiskSample": { "machineId": "9f61f395-8150-4531-9240-2cb221ad2692", "usedBytes": 0, "totalBytes": 0, "sampledAt": "string" }, "createdAt": "string", "lastActivityAt": "string" } ], "volumeTotal": 0, "unavailable": [ { "field": "storedBytes", "reason": "not_metered", "message": "string" } ]}Read a workspace's usage at vendor cost, itemized GET
Needs `billing.read` at the workspace. The usage of the projects in the workspace now, for the billing period, line by line at each vendor's own rate, with the usage fee and the platform fee, which are displayed for transparency: nothing bills them yet. 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. An API key pinned to a workspace reads that workspace only, with `billing.read` in its own scopes; any other workspace, in this org or another, gets the same 404. No other API key may call it. Off until the workspace API is enabled for this deployment: until then it answers 404 to everyone.
Read a workspace's compute GET
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.