Execute code) Code Interpreter

Runs code in an isolated sandbox and returns its output plus any files it produced. The call blocks until the run finishes.

Rate limited to 20 requests per 30 s per principal by default (MAX_REQUESTS / RATE_LIMIT_WINDOW).

With CODEAPI_PERSIST_SESSIONS=true this route (and only this route) continues the caller's previous run: files left in /mnt/data and, for Python, the global namespace are restored automatically.

Authorization

BearerAuth

AuthorizationBearer <token>

EdDSA (Ed25519) JWT minted by LibreChat. Required unless the service runs with LOCAL_MODE=true or CODEAPI_AUTH_PROVIDER=none.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

code*string

Source to execute.

lang*string

Language to run the code as. Accepted values map onto the installed runtimes; which of these actually exist depends on CODEAPI_LANGUAGES at deploy time.

Value in

"py"
"js"
"ts"
"node"
"bash"
"java"

args?array<string>

Command-line arguments passed to the program.

user_id?string

Caller-supplied user id. Used only when the service runs with CODEAPI_AUTH_PROVIDER=none and no User-Id header is present; ignored in JWT mode, where the principal comes from the token.

files?array<>

Previously uploaded files to stage into the workspace.

dependencies?

Request-declared packages installed for this job only, before user code runs. Off by default: enable with CODEAPI_ALLOW_DYNAMIC_DEPENDENCIES=true, otherwise a request carrying this field is rejected.

Installs run in the trusted runner with pip --only-binary=:all:, so only prebuilt wheels are used and no setup.py executes. The result is mounted read-only into the sandbox on PYTHONPATH; the sandbox itself still has no network.

Response Body

`application/json`

curl -X POST "https://example.com/exec" \  -H "Content-Type: application/json" \  -d '{    "lang": "py",    "code": "print(sum(range(10)))"  }'

{  "session_id": "string",  "stdout": "string",  "stderr": "string",  "files": [    {      "id": "string",      "resource_id": "string",      "storage_session_id": "string",      "name": "string",      "kind": "user",      "version": 0    }  ],  "code": 0,  "signal": "string",  "message": "string",  "status": "string",  "wall_time": 0,  "session_state_persisted": true,  "session_state_restore_failed": true}

Execute code

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

429application/json

500application/json

503application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`