Execute command - Katakate

Endpoint: POST /api/v1/sandboxes/{name}/exec

namestringrequired#

Sandbox name

namespacestring#

Namespace

Default: "default"

commandstringrequired#

Shell command to execute

Semantics#

exit_code: 0 on success, non-zero when the command fails.
stdout/stderr: Raw streams captured from the process; may include newlines.
duration_ms: Client-observed duration including stream lifecycle.

Examples#

curl -X POST "$BASE/api/v1/sandboxes/my-sandbox/exec?namespace=default" \  -H "Authorization: Bearer $K7_API_KEY" \  -H "Content-Type: application/json" \  -d '{"command": "apk add --no-cache curl && curl -I https://example.com"}'

Error example (non-zero exit):

{  "data": {    "exit_code": 2,    "stdout": "",    "stderr": "some error...",    "duration_ms": 37  }}