# codai Sandboxes API

**Canonical:** https://apis.io/apis/codai-ro/codai-ro-sandboxes-api/  
**Provider:** codai — https://apis.io/providers/codai-ro/  
**Base URL:** https://ai.codai.ro  
**Documentation:** https://docs.codai.ro/docs/api

codai Sandboxes API is one of 35 APIs that [codai](https://apis.io/providers/codai-ro/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Sandbox. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 6 JSON Schemas.

Agent sandboxes: isolated gVisor containers (backend `v2` by default: long-lived GKE pods with pause/resume, fork, a persistent Python kernel and preview URLs; `v1` on Cloud Run on request) with a persistent `/workspace` where agents run Python, bash and LibreOffice, then hand back files from `/workspace/out` as scanned, signed artifacts. No network by default (egress only through an allowlisting proxy), no codai secrets inside, every exec audited with a reproducibility receipt. Needs tool level `l3_sandbox`. Billing: v2 EUR 0.10 per running wall-clock hour after 5 free hours per user per month, paused snapshots EUR 0.05/GB-month; v1 EUR 0.10/exec-hour after 10 free hours.

## Operations (17)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/sandboxes` | Create a sandbox |
| GET | `/v1/sandboxes` | List your sandboxes |
| POST | `/v1/sandboxes/run` | Run once in a throwaway sandbox |
| GET | `/v1/sandboxes/{id}` | Get a sandbox |
| DELETE | `/v1/sandboxes/{id}` | Destroy a sandbox |
| POST | `/v1/sandboxes/{id}/exec` | Run a command in a sandbox |
| GET | `/v1/sandboxes/{id}/files` | List workspace files |
| PUT | `/v1/sandboxes/{id}/files/{path}` | Upload a file |
| GET | `/v1/sandboxes/{id}/files/{path}` | Download a file |
| GET | `/v1/sandboxes/{id}/artifacts` | Collect artifacts |
| POST | `/v1/sandboxes/{id}/snapshot` | Snapshot the workspace |
| POST | `/v1/sandboxes/{id}/run_code` | Run code in the persistent kernel (v2) |
| POST | `/v1/sandboxes/{id}/kernel/reset` | Restart the kernel (v2) |
| POST | `/v1/sandboxes/{id}/pause` | Pause a sandbox (v2) |
| POST | `/v1/sandboxes/{id}/resume` | Resume a paused sandbox (v2) |
| POST | `/v1/sandboxes/{id}/fork` | Fork a running sandbox (v2) |
| POST | `/v1/sandboxes/{id}/preview` | Get a preview URL for a port (v2) |

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/codai-ro/openapi/codai-ro-sandboxes-api-openapi.yml
- **Documentation** — https://docs.codai.ro/docs/gateway
- **JSONSchema** — https://artifacts.apis.io/codai-ro/json-schema/codai-ro-sandbox-exec-event-schema.json
- **JSONSchema** — https://artifacts.apis.io/codai-ro/json-schema/codai-ro-sandbox-run-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/codai-ro/json-schema/codai-ro-sandbox-exec-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/codai-ro/json-schema/codai-ro-sandbox-create-schema.json
- **JSONSchema** — https://artifacts.apis.io/codai-ro/json-schema/codai-ro-sandbox-schema.json
- **JSONSchema** — https://artifacts.apis.io/codai-ro/json-schema/codai-ro-sandbox-run-code-result-schema.json

## Other codai APIs (12)

- [codai Account API](https://apis.io/apis/codai-ro/codai-ro-account-api/)
- [codai Agents API](https://apis.io/apis/codai-ro/codai-ro-agents-api/)
- [codai Attestations API](https://apis.io/apis/codai-ro/codai-ro-attestations-api/)
- [codai Authorization API](https://apis.io/apis/codai-ro/codai-ro-authorization-api/)
- [codai Chat & Completions API](https://apis.io/apis/codai-ro/codai-ro-chat-completions-api/)
- [codai Connect API](https://apis.io/apis/codai-ro/codai-ro-connect-api/)
- [codai Devices API](https://apis.io/apis/codai-ro/codai-ro-devices-api/)
- [codai Discovery API](https://apis.io/apis/codai-ro/codai-ro-discovery-api/)
- [codai Embeddings & Audio API](https://apis.io/apis/codai-ro/codai-ro-embeddings-audio-api/)
- [codai Feed API](https://apis.io/apis/codai-ro/codai-ro-feed-api/)
- [codai Guest chat API](https://apis.io/apis/codai-ro/codai-ro-guest-chat-api/)
- [codai Health API](https://apis.io/apis/codai-ro/codai-ro-health-api/)

## Tags

Sandbox

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/codai-ro/codai-ro-sandboxes-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/codai-ro/.
