KLklavis-ai
local-sandbox

Execute a script inside the sandbox

Changed on

Computes the internal GCS archive URL from the sandbox ID and execution name, then triggers the sandbox executor to download, install dependencies, and execute main.py. The execution runs in the background — poll /execution-logs to track progress. The archive must first be uploaded via /execution-upload-url.

post/local-sandbox/{local_sandbox_id}/execute

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 where the archive was uploaded. Defaults to 'us'.

Request body

execution_namestring required

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

Response

Successful Response

messagestring required
execution_namestring required

Changes