Admin - Apps GetAppUsersAsAdmin

Service:: Power BI REST APIs

API Version:: v1.0

Returns a list of users that have access to the specified app.

Permissions

The user must be a Fabric administrator or authenticate using a service principal.
Delegated permissions are supported.

When running under service prinicipal authentication, an app must not have any admin-consent required premissions for Power BI set on it in the Azure portal.

Required Scope

Tenant.Read.All or Tenant.ReadWrite.All

Relevant only when authenticating via a standard delegated admin access token. Must not be present when authentication via a service principal is used.

Limitations

Maximum 200 requests per hour.

GET https://api.powerbi.com/v1.0/myorg/admin/apps/{appId}/users

URI Parameters

Name	In	Required	Type	Description
appId	path	True	string (uuid)	The app ID

Responses

Name	Type	Description
200 OK	AppUsers	OK

Examples

Example

Sample request

GET https://api.powerbi.com/v1.0/myorg/admin/apps/f089354e-8366-4e18-aea3-4cb4a3a50b48/users

Sample response

Status code:: 200

{
  "value": [
    {
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "appUserAccessRight": "ReadExplore",
      "identifier": "john@contoso.com",
      "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
      "principalType": "User"
    }
  ]
}

Definitions

Name	Description
AppUser	A Power BI user access right entry for an app
AppUserAccessRight	The access right that the user has for the app
AppUsers	The OData response wrapper for a list of Power BI users with access to an app
PrincipalType	The principal type

AppUser

Object

A Power BI user access right entry for an app

Name	Type	Description
appUserAccessRight	AppUserAccessRight	The access right that the user has for the app
displayName	string	Display name of the principal
emailAddress	string	Email address of the user
graphId	string	Identifier of the principal in Microsoft Graph. Only available for admin APIs.
identifier	string	Identifier of the principal
principalType	PrincipalType	The principal type

AppUserAccessRight

Enumeration

The access right that the user has for the app

Value	Description
None	No permission to content in app
Read	Grants Read access to content in app
ReadWrite	Grants Read and Write access to content in app
ReadReshare	Grants Read and Reshare access to content in app
ReadWriteReshare	Grants Read, Write and Reshare access to content in app
ReadExplore	Grants Read and Explore access to content in app
ReadCopy	Grants Read and Copy access to content in app
ReadExploreCopy	Grants Read, Explore and Copy access to content in app
ReadReshareExplore	Grants Read, Reshare and Explore access to content in app
ReadReshareExploreCopy	Grants Read, Reshare, Explore and Copy access to content in app
ReadWriteExplore	Grants Read, Write and Explore access to content in app
ReadWriteReshareExplore	Grants Read, Write, Reshare and Explore access to content in app
ReadWriteExploreCopy	Grants Read, Write, Explore and Copy access to content in app
ReadReshareCopy	Grants Read, Reshare, and Copy access to content in app
All	Grants Read, Write, Explore, Reshare and Copy access to content in app

AppUsers