Finance And Operations Versions - Get Fin Ops Versions

Service:

Power Platform API

API Version:

2024-10-01

Get available Finance and Operations versions.
Retrieves the list of Finance and Operations application versions available for an environment.

GET https://api.powerplatform.com/dynamics/environments/{environmentId}/finopsversions?api-version=2024-10-01

URI Parameters

Name	In	Required	Type	Description
environmentId	path	True	string (uuid)	The unique identifier of the environment.
api-version	query	True	string	The API version.

Responses

Name	Type	Description
200 OK	FinOpsVersionsResponse	Successfully retrieved available Finance and Operations versions.
400 Bad Request	FinOpsErrorResponse	Bad Request.
401 Unauthorized	FinOpsErrorResponse	Unauthorized.
403 Forbidden	FinOpsErrorResponse	Forbidden.
404 Not Found	FinOpsErrorResponse	Not Found.
500 Internal Server Error	FinOpsErrorResponse	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
FinOpsAppVersion	A Finance and Operations application version.
FinOpsErrorResponse	Standard error response.
FinOpsVersionsResponse	Finance and Operations available versions response.

Error

Object

Name	Type	Description
code	string	Error code.
message	string	Error message.

FinOpsAppVersion

Object

A Finance and Operations application version.

Name	Type	Description
releaseStage	string	The release stage of the version.
version	string	The application version.

FinOpsErrorResponse

Object

Standard error response.

Name	Type	Description
error	Error

FinOpsVersionsResponse

Object

Finance and Operations available versions response.

Name	Type	Description
availableVersions	FinOpsAppVersion[]	The list of available Finance and Operations application versions.