Sign in
OpenAPI 3.1.0raw.githubusercontent.com2026-08-20351711.3 MB

d06bca6c3ff5

Scripts

Run a reusable or inline script

Inline source skips typecheck and is auto-saved as a scratch script only on success.

post/api/scripts/run

Headers

X-Runtime-Instance-IDstring

Identifies the concrete runtime instance (worker process) making the call, as generated at its boot. Required to acquire work through the script SDK when multi-runtime mode (MULTI_RUNTIME_ENABLED) is on; ignored otherwise.

Identifies the concrete runtime instance (worker process) making the call, as generated at its boot. Required to acquire work through the script SDK when multi-runtime mode (MULTI_RUNTIME_ENABLED) is on; ignored otherwise.

Request body

namestring
sourcestring
{"stackTrail":"paths:/api/scripts/run:post:requestBody:content:application/json:schema:properties:args","oasType":"schema","type":"unknown"}
intentstring
scope'global' | 'agent'
fsMode'none' | 'workspace-rw'
idempotencyKeystring

Response

Script run completed

{"stackTrail":"paths:/api/scripts/run:post:responses:200:content:application/json:schema:properties:result","oasType":"schema","type":"unknown"}
durationMsnumber required
stdoutstring required
stderrstring required
exitCodenumber required
error'timeout' | 'oom' | 'killed' | 'import_violation' | 'eval_error' | 'executor_error'