job

run flow by version

Changed on
post/w/{workspace}/jobs/run/fv/{version}

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/w/{workspace}/jobs/run/fv/{version}
  • Auth: one of:
    • HTTP bearer
    • API key in cookie token

Path parameters

workspacestring required
versioninteger required

flow version ID

Query parameters

scheduled_forstring date-time

when to schedule this job (leave empty for immediate run)

scheduled_in_secsinteger

schedule the script to execute in the number of seconds starting now

skip_preprocessorboolean

skip the preprocessor

parent_jobstring uuid

The parent job that is at the origin and responsible for the execution of this script if any

tagstring

Override the tag to use

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)

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 flow owner (default false)

memory_idstring

Memory id for the flow's AI agent steps. A uuid is used as is; any other string is hashed within the workspace and flow, so the same string always names the same memory of that flow.

Request body

ScriptArgs required

The arguments to pass to the script or flow

Response

job created

Changes