Admin - Groups GetUnusedArtifactsAsAdmin
Returns a list of datasets, reports, and dashboards that have not been used within 30 days for the specified workspace. This is a preview API call.
Permissions
- The user must be a Fabric 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/groups/{groupId}/unused
GET https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/unused?continuationToken={continuationToken}
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
group
|
path | True |
string uuid |
The workspace ID |
continuation
|
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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/unused
Sample response
Definitions
Name | Description |
---|---|
Unused |
The unused Power BI item entity |
Unused |
OData response wrapper for unused Power BI item (such as a report or a dashboard) entities |
UnusedArtifactEntity
The unused Power BI item entity
Name | Type | Description |
---|---|---|
artifactId |
string |
The ID of the Power BI item |
artifactSizeInMB |
integer |
The size of the Power BI item in megabytes (if applicable) |
artifactType |
string |
The Power BI item type |
createdDateTime |
string |
The creation time of the Power BI item (if applicable) |
displayName |
string |
The display name of the Power BI item |
lastAccessedDateTime |
string |
The last access time of the Power BI item (if applicable) |
UnusedArtifactsResponse
OData response wrapper for unused Power BI item (such as a report or a dashboard) entities
Name | Type | Description |
---|---|---|
continuationToken |
string |
Token to get the next chunk of the result set |
continuationUri |
string |
The URI for the next chunk in the result set |
unusedArtifactEntities |
The unused Power BI item entities |