Skip to main content

Create a Recording.

Create a recording.

Permissions

The API token must include the following scopes: Voice.

Path Parameters
AccountSid uuid REQUIRED

The unique identifier for the account that is associated with this recording.

CallSid uuid REQUIRED

The unique identifier for the call that is associated with this recording.

Request Body REQUIRED
RecordingChannels string

Possible values: [mono, dual]

The number of channels in the recording. Can be mono (both legs of call recorded under one channel into one recording file) or dual (each leg of call recorded in separate channels into one recording file).

RecordingStatusCallback string

The URL to request to when recording is available.

RecordingStatusCallbackEvent string

Possible values: [completed, in-progress, absent]

The different recording statuses. Possible values are completed, in-progress, and absent. To specify multiple events, separate with a space. Defaults to completed.

RecordingStatusCallbackMethod string

Possible values: [GET, POST]

Whether the request to RecordingStatusCallback URL is a GET or a POST. Default is POST.

RecordingTrack string

Possible values: [inbound, outbound, both]

Specifies whether to record the inbound audio to SignalWire from the called party or the outbound audio from SignalWire to the called party or both the inbound and outbound audio. Defaults to both.

Trim string

Possible values: [trim-silence, do-not-trim]

Whether leading and trailing silence is trimmed from a recording. Possible values are trim-silence and do-not-trim. Default is trim-silence.

Responses
200

OK

Schema OPTIONAL
account_sid uuid OPTIONAL

The unique identifier for the account that is associated with this recording.

api_version string OPTIONAL

The version of the SignalWire API.

call_sid string OPTIONAL

The unique identifier for the call that is associated with this recording.

conference_sid string OPTIONAL

The unique identifier for the conference that is associated with this recording.

channels integer OPTIONAL

Possible values: [1, 2]

The number of channels in a recording. Possible values are 1 or 2.

date_created string OPTIONAL

The date, in RFC 2822 format, this recording was created.

date_updated string OPTIONAL

The date, in RFC 2822 format, this recording was updated.

end_time string OPTIONAL

The time, in RFC 2822 format, this recording endded.

price string OPTIONAL

The cost for the recording.

price_unit string OPTIONAL

The currency of the price of the recording.

duration string OPTIONAL

The length, in seconds, of the recording.

sid string OPTIONAL

The unique identifier for the recording.

source string OPTIONAL

Possible values: [DialVerb, Conference, OutBoundApi, Trunking, RecordVerb, StartCallRecordingApi, StartConferenceRecording]

How the recording was made.

status string OPTIONAL

Possible values: [paused, in-progress, stopped]

The status of the recording.

error_code string OPTIONAL

Further details about a failed recording.

uri string OPTIONAL

The URI of the recording.

subresource_uris object OPTIONAL

Subresource URIs

transcriptions string OPTIONAL