Capacities - Groups AssignToCapacity

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

Assigns the specified workspace to the specified capacity.
Note: To perform this operation, the user must be admin on the specified workspace and have admin or assign permissions on the capacity. To unassign the specified workspace from a capacity, Empty Guid (00000000-0000-0000-0000-000000000000) should be provided as capacityId.

Required scope: Capacity.ReadWrite.All and Workspace.ReadWrite.All
To set the permissions scope, see Register an app.

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/AssignToCapacity

URI Parameters

Name In Required Type Description
groupId
 path True
  • string
uuid

The workspace id

Request Body

Name Required Type Description
capacityId True
  • string

The capacity id. To unassign from capacity, use Empty Guid (00000000-0000-0000-0000-000000000000).

Responses

Name Type Description
200 OK

OK

Examples

example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/AssignToCapacity
Request Body
{
  "capacityId": "0f084df7-c13d-451b-af5f-ed0c466403b2"
}

Sample Response

Status code:
200

Definitions

AssignToCapacityRequest

Power BI assign to capacity request

Name Type Description
capacityId
  • string

The capacity id. To unassign from capacity, use Empty Guid (00000000-0000-0000-0000-000000000000).