Get URL to upload your data

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

Get URL to upload your data

cURL

curl --request POST \
  --url https://api.klavis.ai/local-sandbox/{local_sandbox_id}/upload-url \
  --header 'Authorization: Bearer <token>'

200

{
  "upload_url": "<string>",
  "expires_in_minutes": 123
}

Authorizations

Authorization · string · header · required

Your Klavis AI API key.

Path Parameters

local_sandbox_id · string · required

The local sandbox identifier

Query Parameters

region · enum<string> · default: us

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'.

Available options: us, asia

Response

200

application/json

Successful Response

Response for the upload URL endpoint.

upload_url · string · required

Signed GCS URL to PUT the tar.gz archive to

expires_in_minutes · integer · required

Minutes until the upload URL expires