Skip to main content
POST
/
v1
/
agents
/
sandboxes
Create Sandbox
curl --request POST \
  --url https://api.gravixlayer.com/v1/agents/sandboxes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "provider": "gravix",
  "region": "eu-west-1",
  "template": "python-base-v1",
  "timeout": 600
}
'
{
  "sandbox_id": "<string>",
  "provider": "<string>",
  "region": "<string>",
  "template": "<string>",
  "status": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "expires_at": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

API key authentication. Get your API key from the Gravix Layer Dashboard.

Body

application/json
​
provider
enum<string>
required

Available Provider

Gravix

Coming Soon: AWS, GCP, Azure

Available options:
gravix
​
region
enum<string>
required

Cloud region. Choose a region that corresponds to the selected provider.

Available regions:

ProviderRegionsDescription
Gravixeu-west-1 (London)Gravix AI Cloud

Coming Soon:

ProviderRegionsDescription
AWSus-east-1 (Virginia)Amazon Web Services
GCPus-east1 (South Carolina)Google Cloud Platform
Azureeastus (Virginia)Microsoft Azure
Available options:
eu-west-1
​
template
enum<string>
required

Available Templates

python-base-v1: A basic Python environment with essential libraries installed.

javascript-base-v1: A basic JavaScript environment with Node.js and npm installed.

Available options:
python-base-v1,
javascript-base-v1
​
timeout
integer
default:600

Sandbox timeout in seconds (default: 600s)

Response

200 - application/json

Sandbox created

​
sandbox_id
string
​
provider
string
​
region
string
​
template
string
​
status
string
​
created_at
string<date-time>
​
expires_at
string<date-time>