PowerApps for Admins (Preview)

PowerApps for Admins (Preview)

PowerApps Management Connector For Administrators

This connector is available in the following products and regions:

Service Class Regions
Flow Standard All Flow regions except the following:
     -   US Government (GCC)
PowerApps Standard All PowerApps regions except the following:
     -   US Government (GCC)

Throttling Limits

Name Calls Renewal Period
API calls per connection 1000 60 seconds

Actions

Edit App Role Assignment as Admin

Sets permissions for a PowerApp.

Required Parameters

Environment Name
string
Name field of the Environment.
PowerApp Name
string
Name field of the PowerApp.

Optional Parameters

API Version
string
The date value of the API version.
Filter Query
string
A filter query parameter.
Role Name
string
The name of the permission role. Choose from CanView, CanViewWithShare, and CanEdit.
capabilities
string
Notify Share Target Option
string
Notifies the new user if provided the string value 'Notify'.
Principal Email
string
The principal email of the user.
Principal Object ID
string
The principal object ID of the user.
Principal Type
string
The principal type of the user.
Tenant ID
string
The principal tenant ID of the user.
Role ID
string
The ID field of the Role Assignment.

Returns

put
array of object
App Role Assignment put object.
id
string
App Role Assignment ID field.
roleName
string
App Role Assignment property roleName.
scope
string
App Role Assignment property scope.
id
string
App Role Assignment principal object ID.
email
string
App Role Assignment principal email.
type
string
App Role Assignment principal type.
resourceResponses
array of object
App Role Assignment resourceResponse object.
id
string
App Role Assignment resourceResponse ID.
statusCode
string
App Role Assignment resourceResponse statusCode.
responseCode
string
App Role Assignment resourceResponse responseCode.
message
string
App Role Assignment resourceResponse message.
type
string
App Role Assignment resourceResponse type.

Edit Connection Role Assignment as Admin

Sets permissions for a Connection.

Required Parameters

Environment Name
string
Name field of the Environment.
Connector Name
string
Name field of the Connector.
Connection Name
string
Name field of the Connection.

Optional Parameters

API Version
string
The date value of the API version.
Field Content Type
string
The content type of the API request.
Role ID
string
The ID field of the Role Assignment.
Role Name
string
The name of the permission role.
Principal ID
string
The principal ID of the user.

Returns

put
array of object
App Role Assignment put object.
id
string
App Role Assignment ID field.
roleName
string
App Role Assignment property roleName.
scope
string
App Role Assignment property scope.
id
string
App Role Assignment principal object ID.
email
string
App Role Assignment principal email.
type
string
App Role Assignment principal type.
resourceResponses
array of object
App Role Assignment resourceResponse object.
id
string
App Role Assignment resourceResponse ID.
statusCode
string
App Role Assignment resourceResponse statusCode.
responseCode
string
App Role Assignment resourceResponse responseCode.
message
string
App Role Assignment resourceResponse message.
type
string
App Role Assignment resourceResponse type.

Edit Connector Role Assignment as Admin

Sets permissions for a Connector.

Required Parameters

Environment Name
string
Name field of the Environment.
Connector Name
string
Name field of the Connector.

Optional Parameters

API Version
string
The date value of the API version.
Field Content Type
string
The content type of the API request.
Role ID
string
The ID field of the Role Assignment.
Role Name
string
The name of the role.
Principal Object ID
string
The principal object ID of the user.

Returns

put
array of object
App Role Assignment put object.
id
string
App Role Assignment ID field.
roleName
string
App Role Assignment property roleName.
scope
string
App Role Assignment property scope.
id
string
App Role Assignment principal object ID.
email
string
App Role Assignment principal email.
type
string
App Role Assignment principal type.
resourceResponses
array of object
App Role Assignment resourceResponse object.
id
string
App Role Assignment resourceResponse ID.
statusCode
string
App Role Assignment resourceResponse statusCode.
responseCode
string
App Role Assignment resourceResponse responseCode.
message
string
App Role Assignment resourceResponse message.
type
string
App Role Assignment resourceResponse type.

Get App Role Assignments as Admin

Returns permissions for a PowerApp.

Required Parameters

Environment Name
string
Name field of the Environment.
PowerApp Name
string
Name field of the PowerApp.

Optional Parameters

API Version
string
The date value of the API version.

Returns

value
array of object
PowerApp Role Assignment value array.
Name
string
PowerApp Role Assignment name field.
id
string
PowerApp Role Assignment ID field.
type
string
PowerApp Role Assignment type field.
roleName
string
PowerApp Role Assignment roleName.
id
string
PowerApp Role Assignment principal object ID.
displayName
string
PowerApp Role Assignment principal displayName.
email
string
PowerApp Role Assignment principal email.
type
string
PowerApp Role Assignment principal type.
scope
string
PowerApp Role Assignment scope.
Notify Share Target Option
string
PowerApp Role Assignment notifyShareTargetOption.

Get App as Admin

Returns a PowerApp.

Required Parameters

Environment Name
string
Name field of the Environment.
PowerApp Name
string
Name field of the PowerApp.

Optional Parameters

API Version
string
The date value of the API version.

Returns

Body
PowerApp

Get Apps as Admin

Returns a list of PowerApps.

Required Parameters

Environment Name
string
Name field of the Environment.

Optional Parameters

API Version
string
The date value of the API version.
Top Apps
integer
Number of Apps in the response.
Skip token
string
Used to get next page of responses.

Returns

Get Connection Role Assignments as Admin

Returns all permissions for a Connection.

Required Parameters

Environment Name
string
Name field of the Environment.
Connector Name
string
Name field of the Connector.
Connection Name
string
Name field of the Connection.

Optional Parameters

API Version
string
The date value of the API version.

Returns

value
array of object
Connection Role Assignment value array.
name
string
Connection Role Assignment name field.
id
string
Connection Role Assignment ID field.
type
string
Connection Role Assignment type field.
roleName
string
Connection Role Assignment role name.
id
string
Connection Role Assignment principal object ID.
displayName
string
Connection Role Assignment principal displayName.
email
string
Connection Role Assignment principal email.
type
string
Connection Role Assignment principal type.
notifyShareTargetOption
string
Connection Role Assignment notify share target option.

Get Connections as Admin

Returns a list of Connections.

Required Parameters

Environment Name
string
Name field of the Environment.

Optional Parameters

API Version
string
The date value of the API version.

Returns

value
array of object
Connection value array.
name
string
Connection name field.
id
string
Connection ID field.
type
string
Connection type field.
apiId
string
Connection property apiId.
displayName
string
Connection property displayName.
iconUri
string
Connection icon URI.
statuses
array of object
Connection statuses.
status
string
Connection status.
target
string
Connection status target.
code
string
Connection status error code.
message
string
Connection status error message.
sku
string
Connection parameter sku.
workflowName
string
Connection parameter workflow name.
workflowPath
string
Connection parameter workflow path.
workflowEndpoint
string
Connection parameter workflow endpoint.
workFlowCallbackUri
string
Connection parameter workFlow Callback URI.
server
string
Connection parameter server.
database
string
Connection parameter database.
keywordsRemaining
integer
Connection property keywordsRemaining.
id
string
Connection creator principal object ID.
displayName
string
Connection creator principal display name.
email
string
Connection creator principal email.
type
string
Connection creator principal type.
tenantId
string
Connection creator principal tenantId.
userPrincipalName
string
Connection creator user principal name.
createdTime
date-time
Connection created time.
lastModifiedTime
date-time
Connection last modified time.
id
string
Connection Environment ID.
name
string
Connection Environment name.
expirationTime
date-time
Connection property expirationTime.
testLinks
array of object
Connection property testLinks.
requestUri
string
Connection property testLink requestUri.
method
string
Connection property testLink method

Get Connector Role Assignments as Admin

Returns permissions for a custom Connector.

Required Parameters

Environment Name
string
Name field of the Environment.
Connector Name
string
Name field of the Connector.

Optional Parameters

API Version
string
The date value of the API version.

Returns

value
array of object
value
name
string
Connector Role Assignment name field.
id
string
Connector Role Assignment ID field.
type
string
Connector Role Assignment type field.
roleName
string
Connector Role Assignment role name.
id
string
Connector Role Assignment principal object ID.
displayName
string
Connector Role Assignment principal displayName.
email
string
Connector Role Assignment principal email.
type
string
Connector Role Assignment principal type.
notifyShareTargetOption
string
The Name field of the notifyShareTargetOption.

Get Custom Connectors as Admin

Returns a list of custom Connectors.

Required Parameters

Environment Name
string
Name field of the Environment.

Optional Parameters

API Version
string
The date value of the API version.

Returns

value
array of object
value
name
string
Connector name field.
id
string
Connector id field.
type
string
Connector type field.
displayName
string
Connector property displayName.
iconUri
string
Connector icon Uri.
iconBrandColor
string
Connector icon brand color.
apiEnvironment
string
Connector api Environment.
isCustomApi
boolean
True if the Connector is a Custom Api.
runtimeUrls
array of string
runtimeUrls
primaryRuntimeUrl
string
Connector primary Runtime Url.
source
string
Connector source metadata.
brandColor
string
Connector brand Color metadata.
publisherUrl
string
Connector publisher URL metadata.
serviceUrl
string
Connector service URL metadata.
documentationUrl
string
Connector documentation URL.
environment
string
Connector environment metadata.
allowSharing
boolean
Connector allow Sharing field.
capabilities
array of string
Connector capabilities.
description
string
Connector description.
originalSwaggerUrl
string
Connector original swagger URL.
modifiedSwaggerUrl
string
Connector modified swagger URL.
id
string
Connector creator's principal object ID.
displayName
string
Connector creator's principal displayName.
email
string
Connector creator's principal email.
type
string
Connector creator's principal type.
tenantId
string
Connector creator's principal tenantId.
userPrincipalName
string
Connector creator's user principal name.
id
string
Connector last modified by principal object ID.
displayName
string
Connector last modified by principal displayName.
email
string
Connector last modified by principal email.
type
string
Connector last modified by principal type.
tenantId
string
Connector last modified by principal tenantId.
userPrincipalName
string
Connector last modified by user principal name.
createdTime
date-time
Connector created time.
changedTime
date-time
Connector changed time.
id
string
Connector Environment ID.
name
string
Connector Environment name.
tier
string
Connector tier.
publisher
string
Connector publisher's principal display name.

Remove App as Admin

Deletes a PowerApp.

Required Parameters

Environment Name
string
Name field of the Environment.
PowerApp Name
string
Name field of the PowerApp.

Optional Parameters

API Version
string
The date value of the API version.

Returns

put
array of object
App Role Assignment put object.
id
string
App Role Assignment ID field.
roleName
string
App Role Assignment property roleName.
scope
string
App Role Assignment property scope.
id
string
App Role Assignment principal object ID.
email
string
App Role Assignment principal email.
type
string
App Role Assignment principal type.
resourceResponses
array of object
App Role Assignment resourceResponse object.
id
string
App Role Assignment resourceResponse ID.
statusCode
string
App Role Assignment resourceResponse statusCode.
responseCode
string
App Role Assignment resourceResponse responseCode.
message
string
App Role Assignment resourceResponse message.
type
string
App Role Assignment resourceResponse type.

Remove Connection as Admin

Deletes a Connection.

Required Parameters

Environment Name
string
Name field of the Environment.
Connector Name
string
Name field of the Connector.
Connection Name
string
Name field of the Connection.

Optional Parameters

API Version
string
The date value of the API version.

Returns

put
array of object
App Role Assignment put object.
id
string
App Role Assignment ID field.
roleName
string
App Role Assignment property roleName.
scope
string
App Role Assignment property scope.
id
string
App Role Assignment principal object ID.
email
string
App Role Assignment principal email.
type
string
App Role Assignment principal type.
resourceResponses
array of object
App Role Assignment resourceResponse object.
id
string
App Role Assignment resourceResponse ID.
statusCode
string
App Role Assignment resourceResponse statusCode.
responseCode
string
App Role Assignment resourceResponse responseCode.
message
string
App Role Assignment resourceResponse message.
type
string
App Role Assignment resourceResponse type.

Set App Owner

Updates a PowerApp's owner role, and specifies the old owner's new role.

Required Parameters

Environment Name
string
Name field of the Environment.
PowerApp Name
string
Name field of the PowerApp.

Optional Parameters

API Version
string
The date value of the API version.
Content Type
string
The content type of the API request.
Role For Old App Owner
string
The role name for the old app owner. Choose from CanView, CanViewWithShare, or CanEdit.
New PowerApp Owner
string
The principal object ID of the new owner.

Returns

put
array of object
App Role Assignment put object.
id
string
App Role Assignment ID field.
roleName
string
App Role Assignment property roleName.
scope
string
App Role Assignment property scope.
id
string
App Role Assignment principal object ID.
email
string
App Role Assignment principal email.
type
string
App Role Assignment principal type.
resourceResponses
array of object
App Role Assignment resourceResponse object.
id
string
App Role Assignment resourceResponse ID.
statusCode
string
App Role Assignment resourceResponse statusCode.
responseCode
string
App Role Assignment resourceResponse responseCode.
message
string
App Role Assignment resourceResponse message.
type
string
App Role Assignment resourceResponse type.

Definitions

ResourceArray[PowerApp]

Next Link
string
The URL to get the next page of the Apps list. Contains the skiptoken.
value
array of PowerApp

PowerApp

appOpenProtocolUri
string
PowerApp property appOpenProtocolUri.
appOpenUri
string
PowerApp property appOpenUri.
appVersion
date-time
PowerApp property appVersion.
backgroundColor
string
PowerApp backgroundColor.
backgroundImageUri
string
PowerApp backgroundImageUri.
build
integer
PowerApp property createdByClientVersion build.
build
integer
PowerApp property minClientVersion build.
bypassConsent
boolean
PowerApp property bypassConsent.
connectionReferences
ConnectionReferences
createdTime
date-time
PowerApp property createdTime.
description
string
PowerApp description.
deviceCapabilities
string
PowerApp tag deviceCapabilities.
displayName
string
PowerApp last modified by principal displayName.
displayName
string
PowerApp owner principal displayName.
displayName
string
PowerApp creator principal displayName.
displayName
string
PowerApp displayName.
email
string
PowerApp last modified by principal email.
email
string
PowerApp owner principal email.
email
string
PowerApp creator principal email.
favorite
string
PowerApp property userAppMetadata favorite.
id
string
PowerApp last modified by principal object ID.
id
string
PowerApp Environment ID.
id
string
PowerApp ID field.
id
string
PowerApp owner principal user ID.
id
string
PowerApp creator principal object ID.
imageUris
array of string
PowerApp appUri imageUris array.
includeInAppsList
boolean
PowerApp property userAppMetadata includeInAppsList.
isFeaturedApp
boolean
PowerApp property isFeaturedApp.
isHeroApp
boolean
PowerApp property isHeroApp.
lastModifiedTime
date-time
PowerApp property lastModifiedTime.
major
integer
PowerApp property minClientVersion major.
major
integer
PowerApp property createdByClientVersion major.
majorRevision
integer
PowerApp property minClientVersion majorRevision.
majorRevision
integer
PowerApp property createdByClientVersion majorRevision.
minimumRequiredApiVersion
date-time
PowerApp tag minimumRequiredApiVersion.
minor
integer
PowerApp property minClientVersion minor.
minor
integer
PowerApp property createdByClientVersion minor.
minorRevision
integer
PowerApp property minClientVersion minorRevision.
minorRevision
integer
PowerApp property createdByClientVersion minorRevision.
name
string
PowerApp Environment name.
name
string
PowerApp name field.
primaryDeviceHeight
string
PowerApp tag primaryDeviceHeight.
primaryDeviceWidth
string
PowerApp tag primaryDeviceWidth.
primaryFormFactor
string
PowerApp tag primaryFormFactor.
publisherVersion
string
PowerApp tag publisherVersion.
readonlyValue
string
PowerApp appUri documentUri readonlyValue.
revision
integer
PowerApp property minClientVersion revision.
revision
integer
PowerApp property createdByClientVersion revision.
sharedGroupsCount
integer
PowerApp property sharedGroupsCount.
sharedUsersCount
integer
PowerApp property sharedUsersCount.
sienaVersion
string
PowerApp tag sienaVersion.
supportsLandscape
string
PowerApp tag supportsLandscape.
supportsPortrait
string
PowerApp tag supportsPortrait.
tenantId
string
PowerApp last modified by principal tenantId.
tenantId
string
PowerApp creator principal tenantId.
tenantId
string
PowerApp owner principal tenantId.
type
string
PowerApp last modified by principal type.
type
string
PowerApp creator principal type.
type
string
PowerApp owner principal type.
type
string
PowerApp type field.
userPrincipalName
string
PowerApp last modified by principal userPrincipalName.
userPrincipalName
string
PowerApp creator principal userPrincipalName.
userPrincipalName
string
PowerApp owner principal userPrincipalName.
value
string
PowerApp appUri documentUri value.

ConnectionReferences

Items
ConnectionReference

ConnectionReference

API tier
string
Api tier is standard or premium
Bypass consent
boolean
Flag indicates bypassed api consent
Connector Id
string
Connector display name
string
Custom API flag
boolean
Flag indicates custom connector
Data sources
array of string
List of data sources for the connection
Dependencies
array of string
List of dependencies for the connection
Dependents
array of string
List of dependant connectors for the connector
Icon URI
string
Is on premise connection
boolean
Flag indicates on premise data gateway