Sample - Twilio API
POST/2010-04-01/Accounts/{AccountSid}/Conferences/{ConferenceSid}/Recordings/{Sid}.json

Update a conference recording

Updates the status or pause behavior of a conference recording. Provide Status to control whether the recording is in progress, paused, stopped, processing, completed, or absent. Use Twilio.CURRENT as Sid to target the current active recording.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

3 parameters · 2 body fields
AccountSidstringrequired
The account SID that owns the conference recording. Must be 34 characters and match the `AC` SID format.
ConferenceSidstringrequired
The conference SID associated with the recording. Must be 34 characters and match the `CF` SID format.
Sidstringrequired
The recording SID to update, or `Twilio.CURRENT` to reference the current active recording.

Conference recording update fields. Status must be supplied.

Statusstringrequired
The status of the recording. Can be: `processing`, `completed` and `absent`. For more detailed statuses on in-progress recordings, check out how to [Update a Recording Resource](https://www.twilio.com/docs/voice/api/recording#update-a-recording-resource).
Allowed:in-progresspausedstoppedprocessingcompletedabsent
PauseBehaviorstringoptional
Whether to record during a pause. Can be: `skip` or `silence` and the default is `silence`. `skip` does not record during the pause period, while `silence` will replace the actual audio of the call with silence during the pause period. This parameter only applies when setting `status` is set to `paused`.

1 status code
200Returns the updated conference recording object, including its status, pause-related state, timestamps, duration, source, and other recording metadata.
account_sidstringoptional
The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Conference Recording resource.
api_versionstringoptional
The API version used to create the recording.
call_sidstringoptional
The SID of the [Call](https://www.twilio.com/docs/voice/api/call-resource) the Conference Recording resource is associated with.
conference_sidstringoptional
The Conference SID that identifies the conference associated with the recording.
date_createdstringoptional
The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
date_updatedstringoptional
The date and time in GMT that the resource was last updated, specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
start_timestringoptional
The start time of the recording in GMT and in [RFC 2822](https://www.php.net/manual/en/class.datetime.php#datetime.constants.rfc2822) format.
durationstringoptional
The length of the recording in seconds.
sidstringoptional
The unique string that that we created to identify the Conference Recording resource.
pricestringoptional
The one-time cost of creating the recording in the `price_unit` currency.
price_unitstringoptional
The currency used in the `price` property. Example: `USD`.
statusstringoptional
The status of the recording. Can be: `processing`, `completed` and `absent`. For more detailed statuses on in-progress recordings, check out how to [Update a Recording Resource](https://www.twilio.com/docs/voice/api/recording#update-a-recording-resource).
Allowed:in-progresspausedstoppedprocessingcompletedabsent
channelsintegeroptional
The number of channels in the final recording file. Can be: `1`, or `2`. Separating a two leg call into two separate channels of the recording file is supported in [Dial](https://www.twilio.com/docs/voice/twiml/dial#attributes-record) and [Outbound Rest API](https://www.twilio.com/docs/voice/make-calls) record options.
Default:0
sourcestringoptional
How the recording was created. Can be: `DialVerb`, `Conference`, `OutboundAPI`, `Trunking`, `RecordVerb`, `StartCallRecordingAPI`, `StartConferenceRecordingAPI`.
Allowed:DialVerbConferenceOutboundAPITrunkingRecordVerbStartCallRecordingAPIStartConferenceRecordingAPI
error_codeintegeroptional
The error code that describes why the recording is `absent`. The error code is described in our [Error Dictionary](https://www.twilio.com/docs/api/errors). This value is null if the recording `status` is not `absent`.
encryption_detailsunknownoptional
How to decrypt the recording if it was encrypted using [Call Recording Encryption](https://www.twilio.com/docs/voice/tutorials/voice-recording-encryption) feature.
uristringoptional
The URI of the resource, relative to `https://api.twilio.com`.

Error handling

Status is required and must be one of in-progress, paused, stopped, processing, completed, or absent. PauseBehavior must be skip or silence when provided, and Sid can be Twilio.CURRENT to reference the active recording.