---
title: "Update Call Recording Settings"
method: PUT
path: "/restapi/v1.0/account/{accountId}/call-recording"
tags: ["Call Recording Settings"]
---

# Update Call Recording Settings

`PUT /restapi/v1.0/account/{accountId}/call-recording`

Updates current call recording settings.

## Path parameters

- `accountId` string, required

## Request body

- CallRecordingSettingsResource
  - `onDemand` OnDemandResource
    - `enabled` boolean — Flag for controlling OnDemand Call Recording settings
    - `retentionPeriod` integer — Retention period of a call recording, the default value is 90 days
  - `automatic` AutomaticRecordingResource
    - `enabled` boolean — Flag for controlling Automatic Call Recording settings
    - `outboundCallTones` boolean — Flag for controlling 'Play Call Recording Announcement for Outbound Calls' settings
    - `outboundCallAnnouncement` boolean — Flag for controlling 'Play periodic tones for outbound calls' settings
    - `allowMute` boolean — Flag for controlling 'Allow mute in auto call recording' settings
    - `extensionCount` integer — Total amount of extension that are used in call recordings
    - `retentionPeriod` integer — Retention period of a call recording, the default value is 90 days
    - `maxNumberLimit` integer — Maximum number of automatic call recordings per account, the default value is 100 000
  - `greetings` GreetingResource[] — Collection of Greeting Info
    - `type` 'StartRecording' | 'StopRecording' | 'AutomaticRecording'
    - `mode` 'Default' | 'Custom' — Here `Default` indicates that all greetings of that type (in all languages) are default. If at least one greeting (in any language) of the specified type is custom, then `Custom` is returned.

## Response `200`

OK: Updated Call Recording Settings

- CallRecordingSettingsResource
  - `onDemand` OnDemandResource
    - `enabled` boolean — Flag for controlling OnDemand Call Recording settings
    - `retentionPeriod` integer — Retention period of a call recording, the default value is 90 days
  - `automatic` AutomaticRecordingResource
    - `enabled` boolean — Flag for controlling Automatic Call Recording settings
    - `outboundCallTones` boolean — Flag for controlling 'Play Call Recording Announcement for Outbound Calls' settings
    - `outboundCallAnnouncement` boolean — Flag for controlling 'Play periodic tones for outbound calls' settings
    - `allowMute` boolean — Flag for controlling 'Allow mute in auto call recording' settings
    - `extensionCount` integer — Total amount of extension that are used in call recordings
    - `retentionPeriod` integer — Retention period of a call recording, the default value is 90 days
    - `maxNumberLimit` integer — Maximum number of automatic call recordings per account, the default value is 100 000
  - `greetings` GreetingResource[] — Collection of Greeting Info
    - `type` 'StartRecording' | 'StopRecording' | 'AutomaticRecording'
    - `mode` 'Default' | 'Custom' — Here `Default` indicates that all greetings of that type (in all languages) are default. If at least one greeting (in any language) of the specified type is custom, then `Custom` is returned.

## Other responses

- `400` — General response with **HTTP 400 "Bad request"** status.<br> Reasons: unparsable request, path, query or body parameters are invalid. The error description may contain reference to particular parameter(s) which haven't passed the validation.
- `404` — General response with **HTTP 404 "Not found"** status.<br> Reasons: the entity with given ID (typically specified in a path parameter), is not found or inaccessible
- `500` — General response with **HTTP 500 "Internal Server Error"** status.<br> Reasons: general server-side error.
- `503` — General response with **HTTP 503 "Service not available"** status.<br> Reasons: server cannot process the request because of being overloaded, misconfiguration or other issues.

---

[API](https://skmtc.dev/ringcentral/apis/ringcentral-api.md) · [All operations](https://skmtc.dev/ringcentral/apis/ringcentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ringcentral/ringcentral-api/revisions/8d602198ec97/schema)