Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

RingCentral Call Recording Settings API

The Call Recording Settings API from RingCentral — 5 operation(s) for call recording settings.

RingCentral Call Recording Settings API is one of 88 APIs that RingCentral publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Call Recording Settings. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 7 operations across 5 paths, and defines 19 schemas. It is described by OpenAPI 3.0.3, at version 1.0.58-20240529-47eda8bd.

Requests are made against 4 base URLs: https://platform.ringcentral.com, https://media.ringcentral.com, https://platform.devtest.ringcentral.com, https://platform.devtest.ringcentral.com.

7 operations 5 paths 19 schemas 2 DELETE3 GET1 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0.58-20240529-47eda8bd
Servers
https://platform.ringcentral.com
https://media.ringcentral.com
https://platform.devtest.ringcentral.com
https://platform.devtest.ringcentral.com
Authentication
OAuth 2.0
Terms of Service
Resource Areas
1

Authentication & Security 1

RingCentral Call Recording Settings API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (OAuth2) using the authorizationCode flow. By default, every request must be authenticated.

Paths & Operations 7

Across 5 paths, the API surfaces 7 operations — 2 DELETE, 3 GET, 1 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Call Recording Settings 7
GET
/restapi/v1.0/account/{accountId}/call-recording
Get Call Recording Settings
readCallRecordingSettings 1 param → 200404500503
PUT
/restapi/v1.0/account/{accountId}/call-recording
Update Call Recording Settings
updateCallRecordingSettings 1 param body → 200400404500503
GET
/restapi/v1.0/account/{accountId}/call-recording/custom-greetings
Get Call Recording Custom Greeting List
listCallRecordingCustomGreetings 2 params → 200400404500503
DELETE
/restapi/v1.0/account/{accountId}/call-recording/custom-greetings
Delete Call Recording Custom Greeting List
deleteCallRecordingCustomGreetingList 1 param → 204404500503
DELETE
/restapi/v1.0/account/{accountId}/call-recording/custom-greetings/{greetingId}
Delete Call Recording Custom Greeting
deleteCallRecordingCustomGreeting 2 params → 200404500503
POST
/restapi/v1.0/account/{accountId}/call-recording/bulk-assign
Update Call Recording Extension List
updateCallRecordingExtensionList 1 param body → 204400404500503
GET
/restapi/v1.0/account/{accountId}/call-recording/extensions
Get Call Recording Extension List
listCallRecordingExtensions 1 param → 200404500503

Schemas 19

The contract defines 19 schemas that model the data the API accepts and returns. The most detailed are AutomaticRecordingResource (7 properties), EnumeratedPagingModel (6 properties), CallRecordingExtensionResource (5 properties), PageNavigationModel (4 properties). Each schema is shown below with its type and property counts.

GreetingResource
object
2 properties
ApiErrorWithParameter
The error model with additional attributes which can be used for HTTP 400/409 This is a deprecated model: "ApiError" model can be used instead with arbitrary a…
CallRecordingExtensions
object
4 properties
ApiError
object
Generalized API error structure suitable for any error type
2 properties 2 required
AutomaticRecordingResource
object
7 properties
OnDemandResource
object
2 properties
EnumeratedPagingModel
object
6 properties 1 required
ApiErrorResponseModel
object
Standard error response model which is returned in case of any unsuccessful operation
1 property 1 required
PageNavigationUri
object
1 property
BulkAccountCallRecordingsResource
object
3 properties
CallRecordingCustomGreetings
object
Returns data on call recording custom greetings.
1 property
PageNavigationModel
object
Links to other pages of the current result set
4 properties
CallRecordingCustomGreetingData
object
Custom greeting data
2 properties
CallRecordingSettingsResource
object
3 properties
ParameterizedErrorResponseModel
object
Standard error response which may include parameterized errors
1 property 1 required
CallRecordingCustomGreetingLanguage
object
Custom greeting language
4 properties
CallRecordingExtensionResource
object
5 properties
CallRecordingCustomGreeting
object
3 properties
CallRecordingExtensionInfo
object
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

ringcentral-call-recording-settings-api-openapi.yml Raw ↑

Other APIs RingCentral publishes across the network.

RingCentral SMS API
RingCentral Team Messaging API
RingCentral Video API
RingCentral Fax API
RingCentral Data API
RingCentral Audio and Video AI API
RingCentral Call Log API
RingCentral Call Analytics API
RingCentral Presence API
RingCentral Voicemail API
RingCentral Provisioning API
RingCentral Webhooks and Subscriptions API