KLklavis-ai
local-sandbox

Get URL to upload your data

Changed on

Generates a signed URL to upload a tar.gz archive containing your workspace files. Once uploaded, use the /initialize endpoint to unpack it into the sandbox.

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

Request

  • Base URL
    https://api.klavis.ai
  • Auth
    HTTP bearer

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. Use 'asia' for users in China/Asia to upload to a nearby bucket (lower latency). The file is accessible from any region over Google's private backbone. Defaults to 'us'.

Response

Successful Response

upload_urlstring required

Signed GCS URL to PUT the tar.gz archive to

expires_in_minutesinteger required

Minutes until the upload URL expires

Changes