Create a sandbox - Runtools.ai

curl --request POST \ --url https://api.runtools.ai/v1/sandboxes \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "template": "base-ubuntu" } '

{ "data": { "id": "sandbox-abc123def456", "name": "<string>", "tags": [ "<string>" ], "template": "<string>", "ownerUserId": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "ownerDisplayName": "<string>", "ownerEmail": "<string>", "projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "mounts": [ { "workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "path": "/workspace", "readOnly": true } ], "hasWritableWorkspaceMount": true, "sshReady": true, "vncReady": true, "ip": "<string>", "publicIp": "<string>", "sshAccessConfigured": true, "vncUrl": "<string>", "resources": { "vcpus": 2, "memory": "4GB", "disk": "10GB" }, "createdAt": "2023-11-07T05:31:56Z" } }

curl --request POST \ --url https://api.runtools.ai/v1/sandboxes \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "template": "base-ubuntu" } '

Authorizations

Authorization

string

header

required

WorkOS session token or RunTools API key (rt_live_* / rt_test_*). Used in Authorization: Bearer <token> header.

Body

application/json

template

string

required

Example:

"base-ubuntu"

name

string

mounts

object[]

Show child attributes

idleTimeout

integer

Idle pause timeout, in seconds. 0 disables auto-pause.

Example:

600

resources

object

Show child attributes

env

object

Show child attributes

metadata

object

sshKeys

string<uuid>[]

SSH key IDs to inject (resolved server-side).

rootPassword

string

Optional root password (less secure than keys).

Response

Sandbox created.

data

object

Show child attributes