Activepieces Management Octri Preview
GET/v1/flow-runs

List flow runs

Lists flow runs, with filters for flow IDs, tags, status, project, run IDs, and other run attributes. Supply the required flowId, tags, status, projectId, flowRunIds, and includeArchived filters; use cursor and limit to navigate the results.

11 parameters
flowIdarray<string>required
Filter by flow identifiers; each value must contain exactly 21 alphanumeric characters.
tagsarray<string>required
Filter by tags; each value is a string.
statusarray<string>required
Filter by run status: `FAILED`, `QUOTA_EXCEEDED`, `INTERNAL_ERROR`, `PAUSED`, `QUEUED`, `RUNNING`, `SUCCEEDED`, `MEMORY_LIMIT_EXCEEDED`, `TIMEOUT`, `CANCELED`, or `LOG_SIZE_EXCEEDED`.
limitnumberoptional
Maximum number of flow runs to return.
cursorstringoptional
Pagination cursor for retrieving a page of results.
createdAfterstringoptional
Filter for runs created after the specified value.
createdBeforestringoptional
Filter for runs created before the specified value.
projectIdstringrequired
The project identifier; must contain exactly 21 alphanumeric characters.
failedStepNamestringoptional
Filter by the name of the step that failed.
flowRunIdsarray<string>required
Filter by flow run identifiers; each value must contain exactly 21 alphanumeric characters.
includeArchivedbooleanrequired
Whether to include archived flow runs.

1 status code
200Returns a paginated response with `data` containing flow run objects and `next` and `previous` cursors.
dataarray<object>required
nextstringoptional
previousstringoptional

Error handling

Supply flowId, tags, status, projectId, flowRunIds, and includeArchived, which the query schema requires. projectId and each flowId and flowRunIds value must contain exactly 21 alphanumeric characters; status must be one of FAILED, QUOTA_EXCEEDED, INTERNAL_ERROR, PAUSED, QUEUED, RUNNING, SUCCEEDED, MEMORY_LIMIT_EXCEEDED, TIMEOUT, CANCELED, or LOG_SIZE_EXCEEDED.