Skip to content

Latest commit

 

History

History
324 lines (208 loc) · 11.7 KB

RolesAndPermissionsApi.md

File metadata and controls

324 lines (208 loc) · 11.7 KB

\RolesAndPermissionsApi

All URIs are relative to https://platform.devtest.ringcentral.com

Method HTTP request Description
CheckPermission Get /restapi/v1.0/account/{accountId}/extension/{extensionId}/authz-profile/check Check User Permissions
GetPermission Get /restapi/v1.0/dictionary/permission/{permissionId} Get Permission Info
GetPermissionCategory Get /restapi/v1.0/dictionary/permission-category/{permissionCategoryId} Get Permission Category
GetProfile Get /restapi/v1.0/account/{accountId}/extension/{extensionId}/authz-profile Get User Permissions
GetSystemRole Get /restapi/v1.0/dictionary/user-role/{roleId} Get User Role
ListPermissionCategories Get /restapi/v1.0/dictionary/permission-category Get Permissions Categories
ListPermissions Get /restapi/v1.0/dictionary/permission Get Permissions
ListSystemRoles Get /restapi/v1.0/dictionary/user-role Get Standard User Roles
LoadUserRole Get /restapi/v1.0/account/{accountId}/user-role/default Get Default User Role
UpdateUserRole Put /restapi/v1.0/account/{accountId}/user-role/default Set Default User Role

CheckPermission

AuthProfileCheckResource CheckPermission(ctx, extensionId, accountId, optional) Check User Permissions

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
extensionId string
accountId string
optional *CheckPermissionOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a CheckPermissionOpts struct

Name Type Description Notes

permissionId | optional.String| | targetExtensionId | optional.String| |

Return type

AuthProfileCheckResource

Authorization

OAuth2

HTTP request headers

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

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetPermission

PermissionResource GetPermission(ctx, permissionId) Get Permission Info

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
permissionId string

Return type

PermissionResource

Authorization

OAuth2

HTTP request headers

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

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetPermissionCategory

PermissionCategoryResource GetPermissionCategory(ctx, permissionCategoryId) Get Permission Category

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
permissionCategoryId string

Return type

PermissionCategoryResource

Authorization

OAuth2

HTTP request headers

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

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetProfile

AuthProfileResource GetProfile(ctx, extensionId, accountId) Get User Permissions

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
extensionId string
accountId string

Return type

AuthProfileResource

Authorization

OAuth2

HTTP request headers

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

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetSystemRole

RoleResource GetSystemRole(ctx, roleId) Get User Role

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
roleId string

Return type

RoleResource

Authorization

OAuth2

HTTP request headers

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

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ListPermissionCategories

PermissionCategoryCollectionResource ListPermissionCategories(ctx, optional) Get Permissions Categories

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
optional *ListPermissionCategoriesOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a ListPermissionCategoriesOpts struct

Name Type Description Notes
page optional.String [default to 1]
perPage optional.String [default to 100]
servicePlanId optional.String

Return type

PermissionCategoryCollectionResource

Authorization

OAuth2

HTTP request headers

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

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ListPermissions

PermissionCollectionResource ListPermissions(ctx, optional) Get Permissions

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
optional *ListPermissionsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a ListPermissionsOpts struct

Name Type Description Notes
page optional.String [default to 1]
perPage optional.String [default to 100]
assignable optional.Bool
servicePlanId optional.String

Return type

PermissionCollectionResource

Authorization

OAuth2

HTTP request headers

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

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ListSystemRoles

RolesCollectionResource ListSystemRoles(ctx, optional) Get Standard User Roles

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
optional *ListSystemRolesOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a ListSystemRolesOpts struct

Name Type Description Notes
page optional.String [default to 1]
perPage optional.String [default to 100]
servicePlanId optional.String

Return type

RolesCollectionResource

Authorization

OAuth2

HTTP request headers

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

[Back to top] [Back to API list] [Back to Model list] [Back to README]

LoadUserRole

LoadUserRole(ctx, accountId) Get Default User Role

Since 1.0.28 (Release 8.4)

Returns account default user role.

Required Permissions

PermissionDescription
RoleManagementEditing and assignment of user roles

API Group

Light

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
accountId string Internal identifier of an account [default to ~]

Return type

(empty response body)

Authorization

OAuth2

HTTP request headers

  • Content-Type: Not defined
  • Accept: Not defined

[Back to top] [Back to API list] [Back to Model list] [Back to README]

UpdateUserRole

UpdateUserRole(ctx, accountId, defaultUserRoleRequest) Set Default User Role

Since 1.0.30 (Release 9.1)

Updates account default user role.

Required Permissions

PermissionDescription
RoleManagementEditing and assignment of user roles

API Group

Light

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
accountId string Internal identifier of an account [default to ~]
defaultUserRoleRequest DefaultUserRoleRequest JSON body

Return type

(empty response body)

Authorization

OAuth2

HTTP request headers

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

[Back to top] [Back to API list] [Back to Model list] [Back to README]