Poll a Flow run for its status and result
id returned by Create Run until status reaches a terminal value (COMPLETED, FAILED, CANCELLED, or SKIPPED).report is the full analyst-facing result as Markdown text. It is only set once status is COMPLETED.output_ref is 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.error is only set when status is FAILED.404 if runId does not exist, or belongs to a different customer.The run's id, returned by POST /flows/{flowId}/runs
OK
QUEUED: awaiting worker pickup. RUNNING: executing. COMPLETED/FAILED/CANCELLED/SKIPPED: terminal states.
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.