Skip to content

Latest commit

 

History

History
253 lines (158 loc) · 12.6 KB

CompanySettingsApi.md

File metadata and controls

253 lines (158 loc) · 12.6 KB

\CompanySettingsApi

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

Method HTTP request Description
DeleteAccount Delete /restapi/v1.0/account/{accountId} Delete Account
ListDialingPlans Get /restapi/v1.0/account/{accountId}/dialing-plan Get Available Dialing Plans
LoadAccount Get /restapi/v1.0/account/{accountId} Get Company Info
LoadAccountBusinessAddress Get /restapi/v1.0/account/{accountId}/business-address Get Company Business Address
LoadServiceInfo Get /restapi/v1.0/account/{accountId}/service-info Get Account Service Info
ModifyAccount Put /restapi/v1.0/account/{accountId} Update Company
UpdateAccountBusinessAddress Put /restapi/v1.0/account/{accountId}/business-address Update Company Business Address
UpdateServiceInfo Put /restapi/v1.0/account/{accountId}/service-info Update Account Service Info [Beta]

DeleteAccount

DeleteAccount(ctx, accountId) Delete Account

Since 1.0.0

Updates account information.

Required Permissions

PermissionDescription
EditAccountsViewing and updating user account info (including name, business name, address and phone number/account number)

Usage Plan Group

Medium

Required Parameters

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

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]

ListDialingPlans

GetDialingPlanInfo ListDialingPlans(ctx, accountId, optional) Get Available Dialing Plans

Returns list of countries which can be selected for a dialing plan (to call short numbers and special services).

Required Permissions

PermissionDescription
ReadAccountsViewing user account info (including name, business name, address and phone number/account number)

Usage Plan Group

Heavy

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
accountId string Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session [default to ~]
optional *ListDialingPlansOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a ListDialingPlansOpts struct

Name Type Description Notes

page | optional.Int32| Indicates the page number to retrieve. Only positive number values are allowed. Default value is '1' | perPage | optional.Int32| Indicates the page size (number of items). If not specified, the value is '100' by default |

Return type

GetDialingPlanInfo

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]

LoadAccount

GetAccountInfoResponse LoadAccount(ctx, accountId) Get Company Info

Since 1.0.0

Returns basic information about a particular RingCentral customer account.

Required Permissions

PermissionDescription
ReadAccountsViewing user account info (including name, business name, address and phone number/account number)

Usage Plan Group

Light

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
accountId string Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session [default to ~]

Return type

GetAccountInfoResponse

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]

LoadAccountBusinessAddress

GetAccountInfoResponse LoadAccountBusinessAddress(ctx, accountId) Get Company Business Address

Required Permissions

PermissionDescription
ReadAccountsViewing user account info (including name, business name, address and phone number/account number)

Usage Plan Group

Light

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
accountId string Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session [default to ~]

Return type

GetAccountInfoResponse

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]

LoadServiceInfo

GetServiceInfoResponse LoadServiceInfo(ctx, accountId) Get Account Service Info

Required Permissions

PermissionDescription
ReadAccountsViewing user account info (including name, business name, address and phone number/account number)

Usage Plan Group

Light

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
accountId string Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session [default to ~]

Return type

GetServiceInfoResponse

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]

ModifyAccount

GetAccountInfoResponse ModifyAccount(ctx, accountId, updateAccountRequest) Update Company

Since 1.0.0

Updates account information.

Required Permissions

PermissionDescription
EditAccountsViewing and updating user account info (including name, business name, address and phone number/account number)

Usage Plan Group

Medium

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
accountId string
updateAccountRequest UpdateAccountRequest JSON body

Return type

GetAccountInfoResponse

Authorization

OAuth2

HTTP request headers

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

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

UpdateAccountBusinessAddress

AccountBusinessAddressResource UpdateAccountBusinessAddress(ctx, accountId, modifyAccountBusinessAddressRequest) Update Company Business Address

Required Permissions

PermissionDescription
EditAccountsViewing and updating user account info (including name, business name, address and phone number/account number)
ReadAccountsViewing user account info (including name, business name, address and phone number/account number)

Usage Plan Group

Medium

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
accountId string Internal identifier of a RingCentral account or tilde (~) to indicate the account logged-in within the current session [default to ~]
modifyAccountBusinessAddressRequest ModifyAccountBusinessAddressRequest JSON body

Return type

AccountBusinessAddressResource

Authorization

OAuth2

HTTP request headers

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

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

UpdateServiceInfo

AccountServiceInfo UpdateServiceInfo(ctx, accountId, serviceInfoRequest) Update Account Service Info [Beta]

Since 1.0.29 (Release 9.0)

Updates limitations for a particular RingCentral customer account.

Required Permissions

PermissionDescription
AccountsManaging accounts: creating new accounts, viewing and updating account information, deleting existing accounts
EditAccountsViewing and updating user account info (including name, business name, address and phone number/account number)

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 a RingCentral account or tilde (~) to indicate the account logged-in within the current session [default to ~]
serviceInfoRequest ServiceInfoRequest JSON body

Return type

AccountServiceInfo

Authorization

OAuth2

HTTP request headers

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

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