API reference
API overview
REST API for sandbox execution and session management.
The execution API is versioned under /v1. All endpoints accept JSON and require bearer authentication.
Base URL: https://api.inis.run
Each endpoint in the reference shows the HTTP method, path, request body, and response shape. For interactive exploration, use the OpenAPI spec or the CLI.
Endpoints
| Method | Path | Description |
|---|---|---|
| POST | /v1/sessions/exec | One-shot Python/Node run in a throwaway session |
| POST | /v1/sessions | Create session |
| GET | /v1/sessions/{id} | Get session |
| DELETE | /v1/sessions/{id} | Destroy session |
| POST | /v1/sessions/{id}/exec | Run command |
| POST | /v1/sessions/{id}/files | Read / write / list |
| POST | /v1/sessions/{id}/expose | Preview URL |
| POST | /v1/sessions/{id}/fork | Fork into N children |
| POST | /v1/sessions/{id}/pause | Pause session |
| POST | /v1/sessions/{id}/resume | Resume session |
| POST | /v1/sessions/batch/exec | Fan-out command |
| GET | /v1/healthz | Node health (no auth) |
Detail: One-shot exec · Sessions
Account management (API keys, usage, billing) lives on the control plane at https://app.inis.run/v1/* — separate from execution.
Sandbox sizes
Pass size on session create or execute: small (default), medium, large. See pricing for vCPU/RAM/rates.
OpenAPI
The full schema is available as openapi.yaml.
New to the primitives? Start with Concepts.