Basic Execution
POST /v1/agents/runtime/{runtime_id}/code/run
from gravixlayer import GravixLayer
client = GravixLayer() # defaults to cloud="aws", region="us-east-1"
sandbox = client.runtime.create() # defaults to template="base-small"
result = sandbox.run_code(
code="console.log('Hello from JavaScript')",
language="javascript",
)
print(result.text) # Hello from JavaScript
sandbox.kill()
import { GravixLayer } from 'gravixlayer';
const client = new GravixLayer(); // defaults to cloud="aws", region="us-east-1"
const sandbox = await client.runtime.create(); // defaults to template="base-small"
const result = await sandbox.runCode('console.log(\'Hello from JavaScript\')', { language: 'javascript' });
console.log(result.text); // Hello from JavaScript
await sandbox.kill();
cat > /tmp/hello.js <<'EOF'
console.log('Hello from JavaScript')
EOF
gravixlayer runtime run "$RT" /tmp/hello.js --timeout 300
curl -sS -X POST "https://api.gravixlayer.ai/v1/agents/runtime/$RT/code/run" \
-H "Authorization: Bearer $GRAVIXLAYER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"code": "console.log('\''Hello from JavaScript'\'')",
"language": "javascript",
"timeout": 300
}' | jq .
JavaScript execution requires passing
language="javascript". The default is python. The CLI infers language from the .js file extension.Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
code | string | Yes | JavaScript source code |
language | string | Yes | Must be "javascript" |
context_id | string | No | Reuse a persistent code context |
timeout | integer | No | Execution timeout in seconds |
Response
| Field | Type | Description |
|---|---|---|
text | string | Combined stdout output |
success | boolean | True if no execution error |
error | object | Error details (name, value, traceback) |