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

Update a call recording

Updates the status or pause behavior of a call recording. Set Status to pause, stop, or resume the recording, and use Twilio.CURRENT in Sid to target the active recording instead of a recording SID.

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

3 parameters · 2 body fields
AccountSidstringrequired
The account SID that owns the recording. Must be a 34-character value matching the `AC` SID format.
CallSidstringrequired
The call SID associated with the recording. Must be a 34-character value matching the `CA` SID format.
Sidstringrequired
The recording SID to update, or `Twilio.CURRENT` to reference the current active recording.

Optional URL-encoded recording status update; Status is required.

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`.

2 status codes
200Returns the updated recording object, including its current status, pause configuration, call association, timestamps, duration, and resource metadata.
account_sidstringoptional
The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Recording resource.
api_versionstringoptional
The API version used to make the recording.
call_sidstringoptional
The SID of the [Call](https://www.twilio.com/docs/voice/api/call-resource) the Recording resource is associated with.
conference_sidstringoptional
The Conference SID that identifies the conference associated with the recording, if a conference 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 Recording resource.
pricenumberoptional
The one-time cost of creating the recording in the `price_unit` currency.
uristringoptional
The URI of the resource, relative to `https://api.twilio.com`.
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.
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`, and `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`.
trackstringoptional
The recorded track. Can be: `inbound`, `outbound`, or `both`.
408Returned when the request times out. The response contains a Twilio-specific error code, message, status, and error-reference link.
codeintegeroptional
Twilio-specific error code
messagestringoptional
Error message
more_infostringoptional
Link to Error Code References
statusintegeroptional
HTTP response status code

Error handling

Status is required and must use one of the declared recording status values; PauseBehavior accepts skip or silence and defaults to silence when omitted. A 408 is returned when the request times out, so retry only after confirming the recording state.