POST
/
apps
/
{app_id}
/
workflows
/
{workflow_id}
/
runs

Path Parameters

app_id
string
required

The ID of the app

workflow_id
string
required

The ID of the workflow

Query Parameters

verbose
enum<string>[]
Available options:
all

Body

Data to create a new run

input
object | null

Input values for the run

stream
boolean

Indicates if the run should stream output to the client as it becomes available

workflow_version_id

ID of the workflow version. Also you can use "latest", "draft" or "version number" to use a specific version

Available options:
draft,
latest

Response

200 - application/json
app_id
string
required

ID of the associated app where the run was triggered from

created_at
string | null
required

Timestamp of when the run was created

ended_at
string | null
required

Timestamp of when the run ended

id
string
required

Unique identifier for the run

input
object | null
required

Input values used for the run

origin
enum<string>
required

Origin of the run

Available options:
WORKFLOW,
RECORD,
TEST,
ENDPOINT
output
object | null
required

Output of the run

started_at
string | null
required

Timestamp of when the run started

status
enum<string>
required

Status of the run

Available options:
PENDING,
RUNNING,
CANCELLED,
COMPLETED,
SKIPPED,
FAILED
updated_at
string | null
required

Timestamp of when the run was last updated

workflow_app_id
string
required

ID of the associated app where the workflow belongs to

workflow_id
string
required

ID of the associated workflow

workflow_version
object | null
required

Details of the workflow version used for the run

workflow_version_draft
object | null
required

Draft version of the workflow

collection_id
string

ID of the associated collection

error
string

Error message if the run failed

record_id
string

ID of the associated record

result
any | null

Result of the run

usage
object

Credits usage of the run

version
number

Version number of the workflow