Access Control - Unassign Role
Unassign a role from principal.
POST https://prod.core.sphere.azure.net/v2/tenants/{tenantId}/users/{userId}/role/{roleName}/unassignURI Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
|
role
|
path | True |
string |
The name of the role to unassign from userId. Some supported role names include 'Administrator' and 'Contributor'. For a list of all supported role names, use /v2/tenants/{tenantId}/users/{userId}/role API. |
|
tenant
|
path | True |
string (uuid) |
The tenant ID in which to unassign the role. |
|
user
|
path | True |
string |
Principal ID or email address to unassign role. |
Responses
| Name | Type | Description |
|---|---|---|
| 200 OK |
Success. |
Examples
Assign the Reader role
Sample request
POST https://prod.core.sphere.azure.net/v2/tenants/768c2cd6-1bf0-4521-9f53-084a331d81cb/users/avery@contoso.com/role/Reader/unassign