Execute

Run code and return buffered execution results.

POST /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"
}