Capacities - Groups AssignToCapacity
Assigns the specified workspace to the specified capacity.
To unassign My workspace from a capacity, provide an empty GUID (00000000-0000-0000-0000-000000000000) as the capacityId.
Permissions
- The user must have administrator rights or assign permissions on the capacity.
- This API call can be called by a service principal profile. For more information see: Service principal profiles in Power BI Embedded.
Required Scope
Capacity.ReadWrite.All and Workspace.ReadWrite.All
POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/AssignToCapacityURI Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
|
group
|
path | True |
string uuid |
The workspace ID |
Request Body
| Name | Required | Type | Description |
|---|---|---|---|
| capacityId | True |
string |
The capacity ID. To unassign from a capacity, use an empty GUID ( |
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{
"capacityId": "0f084df7-c13d-451b-af5f-ed0c466403b2"
}Sample response
Definitions
AssignToCapacityRequest
A Power BI assign-to-capacity request
| Name | Type | Description |
|---|---|---|
| capacityId |
string |
The capacity ID. To unassign from a capacity, use an empty GUID ( |