OpenAPI 3.0.3Apache 2.0raw.githubusercontent.com2026-08-168263541004.6 KB

c3a7465c46bb

job

run flow preview

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

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)

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)

memory_idstring uuid

memory ID for chat-enabled flows

Request body

valueFlowValue required— unresolved $ref
pathstring
argsScriptArgs required

The arguments to pass to the script or flow

tagstring
temp_script_refsobject nullable

Map of relative-import script path -> temp storage hash, propagated to each flow step so inline-script relative imports resolve from not-yet-deployed local content instead of the deployed script

Response

job created