Skip to main content
POST
http://localhost:3000
/
execute
curl -X POST http://localhost:3000/execute \
  -H "Authorization: Bearer $ISOL8_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request": {
      "runtime": "python",
      "code": "print(2 ** 10)"
    },
    "options": {
      "network": "none",
      "timeoutMs": 30000
    }
  }'

{
  "stdout": "1024\n",
  "stderr": "",
  "exitCode": 0,
  "durationMs": 82,
  "truncated": false,
  "executionId": "550e8400-e29b-41d4-a716-446655440000",
  "runtime": "python",
  "timestamp": "2026-02-19T12:00:00.000Z"
}
Runs one execution request and returns complete stdout/stderr and metadata.

​
Body

​
request
ExecutionRequest
required
Execution payload including code and runtime plus optional per-request fields.
​
options
Isol8Options
Optional engine-level overrides merged over server defaults.
​
sessionId
string
Optional persistent session key. If provided, server creates/reuses a persistent session.

​
Success response

​
stdout
string
Captured standard output.
​
stderr
string
Captured standard error.
​
exitCode
number
Process exit code.
​
durationMs
number
Execution duration in milliseconds.
​
truncated
boolean
Whether output was truncated by max output limits.
​
executionId
string
Unique execution identifier.
​
runtime
string
Runtime used for this execution.
​
timestamp
string
ISO timestamp for execution completion.
curl -X POST http://localhost:3000/execute \
  -H "Authorization: Bearer $ISOL8_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request": {
      "runtime": "python",
      "code": "print(2 ** 10)"
    },
    "options": {
      "network": "none",
      "timeoutMs": 30000
    }
  }'

{
  "stdout": "1024\n",
  "stderr": "",
  "exitCode": 0,
  "durationMs": 82,
  "truncated": false,
  "executionId": "550e8400-e29b-41d4-a716-446655440000",
  "runtime": "python",
  "timestamp": "2026-02-19T12:00:00.000Z"
}