Groups - Create Group

Creates a new workspace.

Required scope

Workspace.ReadWrite.All

POST https://api.powerbi.com/v1.0/myorg/groups
POST https://api.powerbi.com/v1.0/myorg/groups?workspaceV2={workspaceV2}

URI Parameters

Name In Required Type Description
workspaceV2
query
  • boolean

Preview feature: Create a workspace V2. The only supported value is true.

Request Body

Name Required Type Description
name True
  • string

The name of the newly created group

Responses

Name Type Description
200 OK

OK

Examples

example
example creating a workspace V2

example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups
{
  "name": "sample group"
}

Sample Response

{
  "value": [
    {
      "id": "f089354e-8366-4e18-aea3-4cb4a3a50b48",
      "isReadOnly": false,
      "isOnDedicatedCapacity": false,
      "name": "sample group"
    }
  ]
}

example creating a workspace V2

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups?workspaceV2=True
{
  "name": "sample workspace V2"
}

Sample Response

{
  "value": [
    {
      "id": "f089354e-8366-4e18-aea3-4cb4a3a50b48",
      "isOnDedicatedCapacity": false,
      "name": "sample workspace V2"
    }
  ]
}

Definitions

Group

A Power BI group

GroupCreationRequest

A Power BI request to create a new group

Group

A Power BI group

Name Type Description
capacityId
  • string

The capacity ID

dataflowStorageId
  • string

The Power BI dataflow storage account ID

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

GroupCreationRequest

A Power BI request to create a new group

Name Type Description
name
  • string

The name of the newly created group