Admin - Groups GetUnusedArtifactsAsAdmin

Returns a list of datasets that have not been used within 30 days for the specified workspace (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/groups/{groupId}/unused

URI Parameters

Name In Required Type Description
groupId
path True
  • string
uuid

The workspace ID

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

UnusedArtifactEntity

Unused artifact entity

UnusedArtifactsResponse

Odata response wrapper for unused artifact entities

UnusedArtifactEntity

Unused artifact entity

Name Type Description
artifactId
  • string

Artifact ID

artifactSizeInMB
  • integer

Artifact size in MB if applicable

artifactType
  • string

Type of the artifact

createdDateTime
  • string

Artifact created time if applicable

displayName
  • string

Display name of the artifact

lastAccessedDateTime
  • string

Artifact last accessed time if applicable

UnusedArtifactsResponse

Odata response wrapper for unused artifact entities

Name Type Description
unusedArtifactEntities

The unused artifact entities