StateSet API Docs

curl --request POST \ --url 'https://api.nsr.stateset.com/api/v1/sandbox/create' \ --header 'X-API-Key: YOUR_API_KEY' \ --header 'Content-Type: application/json' \ --data '{ "env": {}, "profile": "string", "timeout_seconds": 1 }'

Required scope: sandbox:execute

Request body

CreateSandboxRequest

object

Environment variables to inject.

string

Runtime profile (e.g., ‘default’, ‘python’, ‘node’).

integer (int32)

Maximum lifetime in seconds (default: 300).

Response

No response body — sandbox created.

Status codes

Code	Meaning
`201`	Sandbox created
`401`	Unauthorized — missing or invalid credentials
`403`	Forbidden — the key/token lacks the required scope
`429`	Rate limited — see Retry-After / X-RateLimit-Reset
`503`	Sandbox infrastructure unavailable

curl --request POST \
  --url 'https://api.nsr.stateset.com/api/v1/sandbox/create' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "env": {},
  "profile": "string",
  "timeout_seconds": 1
}'

​Request body

​Response

​Status codes

Request body

Response

Status codes