# Sandy — Sandbox as a Service

> Isolated sandboxes for AI agents and LLM-generated code. Secure, fast, 10x cheaper than alternatives.

## API Base

https://sandbox-as-a-service.com/api

## Authentication

All endpoints require a Bearer token:
  Authorization: Bearer YOUR_API_KEY

## Core Endpoints

### Create a sandbox
POST /api/sandboxes
Body: { "enable_docker_socket": false }
Returns: { "sandboxId": "sb_xxxx", "url": "...", "upstream": "..." }

### Execute a command
POST /api/sandboxes/{id}/exec
Body: { "command": "echo Hello World" }
Returns: { "stdout": "...", "stderr": "...", "exitCode": 0 }

### List files
GET /api/sandboxes/{id}/files/list?path=/workspace
Returns: { "files": [...] }

### Read a file
GET /api/sandboxes/{id}/files/read?path=/workspace/file.txt
Returns: { "content": "..." }

### Write a file
POST /api/sandboxes/{id}/files/write
Body: { "path": "/workspace/file.txt", "content": "..." }

### Stream events
GET /api/sandboxes/{id}/events
Returns: Server-Sent Events stream

### Terminate a sandbox
POST /api/sandboxes/{id}/terminate
Returns: { "status": "terminated" }

## Sandbox Features

- 2-second warm-up time
- Configurable CPU, RAM, and disk
- Optional Docker socket
- Playwright + browsers pre-installed
- File upload and download
- VNC remote desktop access
- Per-sandbox network isolation

## Pricing

- Lite: 2 vCPU, 4 GB RAM, 40 GB SSD — $17/month
- Pro: 4 vCPU, 8 GB RAM, 80 GB SSD — $29/month
- Max: 8 vCPU, 16 GB RAM, 160 GB SSD — $59/month

## Links

- Website: https://sandbox-as-a-service.com
- API Docs: https://sandbox-as-a-service.com/docs
- OpenAPI Spec: https://sandbox-as-a-service.com/docs/openapi.json