Share via


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
environmentId
path True

string (uuid)

The environment ID.

api-version
query True

string

The API version.

workflowId
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

ErrorResponse

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
ErrorResponse

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

Error