Quickstart

# Requires: curl, jq
export AAS_API_KEY="aas_sk_your_key_here"

# 1. Create a sandbox. Returns when it is ready (status: running).
SBX=$(curl -sS -X POST https://sandbox-as-a-service.com/v1/sandboxes \
  -H "Authorization: Bearer $AAS_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: quickstart-$(date +%s)" \
  -d '{"size":"small","timeout_minutes":15}' | jq -r .id)

echo "sandbox: $SBX"

# 2. Run a command inside it.
curl -sS -X POST https://sandbox-as-a-service.com/v1/sandboxes/$SBX/exec \
  -H "Authorization: Bearer $AAS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"command":"python3 -c \"print(6*7)\"","timeout_ms":30000}' | jq

# 3. Destroy it. Billing stops here.
curl -sS -X DELETE https://sandbox-as-a-service.com/v1/sandboxes/$SBX \
  -H "Authorization: Bearer $AAS_API_KEY" | jq

# pip install requests
import os
import requests

API = "https://sandbox-as-a-service.com/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['AAS_API_KEY']}"}

# 1. Create a sandbox. This call blocks until it is ready.
sandbox = requests.post(
    f"{API}/sandboxes",
    headers=HEADERS,
    json={"size": "small", "timeout_minutes": 15},
    timeout=600,
).json()
print("sandbox:", sandbox["id"], sandbox["status"])

try:
    # 2. Run a command.
    result = requests.post(
        f"{API}/sandboxes/{sandbox['id']}/exec",
        headers=HEADERS,
        json={"command": "python3 -c 'print(6 * 7)'", "timeout_ms": 30000},
        timeout=120,
    ).json()
    print(result["stdout"].strip())   # -> 42
    print(result["exit_code"])        # -> 0
finally:
    # 3. Always destroy the sandbox, including on failure.
    requests.delete(f"{API}/sandboxes/{sandbox['id']}", headers=HEADERS, timeout=120)

// Node.js 18+ (global fetch). No dependencies.
const API = "https://sandbox-as-a-service.com/v1";
const headers = {
  Authorization: `Bearer ${process.env.AAS_API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Create a sandbox. This call blocks until it is ready.
const sandbox = await fetch(`${API}/sandboxes`, {
  method: "POST",
  headers,
  body: JSON.stringify({ size: "small", timeout_minutes: 15 }),
}).then((r) => r.json());

console.log("sandbox:", sandbox.id, sandbox.status);

try {
  // 2. Run a command.
  const result = await fetch(`${API}/sandboxes/${sandbox.id}/exec`, {
    method: "POST",
    headers,
    body: JSON.stringify({
      command: "node -e 'console.log(6 * 7)'",
      timeout_ms: 30000,
    }),
  }).then((r) => r.json());

  console.log(result.stdout.trim()); // -> 42
  console.log(result.exit_code);     // -> 0
} finally {
  // 3. Always destroy the sandbox, including on failure.
  await fetch(`${API}/sandboxes/${sandbox.id}`, { method: "DELETE", headers });
}