Skip to main content

Request recording for a call

POST 
/texml/Accounts/:account_sid/Calls/:call_sid/Recordings.json

Starts recording with specified parameters for call idientified by call_sid.

Request​

Path Parameters

    account_sid stringrequired

    The id of the account the resource belongs to.

    call_sid stringrequired

    The CallSid that identifies the call to update.

Body

Starts call recording on a call.

    PlayBeep PlayBeep (boolean)

    Default value: true

    Whether to play a beep when recording is started.

    RecordingStatusCallbackEvent RecordingStatusCallbackEvent (string)

    The changes to the recording's state that should generate a call to RecoridngStatusCallback. Can be: in-progress, completed and absent. Separate multiple values with a space. Defaults to completed.

    RecordingStatusCallback uri

    Url where status callbacks will be sent.

    RecordingStatusCallbackMethod TexmlStatusCallbackMethod (string)

    Possible values: [GET, POST]

    Default value: POST

    HTTP method used to send status callbacks.

    RecordingChannels TexmlRecordingChannels (string)

    Possible values: [mono, dual]

    Default value: dual

    When dual, final audio file has the first leg on channel A, and the rest on channel B. mono mixes both tracks into a single channel.

    RecordingTrack RecordingTrack (string)

    Possible values: [inbound, outbound, both]

    The audio track to record for the call. The default is both.

Responses​

200: Successful call recording create response

Schema

    account_sid AccountSid (string)
    call_sid CallControlId (string)
    conference_sid uuidnullable
    channels TwimlRecordingChannels (integer)

    Possible values: [1, 2]

    Default value: 2

    date_created datetime-rfc2822
    date_updated datetime-rfc2822
    start_time datetime-rfc2822
    price TexmlRecordingPrice (string)nullable

    The price of this recording, the currency is specified in the price_unit field.

    price_unit TexmlPriceUnit (string)nullable

    The unit in which the price is given.

    duration TexmlRecordingDuration (string)nullable

    The duration of this recording, given in seconds.

    sid TexmlSid (string)

    Identifier of a resource.

    source RecordingSource (string)

    Possible values: [StartCallRecordingAPI, StartConferenceRecordingAPI, OutboundAPI, DialVerb, Conference, RecordVerb, Trunking]

    Defines how the recording was created.

    error_code TexmlErrorCode (string)nullable
    track RecordingTrack (string)

    Possible values: [inbound, outbound, both]

    The audio track to record for the call. The default is both.

    uri string

    The relative URI for this recording resource.

404: Resource not found

Schema

    data

    object

    errors

    object[]

  • Array [

    • detail string

  • ]

Loading...