Get Run
Flows
Get Run
Poll a Flow run for its status and result
GET
Get Run
Behavior
- Poll this endpoint with the
idreturned by Run untilstatusreaches a terminal value (COMPLETED,FAILED,CANCELLED, orSKIPPED). reportis the full analyst-facing result as Markdown text. It is only set oncestatusisCOMPLETED.output_refis set once structured output has been captured for the run. Its presence (not its value) is the signal that Get Run Output URL can be called to download the structured output file.erroris only set whenstatusisFAILED.- Returns
404ifrunIddoes not exist, or belongs to a different customer.
Authorizations
Path Parameters
The run's id, returned by POST /flows/{flowId}/runs
Response
OK
QUEUED: awaiting worker pickup. RUNNING: executing. COMPLETED/FAILED/CANCELLED/SKIPPED: terminal states.
Available options:
QUEUED, RUNNING, COMPLETED, FAILED, CANCELLED, SKIPPED Set once the run moves from QUEUED to RUNNING.
Set once the run reaches a terminal state.
The input the run was triggered with.
The full analyst-facing Markdown report. Set only once the run has COMPLETED.
Present once structured output has been captured. Its presence means GET /flow-runs/{runId}/output-url can be called to download it.
Set only when status is FAILED.