Sign in

v106

latestOpenAPI 3.0.3Apache 2.0raw.githubusercontent.com2026-08-03812347972.4 KB
job

run script preview

post/w/{workspace}/jobs/run/preview

Path parameters

workspacestring required

Query parameters

include_headerstring

List of headers's keys (separated with ',') whove value are added to the args Header's key lowercased and '-'' replaced to '_' such that 'Content-Type' becomes the 'content_type' arg key

invisible_to_ownerboolean

make the run invisible to the the script owner (default false)

timeoutinteger

custom timeout in seconds for this preview run

job_idstring uuid

The job id to assign to the created job. if missing, job is chosen randomly using the ULID scheme. If a job id already exists in the queue or as a completed job, the request to create one will fail (Bad Request)

Request body

contentstring

The code to run

pathstring

The path to the script

script_hashstring

The hash of the script

argsScriptArgs required

The arguments to pass to the script or flow

language'python3' | 'deno' | 'go' | 'bash' | 'powershell' | 'postgresql' | 'mysql' | 'bigquery' | 'snowflake' | 'mssql' | 'oracledb' | 'graphql' | 'nativets' | 'bun' | 'php' | 'rust' | 'ansible' | 'csharp' | 'nu' | 'java' | 'ruby' | 'rlang' | 'duckdb' | 'bunnative' | 'dbt'
tagstring
kind'code' | 'identity' | 'http'
dedicated_workerboolean
lockstring
flow_pathstring
modulesobject nullable

Additional script modules keyed by relative file path

temp_script_refsobject nullable

Map of relative-import script path -> temp storage hash so the preview job resolves those imports from not-yet-deployed local content instead of the deployed script

Response

job created