Skip to main content
GET
Get flow run by UUID
Retrieve detailed information about a specific flow run using its unique identifier (UID). This endpoint provides complete status information, timing details, error messages, and workflow metadata for a single flow run. Use Cases:
  • Check the current status of a flow run you started
  • Monitor progress of long-running flows
  • Retrieve error details when a flow fails
  • Get timing information (started_at, finished_at) for performance analysis
We recommend using callbacks instead of polling this endpoint. Callbacks are highly available, have higher success rates, and are rate-limited for reliability. Polling is not super efficient and can be rate-limited.When you create a flow run, configure a callback URL to receive results automatically. You can monitor callback delivery using the List Callbacks endpoint if you need additional monitoring.

Authorizations

X-API-Key
string
header
required

Path Parameters

flow_run_uid
string<uuid>
required

Flow Run UUID

Query Parameters

with_run_step_status
boolean
default:false

Whether to include the run step status in the response

Response

Returns the flow run

Returns the flow run

uid
string<uuid>

Flow Run UUID

user_uid
string<uuid>

Member/User UUID

workspace_uid
string<uuid>

Workspace UUID

last_error
object | null

Last error message

callback
object | null

Callback

status
enum<string> | null

Flow Run status

Available options:
CREATED,
INVALID,
QUEUED,
SCHEDULED,
BLOCKED,
STOPPED,
RUNNING,
FAILED,
PARTIAL_SUCCEEDED,
SUCCEEDED
output_count
integer | null
default:0

Number of outputs generated by the flow run (only available when the flow run is finished)

scheduled_flow_run_uid
string<uuid> | null

If the flow run is scheduled, this field indicates the scheduled flow run UUID.

workflow
object | null

Workflow schema

started_at
string | null

Started at

finished_at
string | null

Finished at

created_at
string

Created at

updated_at
string | null

Updated at