Sign in

v50

latestOpenAPI 3.0.1Apache 2.0raw.githubusercontent.com2026-05-061971481.8 MB
Api20100401CallRecording

Create a recording for the call

Create a recording for the call

post/2010-04-01/Accounts/{AccountSid}/Calls/{CallSid}/Recordings.json

Path parameters

AccountSidstring required

The SID of the Account that will create the resource.

CallSidstring required

The SID of the Call to associate the resource with.

Response

OK

account_sidstring nullable

The SID of the Account that created the Recording resource.

api_versionstring nullable

The API version used to make the recording.

call_sidstring nullable

The SID of the Call the Recording resource is associated with.

conference_sidstring nullable

The Conference SID that identifies the conference associated with the recording, if a conference recording.

date_createdstring date-time-rfc-2822 nullable

The date and time in GMT that the resource was created specified in RFC 2822 format.

date_updatedstring date-time-rfc-2822 nullable

The date and time in GMT that the resource was last updated, specified in RFC 2822 format.

start_timestring date-time-rfc-2822 nullable

The start time of the recording in GMT and in RFC 2822 format.

durationstring nullable

The length of the recording in seconds.

sidstring nullable

The unique string that that we created to identify the Recording resource.

pricenumber nullable

The one-time cost of creating the recording in the price_unit currency.

uristring nullable

The URI of the resource, relative to https://api.twilio.com.

{"stackTrail":"components:schemas:api.v2010.account.call.call_recording:properties:encryption_details","oasType":"schema","type":"unknown","description":"How to decrypt the recording if it was encrypted using [Call Recording Encryption](https://www.twilio.com/docs/voice/tutorials/voice-recording-encryption) feature.","nullable":true}
price_unitstring currency nullable

The currency used in the price property. Example: USD.

status'in-progress' | 'paused' | 'stopped' | 'processing' | 'completed' | 'absent'

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.

channelsinteger

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 and Outbound Rest API record options.

source'DialVerb' | 'Conference' | 'OutboundAPI' | 'Trunking' | 'RecordVerb' | 'StartCallRecordingAPI' | 'StartConferenceRecordingAPI'

How the recording was created. Can be: DialVerb, Conference, OutboundAPI, Trunking, RecordVerb, StartCallRecordingAPI, and StartConferenceRecordingAPI.

error_codeinteger nullable

The error code that describes why the recording is absent. The error code is described in our Error Dictionary. This value is null if the recording status is not absent.

trackstring nullable

The recorded track. Can be: inbound, outbound, or both.