Groups - Get Groups

Returns a list of workspaces the user has access to.

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

GET https://api.powerbi.com/v1.0/myorg/groups
GET https://api.powerbi.com/v1.0/myorg/groups?$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
example with filter

example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/groups

Sample Response

{
  "value": [
    {
      "id": "f089354e-8366-4e18-aea3-4cb4a3a50b48",
      "isReadOnly": false,
      "isOnDedicatedCapacity": false,
      "name": "sample group"
    },
    {
      "id": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "isReadOnly": false,
      "isOnDedicatedCapacity": false,
      "name": "marketing group"
    },
    {
      "id": "a2f89923-421a-464e-bf4c-25eab39bb09f",
      "isReadOnly": false,
      "isOnDedicatedCapacity": false,
      "name": "contoso"
    }
  ]
}

example with filter

Sample Request

GET https://api.powerbi.com/v1.0/myorg/groups?$filter=$filter=contains(name,'marketing')%20or%20name%20eq%20'contoso'

Sample Response

{
  "value": [
    {
      "id": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "isReadOnly": false,
      "isOnDedicatedCapacity": false,
      "name": "marketing group"
    },
    {
      "id": "a2f89923-421a-464e-bf4c-25eab39bb09f",
      "isReadOnly": false,
      "isOnDedicatedCapacity": false,
      "name": "contoso"
    }
  ]
}

Definitions

Group

A Power BI Group

GroupUserAccessRight

A Power BI user access right entry for group

GroupUserAccessRightEnum

Access rights user has for the group

ODataResponse[List[Group]]

Odata response wrapper for a Power BI Group list

Group

A Power BI Group

Name Type Description
capacityId
  • string

The capacity id

description
  • string

The group description

id
  • string

The workspace id

isOnDedicatedCapacity
  • boolean

Is the group on dedicated capacity

isReadOnly
  • boolean

Is the group read only

name
  • string

The group name

state
  • string

The group state

type
  • string

The type of group

users

The users that belong to the group, with their access rights

GroupUserAccessRight

A Power BI user access right entry for group

Name Type Description
emailAddress
  • string

Email address of the user

groupUserAccessRight

Access rights user has for the group

GroupUserAccessRightEnum

Access rights user has for the group

Name Type Description
Admin
  • string
Contributor
  • string
Member
  • string
None
  • string

ODataResponse[List[Group]]

Odata response wrapper for a Power BI Group list

Name Type Description
odata.context
  • string

OData context

value

The groups