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.
Assign roles to principals for the given Organization. At most 100 role assignments can be added 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 \
-H "Content-type: application/json" \
-H "Authorization: Bearer $TOKEN" \
"https://$HOSTNAME/api/v2/admin/organizations/ri.multipass..organization.c30ee6ad-b5e4-4afe-a74f-fe4a289f2faa/roleAssignments/add?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 | |
Add | Error Code | PERMISSION_DENIED |
| Status Code | 403 | |
| Description | Could not add the OrganizationRoleAssignment. | |
| Parameters | organizationRid | |
Organization | Error Code | NOT_FOUND |
| Status Code | 404 | |
| Description | The given Organization could not be found. | |
| Parameters | organizationRid | |
See Errors for a general overview of errors in the platform.