v50

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

local-sandbox

Get a pre-signed URL to upload an execution archive

Returns a pre-signed GCS PUT URL so the caller can upload a tar.gz archive containing main.py, requirements.txt, etc. for later execution.

post/local-sandbox/{local_sandbox_id}/execution-upload-url

Path parameters

local_sandbox_idstring required

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 for the signed URL. Defaults to 'us'.

Request body

execution_namestring required

Logical name for this execution (e.g. 'init', 'eval_1')

Response

Successful Response

upload_urlstring required

Pre-signed GCS PUT URL to upload the archive (.tar.gz)

expires_in_minutesinteger required

Minutes until the upload URL expires