StateSet API Docs

curl --request POST \
  --url 'https://api.sandbox.stateset.app/api/v1/sandbox/{sandboxId}/execute' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "command": "string",
  "working_dir": "string",
  "env": {},
  "stream": true
}'

{
  "exit_code": 1,
  "stdout": "string",
  "stderr": "string"
}

POST

api

sandbox

{sandboxId}

execute

curl --request POST \
  --url 'https://api.sandbox.stateset.app/api/v1/sandbox/{sandboxId}/execute' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "command": "string",
  "working_dir": "string",
  "env": {},
  "stream": true
}'

{
  "exit_code": 1,
  "stdout": "string",
  "stderr": "string"
}

Executes a command in the sandbox. Supports both synchronous and streaming (SSE) modes. Set stream: true to receive output via Server-Sent Events.

Path parameters

string (uuid)

required

Unique sandbox identifier

Request body

ExecuteRequest

string

required

string

Working directory

object

Additional environment variables

boolean

Enable SSE streaming mode

Response

ExecuteResponse

integer

string

Status codes

Code	Meaning
`200`	Execution result (non-streaming) or SSE stream (streaming mode).
In streaming mode, the response is `text/event-stream`.

curl --request POST \
  --url 'https://api.sandbox.stateset.app/api/v1/sandbox/{sandboxId}/execute' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "command": "string",
  "working_dir": "string",
  "env": {},
  "stream": true
}'

{
  "exit_code": 1,
  "stdout": "string",
  "stderr": "string"
}

Sandboxes

Create

Lifecycle

Execute

Files

Tunnels

Inference

Execute command in sandbox

Path parameters

Request body

Response

Status codes

​Path parameters

​Request body

​Response

​Status codes

Path parameters

Request body

Response

Status codes