latestOpenAPI 3.0.02026-08-107797148.2 KB

89261af4dd80

Flow Run Logs

List Flow Runs

Retrieves a paginated list of flow runs. Can be filtered by user_id, flow_id, flow_version_id, virtual_environment_id, trigger, status, date range, and other criteria.

get/api/v1/flow-runs

Query parameters

filter[user_id]string

Filter results by user_id.

filter[flow_id]string

Filter results by flow_id.

filter[flow_version_id]string

Filter results by flow_version_id.

filter[virtual_environment_id]string

Filter results by virtual_environment_id.

filter[trigger]string

Filter results by trigger.

filter[status]string

Filter results by status.

filter[search]string

Filter results by search.

filter[started_before]string

Filter results to flow runs that started before the specified time. Accepts a Unix timestamp in milliseconds, e.g. 2026-03-01 19:00 converts to 1772391627000 so 1772391627000 is the parameter value.

filter[started_after]string

Filter results to flow runs that started after the specified time. Accepts a Unix timestamp in milliseconds.

filter[started_on]string

Filter results to flow runs that started on the specified date. Accepts a Unix timestamp in milliseconds.

filter[retried]string

Filter results by retried.

filter[has_warnings]string

Filter results by has_warnings.

includestring

Comma-separated list of relationships to include. Available: flowVersion, flowVersion.steps, flow, flowRunLogs, errorWarningLogs, flowRunLogs.flowStep, trackedData, metrics, cpuTime, payloadSize, operationsSent, operationsReceived, retriedFlowRun, virtualEnvironmentVersion, virtualEnvironmentVersion.virtualEnvironment

sortstring

Sort field. Prefix with - for descending. Available: started_at

fields[trackedData]string

Comma-separated list of trackedData fields to return. Available: id

fields[flow]string

Comma-separated list of flow fields to return. Available: id, name

fields[flowVersion]string

Comma-separated list of flowVersion fields to return. Available: steps.name

fields[retriedFlowRun]string

Comma-separated list of retriedFlowRun fields to return. Available: id, status

pageinteger

Page number for pagination.

per_pageinteger

Number of results per page.

Response

Successful response