v50

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-012124381.2 MB
local-sandbox

Initialize sandbox from your uploaded data

Extracts the uploaded tar.gz archive into the sandbox workspace. This must be called after successfully uploading the file using the URL from /upload-url.

post/local-sandbox/{local_sandbox_id}/initialize

Path parameters

local_sandbox_idstring required

The local sandbox identifier

The local sandbox identifier

Query parameters

region'us' | 'asia'

Region hint for GCS upload/download bucket selection.

Controls which GCS bucket is used for signed URLs so that users geographically closer to an edge bucket get faster transfers. The data is always pulled to the US GKE cluster over Google's private backbone after upload.

GCS bucket region where the archive was uploaded. Must match the region used in the /upload-url call. Defaults to 'us'.

Response

Successful Response

sandbox_idstring required

Sandbox identifier

status'idle' | 'occupied' | 'error' required

Status of a sandbox instance - matches database enum

messagestring required

Initialization result message