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

Initialize sandbox from your uploaded data

cURL

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

200

{
  "sandbox_id": "<string>",
  "status": "idle",
  "message": "<string>"
}

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 where the archive was uploaded. Must match the region used in the /upload-url call. Defaults to 'us'.

Available options: us, asia

Response

200

application/json

Successful Response

Response model for sandbox initialization

sandbox_id · string · required

Sandbox identifier

status · enum<string> · required

Current status

Available options: idle, occupied, error

message · string · required

Initialization result message