List sandboxes
Returns sandboxes in the workspace. Each sandbox includes its configuration, status, and endpoint URL. Terminated sandboxes are hidden by default; pass showTerminated=true to include them. Starting with API version 2026-04-28 the response is wrapped in {data, meta} and supports cursor pagination via the cursor and limit query parameters; older versions keep returning a bare array of all sandboxes.
Authorizations
OAuth2 authentication with JWT tokens
Query Parameters
If true, include terminated sandboxes in the response. Defaults to false.
Opaque cursor returned by a previous response's meta.nextCursor. Only valid for the same query (workspace + filters); the server rejects cursors bound to a different query or older than 24h. Omit on the first page.
Maximum number of items to return per page. Defaults to 50, clamped to 200.
1 <= x <= 200Sort spec, formatted as <key>:<direction>. Allowed values are createdAt:desc (default), createdAt:asc, name:asc, name:desc. The cursor fingerprint is bound to the sort, so a cursor opened with one value cannot be reused with another. Only honoured starting on Blaxel-Version 2026-04-28.
createdAt:desc, createdAt:asc, name:asc, name:desc Substring search across metadata.name, metadata.displayName and labels (keys + values). Trimmed and lowercased server-side; queries shorter than 2 characters fall back to the unfiltered listing. Bound into the cursor fingerprint so a cursor opened with one query cannot be reused with another. Only honoured starting on Blaxel-Version 2026-04-28.
200Start from a known pagination boundary. end is only supported for createdAt listings (asc or desc) and returns the tail page directly without walking every cursor from the first page.
end Filter sandboxes by external ID. When set, only sandboxes matching this caller-owned identifier are returned.
Response
successful operation
Cursor-paginated list of sandboxes. Returned starting with API version 2026-04-28; older API versions return a bare array.
