GET/v1/flow-runs/{id}

Get a flow run

Retrieves a flow run by its identifier. Use this endpoint to inspect the run's status, associated flow and project, environment, and timing details.

1 parameter
idstringrequired
The unique identifier of the flow run to retrieve. Must be exactly 21 alphanumeric characters.

1 status code
200Returns the flow run, including its identifier, status, environment, associated flow and project identifiers, and available timing and failure details.
archivedAtstringoptional
createdstringrequired
environmentstringrequired
Allowed:PRODUCTIONTESTING
failParentOnFailurebooleanrequired
failedStepobjectoptional
finishTimestringoptional
flowIdstringrequired
flowVersionobjectoptional
flowVersionIdstringrequired
idstringrequired
logsFileIdstringoptional
parentRunIdstringoptional
projectIdstringrequired
startTimestringoptional
statusstringrequired
Allowed:FAILEDQUOTA_EXCEEDEDINTERNAL_ERRORPAUSEDQUEUEDRUNNINGSUCCEEDEDMEMORY_LIMIT_EXCEEDEDTIMEOUTCANCELEDLOG_SIZE_EXCEEDED
stepNameToTeststringoptional
stepsobjectoptional
stepsCountnumberoptional
tagsarray<string>optional
triggeredBystringoptional
updatedstringrequired

Error handling

The id path parameter must be exactly 21 alphanumeric characters and identify a flow run.