Twilio API (unofficial showcase)
POST/2010-04-01/Accounts/{AccountSid}/Conferences/{ConferenceSid}/Recordings/{Sid}.json

Update a conference recording

Updates the status of a conference recording and, when pausing it, can control how the pause is recorded. Supply Status to select the recording state; use Twilio.CURRENT as Sid to target the active recording.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

3 parameters · 2 body fields
AccountSidstringrequired
The account SID, formatted as `AC` followed by 32 hexadecimal characters.
ConferenceSidstringrequired
The conference SID, formatted as `CF` followed by 32 hexadecimal characters.
Sidstringrequired
The recording identifier to update, or `Twilio.CURRENT` to reference the current active recording.

Optional form data for updating a conference recording. Status must be provided.

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 resource, including its status, start time, duration, and 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

The AccountSid path parameter must match the account SID format, the ConferenceSid path parameter must match the conference SID format, and the Sid path parameter identifies the recording or can be Twilio.CURRENT. Status is required and must be one of in-progress, paused, stopped, processing, completed, or absent; PauseBehavior, if provided, must be skip or silence.