Get a sandbox
Gets a sandbox by name.
Authorizations
Send Authorization: Bearer <api_key>. The legacy Authorization: Api-Key <api_key> scheme is also accepted.
Headers
Optional team ID. Must match the team_id query parameter when both are supplied. If neither selector is supplied, defaults to the caller's only accessible team. Callers with multiple accessible teams must select a team. Requests without access to any team are forbidden.
1Path Parameters
Immutable sandbox name returned by creation.
1"baseten-api-review-0916"
Query Parameters
Optional team ID. Must match X-Team-Id when both are supplied. If neither selector is supplied, defaults to the caller's only accessible team. Callers with multiple accessible teams must select a team. Requests without access to any team are forbidden.
1Reveal environment variable values for workspace administrators. Defaults to false. Callers without the admin role receive masked values even when true.
Response
Successful operation.
Sandbox resource with configuration and server-managed fields at the root. No metadata, spec, or runtime wrapper.
Immutable sandbox name, provided by the client or generated by the server, used in sandbox_name path parameters.
"baseten-api-review-0916"
Base URL of this sandbox's execution API, always present on successful creation. The URL is assigned before deployment completes; inspect status for readiness. Use this exact returned URL; do not reconstruct its hostname. Authenticate requests with your authentication token using Authorization: Bearer . Do not send the Baseten API key directly. No additional routing headers are required. Fetch GET {url}/swagger/doc.json with that header for the API reference served by this sandbox. For example, POST {url}/process with Content-Type: application/json and {"command":"echo hello","waitForCompletion":true} executes a command and waits for its result. Execution API fields use camelCase, independently of this API's snake_case fields.
"https://sbx-baseten-api-review-0916-esb1qo.us-pdx-1.b10.run"
Sandbox deployment status.
DEPLOYING, DEPLOYED, FAILED, DEACTIVATING, DEACTIVATED, DELETING, TERMINATED, ARCHIVING, ARCHIVED, UNARCHIVING, BUILDING, UPLOADING "DEPLOYED"
Time the sandbox was created.
"2026-09-16T21:26:58.545765901Z"
Lifecycle configuration controlling automatic sandbox deletion based on idle time, max age, or specific dates
Network configuration for a sandbox including subnet, domain filtering, and proxy settings
Region where the sandbox runs (for example us-pdx-1 or eu-lon-1). When omitted at creation, the closest region is selected.
"us-pdx-1"
Environment variables injected into the sandbox.
Image reference including its tag. Built-in image references are returned in the canonical baseten/ namespace. Use baseten/base-image:latest to get started with the built-in sandbox execution API. This image is available directly without building, pushing, or listing images through GET /v1/sandboxes/images.
"baseten/base-image:latest"
Memory allocation in megabytes. Also determines CPU allocation (CPU cores = memory in MB / 2048, e.g., 4096MB = 2 CPUs).
x >= 14096
Set of ports for a resource
Caller-owned identifier for external lookups. Max 64 chars, alphanumeric + dash.
64^[A-Za-z0-9-]+$"api-review-20260916-001"
Key-value pairs for organizing and filtering resources. Labels can be used to categorize resources by environment, project, team, or any custom taxonomy.
Time the sandbox was last updated.
"2026-09-16T21:31:13Z"
User or service account that created the sandbox.
"sandbox-automation"
User or service account that last updated the sandbox.
"sandbox-automation"
Time the sandbox was last used.
"2026-09-16T21:31:13Z"
Seconds remaining before automatic deletion, when expiration is configured.
x >= 086400