Skip to main content
GET
List Workflow runs

Authorizations

Authorization
string
header
required

OAuth Bearer access tokens or Flow API keys with the required Flow scope families for the route.

Query Parameters

cursor
string

Opaque cursor for list pagination.

limit
integer

Requested page size for list operations.

Required range: 1 <= x <= 100
status
enum<string>

Filter workflow runs by canonical status.

Available options:
requested,
queued,
running,
waiting,
cancel_requested,
completed,
failed,
denied,
canceled
error_code
string

Filter workflow runs by stored workflow diagnostic code.

workflow_id
string

Filter workflow runs by workflow ID. Tenant-authored workflow IDs are UUIDs; managed system workflow IDs are opaque strings.

system_automation_key
enum<string>

Restrict runs to the selected managed automation capability. Omit to read every research kind.

Available options:
research:knowledge_automation_mismatch
access_request_id
string

Filter workflow runs by linked access request ID.

blocking_approval_request_id
string

Filter workflow runs by blocking approval request ID.

validation_scenario_run
enum<string>

Omit for every run; false excludes validation-scenario attempts; true returns only validation-scenario attempts.

Available options:
true,
false

Response

Paginated workflow run collection response.

data
object[]
required
page
object
required
aggregate
object
required
meta
object
required