Admin - Datasets GetDatasetsAsAdmin

Service:
Power BI REST APIs
API Version:
v1.0

Returns a list of datasets for the organization.
Note: The user must have administrator rights (such as Office 365 Global Administrator or Power BI Service Administrator) to call this API.

Required scope: Tenant.Read.All or Tenant.ReadWrite.All
To set the permissions scope, see Register an app.

GET https://api.powerbi.com/v1.0/myorg/admin/datasets
With optional parameters: 
GET https://api.powerbi.com/v1.0/myorg/admin/datasets?$filter={$filter}&$top={$top}&$skip={$skip}

URI Parameters

Name In Required Type Description
$filter
 query
  • string

Filters the results, based on a boolean condition
$top
 query
  • integer
int32

Returns only the first n results
$skip
 query
  • integer
int32

Skips the first n results

Responses

Name Type Description
200 OK

OK

Examples

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/datasets

Sample Response

Status code:
200 
{
  "value": [
    {
      "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
      "name": "SalesMarketing",
      "addRowsAPIEnabled": false,
      "configuredBy": "john@contoso.com",
      "isRefreshable": true,
      "isEffectiveIdentityRequired": false,
      "isEffectiveIdentityRolesRequired": false,
      "isOnPremGatewayRequired": false
    }
  ]
}

Definitions

Dataset

A Power BI dataset
Datasets

A dataset odata list wrapper

Dataset

A Power BI dataset

Name Type Description
IsEffectiveIdentityRequired
  • boolean

Dataset requires effective identity
IsEffectiveIdentityRolesRequired
  • boolean

Dataset requires roles
IsOnPremGatewayRequired
  • boolean

Dataset requires an On-premises Data Gateway
IsRefreshable
  • boolean

Can this dataset be refreshed
addRowsAPIEnabled
  • boolean

Whether dataset allows adding new rows
configuredBy
  • string

The dataset owner
id
  • string

The dataset id
name
  • string

The dataset name
webUrl
  • string

The dataset web url

Datasets

A dataset odata list wrapper

Name Type Description
odata.context
  • string

OData context
value

The datasets