Apps - Get AdminApp
Get app as administrator.
Returns a PowerApp.
GET https://api.powerplatform.com/powerapps/environments/{environmentId}/apps/{app}?api-version=2022-03-01-preview
URI Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
|
app
|
path | True |
string |
Name field of the PowerApp. |
|
environment
|
path | True |
string |
Name field of the environment. |
|
api-version
|
query | True |
string |
The API version. |
Responses
| Name | Type | Description |
|---|---|---|
| 200 OK |
200 |
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 |
|---|---|
|
App |
PowerApp appUri object. |
|
Connection |
|
|
Created |
PowerApp created by principal object. |
|
Created |
PowerApp property createdByClientVersion object. |
|
Document |
PowerApp appUri document URI object. |
| Environment |
PowerApp environment property object. |
|
Last |
PowerApp last modified by object. |
|
Min |
PowerApp property minClientVersion object. |
| Owner |
PowerApp owner principal object. |
|
Power |
|
| Properties |
PowerApp properties object. |
| Tags |
tags |
|
User |
PowerApp property user app metadata object. |
AppUris
PowerApp appUri object.
| Name | Type | Description |
|---|---|---|
| documentUri |
PowerApp appUri document URI object. |
|
| imageUris |
string[] |
PowerApp appUri image URI array. |
ConnectionReference
| Name | Type | Description |
|---|---|---|
| apiTier |
string |
API tier is standard or premium |
| bypassConsent |
boolean |
Flag indicates bypassed API consent |
| dataSources |
string[] |
List of data sources for the connection |
| dependencies |
string[] |
List of dependencies for the connection |
| dependents |
string[] |
List of dependant connectors for the connector |
| displayName |
string |
|
| executionRestrictions |
object |
Execution restrictions for the runtime policy |
| iconUri |
string |
|
| id |
string |
|
| isCustomApiConnection |
boolean |
Flag indicates custom connector |
| isOnPremiseConnection |
boolean |
Flag indicates on premise data gateway |
| runtimePolicyName |
string |
String indicating the name of the runtime policy |
| sharedConnectionId |
string |
String indicating the ID of the shared connection |
CreatedBy
PowerApp created by principal object.
| Name | Type | Description |
|---|---|---|
| displayName |
string |
PowerApp creator principal display name. |
|
string |
PowerApp creator principal email. |
|
| id |
string |
PowerApp creator principal object ID. |
| tenantId |
string |
PowerApp creator principal tenant ID. |
| type |
string |
PowerApp creator principal type. |
| userPrincipalName |
string |
PowerApp creator principal user principal name. |
CreatedByClientVersion
PowerApp property createdByClientVersion object.
| Name | Type | Description |
|---|---|---|
| build |
integer (int32) |
PowerApp property createdByClientVersion build. |
| major |
integer (int32) |
PowerApp property createdByClientVersion major. |
| majorRevision |
integer (int32) |
PowerApp property createdByClientVersion majorRevision. |
| minor |
integer (int32) |
PowerApp property createdByClientVersion minor. |
| minorRevision |
integer (int32) |
PowerApp property createdByClientVersion minorRevision. |
| revision |
integer (int32) |
PowerApp property createdByClientVersion revision. |
DocumentUri
PowerApp appUri document URI object.
| Name | Type | Description |
|---|---|---|
| readonlyValue |
string |
PowerApp appUri document URI read only value. |
| value |
string |
PowerApp appUri document URI value. |
Environment
PowerApp environment property object.
| Name | Type | Description |
|---|---|---|
| id |
string |
PowerApp environment ID. |
| name |
string |
PowerApp environment name. |
LastModifiedBy
PowerApp last modified by object.
| Name | Type | Description |
|---|---|---|
| displayName |
string |
PowerApp last modified by principal display name. |
|
string |
PowerApp last modified by principal email. |
|
| id |
string |
PowerApp last modified by principal object ID. |
| tenantId |
string |
PowerApp last modified by principal tenant ID. |
| type |
string |
PowerApp last modified by principal type. |
| userPrincipalName |
string |
PowerApp last modified by principal userPrincipalName. |
MinClientVersion
PowerApp property minClientVersion object.
| Name | Type | Description |
|---|---|---|
| build |
integer (int32) |
PowerApp property minClientVersion build. |
| major |
integer (int32) |
PowerApp property minClientVersion major. |
| majorRevision |
integer (int32) |
PowerApp property minClientVersion majorRevision. |
| minor |
integer (int32) |
PowerApp property minClientVersion minor. |
| minorRevision |
integer (int32) |
PowerApp property minClientVersion minorRevision. |
| revision |
integer (int32) |
PowerApp property minClientVersion revision. |
Owner
PowerApp owner principal object.
| Name | Type | Description |
|---|---|---|
| displayName |
string |
PowerApp owner principal display name. |
|
string |
PowerApp owner principal email. |
|
| id |
string |
PowerApp owner principal user ID. |
| tenantId |
string |
PowerApp owner principal tenant ID. |
| type |
string |
PowerApp owner principal type. |
| userPrincipalName |
string |
PowerApp owner principal user principal name. |
PowerApp
| Name | Type | Description |
|---|---|---|
| id |
string |
PowerApp ID field. |
| name |
string |
PowerApp name field. |
| properties |
PowerApp properties object. |
|
| tags |
tags |
|
| type |
string |
PowerApp type field. |
Properties
PowerApp properties object.
| Name | Type | Description |
|---|---|---|
| appOpenProtocolUri |
string |
PowerApp property app open protocol URI. |
| appOpenUri |
string |
PowerApp property app open URI. |
| appUris |
PowerApp appUri object. |
|
| appVersion |
string (date-time) |
PowerApp property appVersion. |
| backgroundColor |
string |
PowerApp background color. |
| backgroundImageUri |
string |
PowerApp background image URI. |
| bypassConsent |
boolean |
PowerApp property bypass consent. |
| connectionReferences | ||
| createdBy |
PowerApp created by principal object. |
|
| createdByClientVersion |
PowerApp property createdByClientVersion object. |
|
| createdTime |
string (date-time) |
PowerApp property created time. |
| description |
string |
PowerApp description. |
| displayName |
string |
PowerApp display name. |
| environment |
PowerApp environment property object. |
|
| isFeaturedApp |
boolean |
PowerApp property is featured app. |
| isHeroApp |
boolean |
PowerApp property indicating hero application. |
| lastModifiedBy |
PowerApp last modified by object. |
|
| lastModifiedTime |
string (date-time) |
PowerApp property last modified time. |
| minClientVersion |
PowerApp property minClientVersion object. |
|
| owner |
PowerApp owner principal object. |
|
| sharedGroupsCount |
integer (int32) |
PowerApp property shared groups count. |
| sharedUsersCount |
integer (int32) |
PowerApp property shared users count. |
| userAppMetadata |
PowerApp property user app metadata object. |
Tags
tags
| Name | Type | Description |
|---|---|---|
| deviceCapabilities |
string |
PowerApp tag device capabilities. |
| minimumRequiredApiVersion |
string (date-time) |
PowerApp tag minimum required API version. |
| primaryDeviceHeight |
string |
PowerApp tag primary device height. |
| primaryDeviceWidth |
string |
PowerApp tag primary device width. |
| primaryFormFactor |
string |
PowerApp tag primary form factor. |
| publisherVersion |
string |
PowerApp tag publisher version. |
| sienaVersion |
string |
PowerApp tag siena version. |
| supportsLandscape |
string |
PowerApp tag supports landscape. |
| supportsPortrait |
string |
PowerApp tag supports portrait. |
UserAppMetadata
PowerApp property user app metadata object.
| Name | Type | Description |
|---|---|---|
| favorite |
string |
PowerApp property user app metadata favorite. |
| includeInAppsList |
boolean |
PowerApp property user app metadata include in apps list. |