Skip to main content
Execute code in multiple programming languages with persistent state management and comprehensive error handling.

​
Supported Languages

Python

Python 3.11 with data science libraries

JavaScript/Node.js

Node.js 20 LTS with popular packages

Shell/Bash

Execute system commands and scripts

More Coming Soon

R, Julia, Go in development

​
Basic Request

curl -X POST https://api.gravixlayer.com/v1/agents/sandboxes/{sandbox_id}/code/run \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "import math\nresult = math.sqrt(16)\nprint(f\"Result: {result}\")",
    "language": "python"
  }'

​
Request Parameters

ParameterTypeRequiredDescription
codestringYesCode to execute
languagestringNoProgramming language (default: “python”)
timeoutintegerNoTimeout in seconds (default: 30)

​
Response

{
  "execution_id": "exec_abc123",
  "results": {
    "stdout": [
      {
        "type": "stdout",
        "line": "Result: 4.0",
        "timestamp": "2025-01-27T10:30:00Z"
      }
    ]
  },
  "error": null,
  "logs": {
    "stdout": ["Result: 4.0"],
    "stderr": []
  }
}

​
Key Features

  • Persistent State: Variables and imports remain between executions
  • Output Handling: Capture stdout, stderr, and return values
  • Error Handling: Detailed error messages and stack traces
  • Resource Limits: Protection against resource exhaustion

​
Quick Examples

​
Python Data Analysis

import pandas as pd
data = pd.DataFrame({'name': ['Alice', 'Bob'], 'age': [25, 30]})
print(f"Average age: {data['age'].mean()}")

​
JavaScript Web Server

const express = require('express');
const app = express();
app.get('/status', (req, res) => res.json({status: 'ok'}));
console.log('Server configured');

​
Next Steps

Run Python Code

Execute Python with data science libraries

Run JavaScript Code

Execute Node.js with npm packages

Run Shell Commands

Execute system commands and scripts

Read Files

Read files from sandbox filesystem