Skip to main content

RolesApi

MethodHTTP requestDescription
DeleteUserSiteRoleAssociationUsingDELETEDELETE /api/web/v1/users/{userid}/roles/{roleid}Delete a site role from a user
GetSiteRoleUsingGETGET /api/web/v1/roles/{id}Get a role
GetUserRolesUsingGETGET /api/web/v1/users/{userid}/rolesList all site roles assigned to user
GetUserSiteRoleAssociationUsingGETGET /api/web/v1/users/{userid}/roles/{roleid}Get site role assigned to user
ListSiteRolesUsingGETGET /api/web/v1/rolesList roles
ModifyUserSiteRoleAssociationUsingPUTPUT /api/web/v1/users/{userid}/roles/{roleid}Set user role

DeleteUserSiteRoleAssociationUsingDELETE

void DeleteUserSiteRoleAssociationUsingDELETE (string userid, string roleid)

Delete a site role from a user

Delete a user's site role. Caller requires the USERSITEROLES:REMOVE permission.

Using the DeleteUserSiteRoleAssociationUsingDELETEWithHttpInfo variant

This returns an ApiResponse object which contains the response data, status code and headers.

Parameters

NameTypeDescriptionNotes
useridstringThe UUID of the user from which the role is to be removed.
roleidstringThe UUID of the role that is to be removed.

Return type

void (empty response body)

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-

GetSiteRoleUsingGET

Role GetSiteRoleUsingGET (string id)

Get a role

Get a specified role. Caller requires the ROLES:VIEW permission.

Example

Using the GetSiteRoleUsingGETWithHttpInfo variant

This returns an ApiResponse object which contains the response data, status code and headers.

Parameters

NameTypeDescriptionNotes
idstringThe UUID of the role to be fetched.

Return type

Role

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-

GetUserRolesUsingGET

List<Role> GetUserRolesUsingGET (string userid)

List all site roles assigned to user

List all site roles assigned to the specified user. Caller requires the USERSITEROLES:VIEW permission.

Example

Using the GetUserRolesUsingGETWithHttpInfo variant

This returns an ApiResponse object which contains the response data, status code and headers.

Parameters

NameTypeDescriptionNotes
useridstringThe UUID of the user.

Return type

List<Role>

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-

GetUserSiteRoleAssociationUsingGET

Role GetUserSiteRoleAssociationUsingGET (string userid, string roleid)

Get site role assigned to user

Get the specified site role assigned to the specified user. Caller requires the USERSITEROLES:VIEW permission.

Example

Using the GetUserSiteRoleAssociationUsingGETWithHttpInfo variant

This returns an ApiResponse object which contains the response data, status code and headers.

Parameters

NameTypeDescriptionNotes
useridstringThe UUID of the user to which the role is assigned.
roleidstringThe UUID of the role assigned to the user.

Return type

Role

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-

ListSiteRolesUsingGET

List<RoleUser> ListSiteRolesUsingGET ()

List roles

List all roles. Caller requires the ROLES:VIEW permission.

Example

Using the ListSiteRolesUsingGETWithHttpInfo variant

This returns an ApiResponse object which contains the response data, status code and headers.

Parameters

This endpoint does not need any parameter.

Return type

List<RoleUser>

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-

ModifyUserSiteRoleAssociationUsingPUT

void ModifyUserSiteRoleAssociationUsingPUT (string userid, string roleid)

Set user role

Set the role of the given user to the given role. Caller requires the USERSITEROLES:EDIT permission.

Example

Using the ModifyUserSiteRoleAssociationUsingPUTWithHttpInfo variant

This returns an ApiResponse object which contains the response data, status code and headers.

Parameters

NameTypeDescriptionNotes
useridstringThe UUID of the user whose role is to be modified.
roleidstringThe UUID of the role which will be assigned to the user.

Return type

void (empty response body)

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-