Flow Runs - List Flow Runs
Retrieve flow runs by workflow ID.
Returns a list of flow runs.
GET https://api.powerplatform.com/powerautomate/environments/{environmentId}/flowRuns?workflowId={workflowId}&api-version=2022-03-01-preview
URI Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
|
environment
|
path | True |
string |
The environment ID. |
|
api-version
|
query | True |
string |
The API version. |
|
workflow
|
query | True |
string (uuid) |
The workflow ID. |
Responses
| Name | Type | Description |
|---|---|---|
| 200 OK |
A list of flow runs matching the workflow ID. |
|
| 204 No Content |
No content. No matching flow runs found. |
|
| 400 Bad Request |
Bad request. |
|
| 401 Unauthorized |
Unauthorized. |
|
| 403 Forbidden |
Forbidden. |
|
| 500 Internal Server Error |
Internal server error. |
Security
oauth2
Microsoft Entra ID OAuth2
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize?resource=https://api.powerplatform.com
Scopes
| Name | Description |
|---|---|
| .default | .default |
Definitions
| Name | Description |
|---|---|
| Error | |
|
Error |
The error response object. |
Error
| Name | Type | Description |
|---|---|---|
| code |
string |
Error code indicating the type of failure (e.g., BadRequest, InternalServerError). |
| message |
string |
Description of the error. |
ErrorResponse
The error response object.
| Name | Type | Description |
|---|---|---|
| error |