Skip to main content

Power BI Unused Artifacts API (preview)

Headshot of article author Derek Jaeger

Both Power BI Pro and Premium have built-in space limits. As such, Power BI Admins have been asking for visibility into potentially unused Power BI artifacts so they can take proactive action to manage space and remain within designated quotas.

As part of our ongoing focus to enhance visibility at the tenant level, we are pleased to announce the preview availability of the new Unused Artifacts API, which enables Power BI Admins to uncover potentially unused artifacts in order to more efficiently manage resources. This API returns a list of datasets, reports, or dashboards that have not been used within 30 days for a specified workspace.

 

Sample request:

GET https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/unused

 

Sample response:

"unusedArtifactEntities": [
{
"artifactId": "xxxxxxxx-xxx-xxxx-xxxx-xxxxxxxxxxxx",
"displayName": "onedrive-singlevalue",
"artifactType": "Dataset",
"artifactSizeInMB": 24,
"createdDateTime": "2021-04-16T21:43:48.79Z",
"lastAccessedDateTime": "2021-06-10T11:07:11.53Z"
},
{
"artifactId": "xxxxxxxx-xxx-xxxx-xxxx-xxxxxxxxxxxx",
"displayName": "Test3",
"artifactType": "Dataset",
"artifactSizeInMB": 1,
"createdDateTime": "2021-04-28T14:11:31.743Z",
"lastAccessedDateTime": "2021-04-28T14:11:34.18Z"
}
]

 

Users must have administrator rights (Office 365 Global Administrator, Power BI Service Administrator) or authenticate using a service principal in order to run the API. Delegated permissions are supported. Learn more about the new Unused Artifacts API here.

As always, we look forward to receiving your feedback, so please feel free to leave any comments or questions below.