Admin - Users GetUserArtifactAccessAsAdmin

Returns a list of artifacts that the given user have access to (Preview).

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.

Required scope

Tenant.Read.All or Tenant.ReadWrite.All

Limitations

Maximum 200 requests per hour.

GET https://api.powerbi.com/v1.0/myorg/admin/users/{userGraphId}/artifactAccess
GET https://api.powerbi.com/v1.0/myorg/admin/users/{userGraphId}/artifactAccess?continuationToken={continuationToken}

URI Parameters

Name In Required Type Description
userGraphId
path True
  • string
uuid

The graph ID of user

continuationToken
query
  • string

Token required to get the next chunk of the result set

Responses

Name Type Description
200 OK

OK

Examples

example

Sample Request

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

Sample Response

{
  "artifactAccessEntities": [
    {
      "artifactId": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87",
      "displayName": "test report",
      "artifactType": "Report",
      "accessRight": "ReadWrite"
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/f089354e-8366-4e18-aea3-4cb4a3a50b48/artifactAccess?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

Definitions

ArtifactAccessEntry

A user access entry for a Power BI item

ArtifactAccessResponse

The OData response wrapper for a list of Power BI items (such as a report or a dashboard) that a user can access

ArtifactAccessEntry

A user access entry for a Power BI item

Name Type Description
accessRight
  • string

The access right that the user has for the Power BI item

artifactId
  • string

The Power BI item ID

artifactType
  • string

The type of Power BI item

displayName
  • string

The display name of the Power BI item

ArtifactAccessResponse

The OData response wrapper for a list of Power BI items (such as a report or a dashboard) that a user can access

Name Type Description
artifactAccessEntities

The list of Power BI items that a user can access

continuationToken
  • string

The token for the next chunk in the result set

continuationUri
  • string

The URI of the next chunk in the result set

odata.context
  • string