Parameters
| Name | Type | Required | Meaning |
|---|---|---|---|
status |
string | no | running, paused, completed, failed or cancelled. |
workflow_id |
string | no | Only instances of this workflow. |
limit |
number | no | Maximum number of results. |
Returns
A list of instances with their id, workflow, status, and timestamps.
When to use it
Finding a run that is waiting at a gate — filter on paused — or checking whether a scheduled job's workflow actually ran. Each instance is recorded against the profile and token that started it.