Delete a sandbox
Deletes a sandbox and its local data.
202 with status DELETING means the API accepted the request;
deletion continues asynchronously.
Related guide: Manage sandboxes.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.
1Response
Request accepted.
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