Skip to main content
GET
/
workflow-executions
List Workflow Executions
curl --request GET \
  --url https://api.example.com/workflow-executions \
  --cookie fastapiusersauth=
[
  {
    "id": "<string>",
    "run_id": "<string>",
    "start_time": "2023-11-07T05:31:56Z",
    "status": "RUNNING",
    "workflow_type": "<string>",
    "task_queue": "<string>",
    "history_length": 123,
    "execution_time": "2023-11-07T05:31:56Z",
    "close_time": "2023-11-07T05:31:56Z",
    "parent_wf_exec_id": "<string>"
  }
]

Authorizations

​
fastapiusersauth
string
cookie
required

Query Parameters

​
trigger
enum<string>[] | null

Trigger type for a workflow execution.

Available options:
manual,
scheduled,
webhook
​
user_id
​
limit
integer | null
​
workspace_id
string<uuid>
required
​
workflow_id
Pattern: wf_[0-9a-zA-Z]+

Response

Successful Response

​
id
string
required

The ID of the workflow execution

​
run_id
string
required

The run ID of the workflow execution

​
start_time
string<date-time>
required

The start time of the workflow execution

​
status
enum<string>
required
Available options:
RUNNING,
COMPLETED,
FAILED,
CANCELED,
TERMINATED,
CONTINUED_AS_NEW,
TIMED_OUT
​
workflow_type
string
required
​
task_queue
string
required
​
history_length
integer
required

Number of events in the history

​
execution_time
string<date-time> | null

When this workflow run started or should start.

​
close_time
string<date-time> | null

When the workflow was closed if closed.

​
parent_wf_exec_id
string | null
Pattern: (?P<workflow_id>wf-[0-9a-f]{32}|wf_[0-9a-zA-Z]+)[:/](?P<execution_id>(exec_[0-9a-zA-Z]+|exec-[\w-]+|sch-[0-9a-f]{32}-.*))