Admin - Apps GetAppsAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

Returns a list of apps in the organization.

The query parameter $top is required.

Permissions

• The user must have administrator rights (such as Office 365 Global Administrator or Power BI Service 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?$top={$top}

With optional parameters:

GET https://api.powerbi.com/v1.0/myorg/admin/apps?$top={$top}&$skip={$skip}

URI Parameters

Name	In	Required	Type	Description
$top	query	True	integer	The requested number of apps.
$skip	query		integer	The number entries to be skipped.

Responses

Name	Type	Description
200 OK	AdminApps	OK

Examples

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/apps?$top=10

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "f089354e-8366-4e18-aea3-4cb4a3a50b48",
      "description": "The finance app",
      "name": "Finance",
      "publishedBy": "Bill",
      "lastUpdate": "2019-01-13T09:46:53.094+02:00"
    },
    {
      "id": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "description": "The marketing app",
      "name": "Marketing",
      "publishedBy": "Ben",
      "lastUpdate": "2018-11-13T09:46:53.094+02:00"
    }
  ]
}

Definitions

Name	Description
AdminApp
AdminApps	The OData response wrapper for a list of Power BI installed apps for Admin APIs

AdminApp

Name	Type	Description
description	string	The app description
id	string	The app ID
lastUpdate	string	The date and time the app was last updated
name	string	The app name
publishedBy	string	The app publisher
workspaceId	string	Associated workspace for the app

AdminApps

The OData response wrapper for a list of Power BI installed apps for Admin APIs

Name	Type	Description
odata.context	string	OData context
value	AdminApp[]	The list of installed apps