This endpoint is in preview and may be modified or removed at any time.
To use this endpoint, add preview=true to the request query parameters.
Remove roles from principals for the given Enrollment. At most 100 role assignments can be removed in a single request.
Third-party applications using this endpoint via OAuth2 must request the following operation scope: api:admin-write.
objectlist<RoleAssignmentUpdate>1
2
3
4
5
curl -X POST \
\t-H "Content-type: application/json" \
\t-H "Authorization: Bearer $TOKEN" \
"https://$HOSTNAME/api/v2/admin/enrollments/ri.control-panel.main.customer.466f812b-f974-4478-9d4f-90402cd3def6/roleAssignments/remove?preview=true" \
-d '{"roleAssignments":[{"roleId":"8bf49052-dc37-4528-8bf0-b551cfb71268","principalId":"f05f8da4-b84c-4fca-9c77-8af0b13d11de"}]}'| Error Name | ||
|---|---|---|
Principal | Error Code | NOT_FOUND |
| Status Code | 404 | |
| Description | A principal (User or Group) with the given PrincipalId could not be found | |
| Parameters | principalId | |
Enrollment | Error Code | NOT_FOUND |
| Status Code | 404 | |
| Description | One of the provided role IDs was not found. | |
| Parameters | | |
Remove | Error Code | PERMISSION_DENIED |
| Status Code | 403 | |
| Description | Could not remove the EnrollmentRoleAssignment. | |
| Parameters | enrollmentRid | |
Enrollment | Error Code | NOT_FOUND |
| Status Code | 404 | |
| Description | The given Enrollment could not be found. | |
| Parameters | enrollmentRid | |
See Errors for a general overview of errors in the platform.