Workspaces - Update Workspace Role Assignment
Note
This API is in preview.
Updates a principal's role assignment over a workspace.
The role assignment of the last admin can't be changed.
Permissions
The caller must have admin role on the workspace.
Required Delegated Scopes
Workspace.ReadWrite.All
Interface
PATCH https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/roleAssignments/{principalId}
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
principal
|
path | True |
string uuid |
The principal ID. |
workspace
|
path | True |
string uuid |
The workspace ID. |
Request Body
Name | Type | Description |
---|---|---|
role |
The workspace role of the principal. |
Responses
Name | Type | Description |
---|---|---|
200 OK |
Request completed successfully. |
|
Other Status Codes |
Common error codes:
|
Examples
Update workspace role assignment example
Sample Request
PATCH https://api.fabric.microsoft.com/v1/workspaces/0ac682f5-aee3-4968-9d21-692eb3fd4056/roleAssignments/0218b8c4-f5a2-4a1e-bbbd-a986dd8aeb81
{
"role": "Contributor"
}
Sample Response
{
"principal": {
"displayName": "user1",
"id": "0218b8c4-f5a2-4a1e-bbbd-a986dd8aeb81",
"type": "User",
"userDetails": {
"userPrincipalName": "user1@microsoft.com"
}
},
"role": "Contributor"
}
Definitions
Name | Description |
---|---|
Error |
The error related resource details object. |
Error |
The error response. |
Error |
The error response details. |
Group |
Group specific details. Applicable when the principal type is |
Group |
The type of the group. Additional group types may be added over time. |
Principal | |
Principal |
The type of the principal. Additional principal types may be added over time. |
Service |
Service principal specific details. Applicable when the principal type is |
Service |
Service principal profile details. Applicable when the principal type is |
Update |
Update workspace role assignment request payload. |
User |
User principal specific details. Applicable when the principal type is |
Workspace |
A Workspace role. Additional WorkspaceRole types may be added over time. |
Workspace |
A workspace role assignment (principal and workspace role). |
ErrorRelatedResource
The error related resource details object.
Name | Type | Description |
---|---|---|
resourceId |
string |
The resource ID that's involved in the error. |
resourceType |
string |
The type of the resource that's involved in the error. |
ErrorResponse
The error response.
Name | Type | Description |
---|---|---|
errorCode |
string |
A specific identifier that provides information about an error condition, allowing for standardized communication between our service and its users. |
message |
string |
A human readable representation of the error. |
moreDetails |
List of additional error details. |
|
relatedResource |
The error related resource details. |
|
requestId |
string |
ID of the request associated with the error. |
ErrorResponseDetails
The error response details.
Name | Type | Description |
---|---|---|
errorCode |
string |
A specific identifier that provides information about an error condition, allowing for standardized communication between our service and its users. |
message |
string |
A human readable representation of the error. |
relatedResource |
The error related resource details. |
GroupDetails
Group specific details. Applicable when the principal type is Group
.
Name | Type | Description |
---|---|---|
groupType |
The type of the group. Additional group types may be added over time. |
GroupType
The type of the group. Additional group types may be added over time.
Name | Type | Description |
---|---|---|
DistributionList |
string |
Principal is a distribution list. |
SecurityGroup |
string |
Principal is a security group. |
Unknown |
string |
Principal group type is unknown. |
Principal
Name | Type | Description |
---|---|---|
displayName |
string |
The principal's display name. |
groupDetails |
Group specific details. Applicable when the principal type is |
|
id |
string |
The principal's ID. |
servicePrincipalDetails |
Service principal specific details. Applicable when the principal type is |
|
servicePrincipalProfileDetails |
Service principal profile details. Applicable when the principal type is |
|
type |
The type of the principal. Additional principal types may be added over time. |
|
userDetails |
User principal specific details. Applicable when the principal type is |
PrincipalType
The type of the principal. Additional principal types may be added over time.
Name | Type | Description |
---|---|---|
Group |
string |
Principal is a security group. |
ServicePrincipal |
string |
Principal is a Microsoft Entra service principal. |
ServicePrincipalProfile |
string |
Principal is a service principal profile. |
User |
string |
Principal is a Microsoft Entra user principal. |
ServicePrincipalDetails
Service principal specific details. Applicable when the principal type is ServicePrincipal
.
Name | Type | Description |
---|---|---|
aadAppId |
string |
The service principal's Microsoft Entra AppId. |
ServicePrincipalProfileDetails
Service principal profile details. Applicable when the principal type is ServicePrincipalProfile
.
Name | Type | Description |
---|---|---|
parentPrincipal |
The service principal profile's parent principal. |
UpdateWorkspaceRoleAssignmentRequest
Update workspace role assignment request payload.
Name | Type | Description |
---|---|---|
role |
The workspace role of the principal. |
UserDetails
User principal specific details. Applicable when the principal type is User
.
Name | Type | Description |
---|---|---|
userPrincipalName |
string |
The user principal name. |
WorkspaceRole
A Workspace role. Additional WorkspaceRole types may be added over time.
Name | Type | Description |
---|---|---|
Admin |
string |
Enables administrative access to the workspace. |
Contributor |
string |
Enables contribution to the workspace. |
Member |
string |
Enables membership access to the workspace. |
Viewer |
string |
Enables viewing of the workspace. |
WorkspaceRoleAssignment
A workspace role assignment (principal and workspace role).
Name | Type | Description |
---|---|---|
principal |
The principal. |
|
role |
The workspace role of the principal. |