Skip to main content
Create a new isolated execution environment for running code and managing files. 
curl -X POST https://api.gravixlayer.com/v1/agents/sandboxes \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "gravix",
    "region": "eu-west-1",
    "template": "python-base-v1"
  }'

​
Request Parameters

ParameterTypeRequiredDescription
providerstringYesCloud provider (“gravix”, “aws”, “gcp”)
regionstringYesCloud region (e.g., “us-east-1”)
templatestringNoTemplate to use (default: “python-base-v1”)
timeoutintegerNoTimeout in seconds (default: 300, max: 3600)
env_varsobjectNoEnvironment variables
metadataobjectNoCustom metadata tags

​
Response

{
  "sandbox_id": "550e8400-e29b-41d4-a716-446655440000",
  "template": "python-base-v1",
  "status": "creating",
  "started_at": "2025-01-27T10:30:00Z",
  "timeout_at": "2025-01-27T10:35:00Z",
  "cpu_count": 2,
  "memory_mb": 2048
}

​
Available Templates

  • python-base-v1 - Python 3.11 with data science libraries
  • javascript-base-v1 - Node.js 20 LTS with popular packages

​
Custom Configuration

curl -X POST https://api.gravixlayer.com/v1/agents/sandboxes \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "gravix",
    "region": "eu-west-1",
    "template": "python-base-v1",
    "timeout": 1800,
    "env_vars": {
      "DEBUG": "true",
      "PYTHONPATH": "/home/user/libs"
    },
    "metadata": {
      "project": "data-analysis",
      "owner": "data-team"
    }
  }'

​
Next Steps

Execute Code

Run Python or JavaScript code in your sandbox

List Sandboxes

View all your sandboxes

Get Sandbox Info

Retrieve detailed sandbox information

Terminate Sandbox

Clean up resources when finished