RolesApi
| Method | HTTP request | Description |
|---|---|---|
| deleteUserSiteRoleAssociationUsingDELETE | DELETE /api/web/v1/users/{userid}/roles/{roleid} | Delete a site role from a user |
| getSiteRoleUsingGET | GET /api/web/v1/roles/{id} | Get a role |
| getUserRolesUsingGET | GET /api/web/v1/users/{userid}/roles | List all site roles assigned to user |
| getUserSiteRoleAssociationUsingGET | GET /api/web/v1/users/{userid}/roles/{roleid} | Get site role assigned to user |
| listSiteRolesUsingGET | GET /api/web/v1/roles | List roles |
| modifyUserSiteRoleAssociationUsingPUT | PUT /api/web/v1/users/{userid}/roles/{roleid} | Set user role |
deleteUserSiteRoleAssociationUsingDELETE
deleteUserSiteRoleAssociationUsingDELETE(userid, roleid)
Delete a site role from a user
Delete a user's site role. Caller requires the USERSITEROLES:REMOVE permission.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| userid | String | The UUID of the user from which the role is to be removed. | |
| roleid | String | The UUID of the role that is to be removed. |
Return type
null (empty response body)
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
getSiteRoleUsingGET
Role getSiteRoleUsingGET(id)
Get a role
Get a specified role. Caller requires the ROLES:VIEW permission.
Example
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| id | String | The UUID of the role to be fetched. |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
getUserRolesUsingGET
List<Role> getUserRolesUsingGET(userid)
List all site roles assigned to user
List all site roles assigned to the specified user. Caller requires the USERSITEROLES:VIEW permission.
Example
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| userid | String | The UUID of the user. |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
getUserSiteRoleAssociationUsingGET
Role getUserSiteRoleAssociationUsingGET(userid, roleid)
Get site role assigned to user
Get the specified site role assigned to the specified user. Caller requires the USERSITEROLES:VIEW permission.
Example
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| userid | String | The UUID of the user to which the role is assigned. | |
| roleid | String | The UUID of the role assigned to the user. |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
listSiteRolesUsingGET
List<RoleUser> listSiteRolesUsingGET()
List roles
List all roles. Caller requires the ROLES:VIEW permission.
Example
Parameters
This endpoint does not need any parameter.
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
modifyUserSiteRoleAssociationUsingPUT
modifyUserSiteRoleAssociationUsingPUT(userid, roleid)
Set user role
Set the role of the given user to the given role. Caller requires the USERSITEROLES:EDIT permission.
Example
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| userid | String | The UUID of the user whose role is to be modified. | |
| roleid | String | The UUID of the role which will be assigned to the user. |
Return type
null (empty response body)
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |