Groups - Update Group User
Updates the specified user permissions to the specified workspace.
This API call can be called by a service principal profile. For more information see: Service principal profiles in Power BI Embedded.
Workspace.ReadWrite.All
- User permissions for workspaces take time to get updated and may not be immediately available when using API calls. To refresh user permissions, use the Refresh User Permissions API call.
PUT https://api.powerbi.com/v1.0/myorg/groups/{groupId}/users
Name | In | Required | Type | Description |
---|---|---|---|---|
group
|
path | True |
string uuid |
The workspace ID |
Name | Required | Type | Description |
---|---|---|---|
groupUserAccessRight | True |
The access right (permission level) that a user has on the workspace |
|
identifier | True |
string |
Identifier of the principal |
principalType | True |
The principal type |
|
displayName |
string |
Display name of the principal |
|
emailAddress |
string |
Email address of the user |
|
graphId |
string |
Identifier of the principal in Microsoft Graph. Only available for admin APIs. |
|
profile |
A Power BI service principal profile. Only relevant for Power BI Embedded multi-tenancy solution. |
||
userType |
string |
Type of the user. |
Name | Type | Description |
---|---|---|
200 OK |
OK |
Sample request
PUT https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/users
{
"identifier": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
"groupUserAccessRight": "Admin",
"principalType": "App"
}
Sample response
Sample request
PUT https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/users
{
"emailAddress": "john@contoso.com",
"groupUserAccessRight": "Admin"
}
Sample response
Name | Description |
---|---|
Group |
A Power BI user with access to the workspace |
Group |
The access right (permission level) that a user has on the workspace |
Principal |
The principal type |
Service |
A Power BI service principal profile. Only relevant for Power BI Embedded multi-tenancy solution. |
A Power BI user with access to the workspace
Name | Type | Description |
---|---|---|
displayName |
string |
Display name of the principal |
emailAddress |
string |
Email address of the user |
graphId |
string |
Identifier of the principal in Microsoft Graph. Only available for admin APIs. |
groupUserAccessRight |
The access right (permission level) that a user has on the workspace |
|
identifier |
string |
Identifier of the principal |
principalType |
The principal type |
|
profile |
A Power BI service principal profile. Only relevant for Power BI Embedded multi-tenancy solution. |
|
userType |
string |
Type of the user. |
The access right (permission level) that a user has on the workspace
Name | Type | Description |
---|---|---|
Admin |
string |
Administrator rights to workspace content |
Contributor |
string |
Read and explore (ReadExplore) access to workspace content |
Member |
string |
Read, reshare and explore (ReadReshareExplore) access rights to workspace content |
None |
string |
No access to workspace content |
Viewer |
string |
Read-only (Read) access to workspace content |
The principal type
Name | Type | Description |
---|---|---|
App |
string |
Service principal type |
Group |
string |
Group principal type |
None |
string |
No principal type. Use for whole organization level access. |
User |
string |
User principal type |
A Power BI service principal profile. Only relevant for Power BI Embedded multi-tenancy solution.
Name | Type | Description |
---|---|---|
displayName |
string |
The service principal profile name |
id |
string |
The service principal profile ID |