@font-face { font-family: "Lato"; font-weight: 700; font-style: normal; src: url("/static/fonts/lato/lato-bol-webfont-g.eot"); src: url("/static/fonts/lato/lato-bol-webfont-g.eot?#iefix") format("embedded-opentype"), url("/static/fonts/lato/lato-bol-webfont-g.woff") format("woff"), url("/static/fonts/lato/lato-bol-webfont-g.ttf") format("truetype"), url("/static/fonts/lato/lato-bol-webfont.svg#latobold") format("svg"); } * { padding: 0; margin: 0; border: none; background: none; box-shadow: none; outline: none; } body { height: 100%; font-size: 12px; font-family: "Lato", Helvetica, Arial, sans-serif; color: #585858; background-color: #fff; } .noscript { display: block !important; background-color: yellow; position: fixed; z-index: 9999; text-align: center; top: 0; width: 100%; height: 60px; font-size: 18px; color: #ff8800; line-height: 60px; border-bottom: 1px solid #ebebeb; } .v-middle { vertical-align: middle; } .noscript img { margin-right: 18px; } .noscript span { font-weight: bold; font-size: 20px; }

RingCentral for Developers requires JavaScript to be enabled.

Getting Started

Social Messaging

Artificial Intelligence

Accounts and Users

Notifications and events

Downloads and SDKs

RingCentral Labs

API Changelog for December 2019 (v.1.0.41)

Last updated: 2021-07-09

Contributors

Account

Phone Numbers

Status Filter

new status query parameter is supported.

Changed Methods
`GET /account/{accountId}/phone-number`
`GET /account/{accountId}/extension/{extensionId}/phone-number`

User Settings

Call Queue Manager Grants

new extensionType query parameter supported;
new callQueueSetup, callQueueMembersSetup, extension.name response attributes added.

Changed Methods
`GET /account/{accountId}/extension/{extensionId}/grant`

Authentication

HS256 Signed Tokens Restriction

new error code OAU-347 introduced: "An algorithm which is used for assertion signing is not supported for JWT Bearer grant type".

Changed Methods
`POST /restapi/oauth/token`

⚠️ Tokens

new error code:OAU-163 introduced: "Login of this call queue is not allowed as queue managers are selected from the user list."

Changed Methods
`POST /restapi/oauth/token`

Call Management

Call Routing

IVR Prompt Size

max IVR prompt size increased to 20Mb.

Changed Methods
🔐 `POST /account/{accountId}/ivr-prompts`

Rule Management

⚠️ Shared Line Group Call Handling Rules

new SharedLines value supported for callHandlingAction attribute.

Changed Methods
`GET /account/{accountId}/extension/{extensionId}/answering-rule`
`POST /account/{accountId}/extension/{extensionId}/answering-rule`
`GET /account/{accountId}/extension/{extensionId}/answering-rule/{ruleId}`
`PUT /account/{accountId}/extension/{extensionId}/answering-rule/{ruleId}`

Shared Line Group Hold Music

HoldMusic value supported for greeting type attribute;
HoldMusic value supported for greetings[].type attribute.

Changed Methods
`POST /account/{accountId}/extension/{extensionId}/greeting`
`GET /account/{accountId}/extension/{extensionId}/answering-rule/{ruleId}`

Events & Notifications

Extension Change Event

⚠️ New Hints

new values AccountSettings, AccountStatus, CompanyNumbers, Features, Limits, Permissions supported for hints attibute in notification payload;
values AccountInfo, PhoneNumber, Role suppressed.

Changed Notification Payloads
`/restapi/v1.0/account/{accountId}/extension/{extensionId}`

Messaging

Fax

Fax Size Limit Increased

Max attachment size limit (each/total) increased to 50Mb.

Changed Methods
`POST /account/{accountId}/extension/{extensionId}/fax`

Message Exports

⚠️ Phone Number Masking

from.phoneNumber and to.phoneNumber attribute values may be returned with last four digits masked in certain conditions, e.g. +3351234XXXX.

Changed Methods
`GET /account/{accountId}/message-store-report/{taskId}/archive/{archiveId}`

Provisioning

Devices

Country/State ID in Request

countryId and stateId request attributes supported.

Changed Methods
🔐 `PUT /account/{accountId}/device/{deviceId}`]

Emergency Address for Shared Line Group Devices

address updating supported for SLG devices.

Changed Methods
🔐 `PUT /account/{accountId}/device/{deviceId}`]

Voice

Call Control

⚠️ Call Out Origin

new value CallOut supported for origin.type attribute.

Changed Methods
`POST /account/{accountId}/telephony/call-out`
`GET /account/{accountId}/telephony/sessions/{sessionId}`

Call Log

⚠️ Phone Number Masking

phoneNumber attribute value may be returned with last four digits masked in certain conditions, e.g. +3351234XXXX.

Changed Methods
`GET /account/{accountId}/call-log`
`GET /account/{accountId}/call-log/{callRecordId}`
`GET /account/{accountId}/call-log-sync`
`GET /account/{accountId}/extension/{extensionId}/call-log`
`GET /account/{accountId}/extension/{extensionId}/call-log/{callRecordId}`
`GET /account/{accountId}/extension/{extensionId}/call-log-sync`
`GET /account/accountId/active-calls`
`GET /account/{accountId}/extension/{extensionId}/active-calls`

🔧 Sync Recording Filter Fix

issue with incorrect behavior of withRecording filter (returning calls without recording in some cases) fixed.

Changed Methods
`GET /account/{accountId}/extension/{extensionId}/call-log-sync`

Telephony Session ID

telephonySessionId attribute added.

Changed Methods
`GET /account/{accountId}/call-log`
`GET /account/{accountId}/call-log/{callRecordId}`
`GET /account/{accountId}/call-log-sync`
`GET /account/{accountId}/extension/{extensionId}/call-log`
`GET /account/{accountId}/extension/{extensionId}/call-log/{callRecordId}`
`GET /account/{accountId}/extension/{extensionId}/call-log-sync`
`GET /account/accountId/active-calls`
`GET /account/{accountId}/extension/{extensionId}/active-calls`

Contents

Rate this page: