Skip to main content

Create a Recording.

POST 
/Accounts/:AccountSid/Calls/:CallSid/Recordings

Create a recording.

Permissions​

The API token must include the following scopes: Voice.

Request​

Path Parameters

    AccountSid uuidrequired

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

    CallSid uuidrequired

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

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​

OK

Schema

    account_sid uuid

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

    api_version string

    The version of the SignalWire API.

    call_sid string

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

    conference_sid string

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

    channels integer

    Possible values: [1, 2]

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

    date_created string

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

    date_updated string

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

    end_time string

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

    price string

    The cost for the recording.

    price_unit string

    The currency of the price of the recording.

    duration string

    The length, in seconds, of the recording.

    sid string

    The unique identifier for the recording.

    source string

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

    How the recording was made.

    status string

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

    The status of the recording.

    error_code string

    Further details about a failed recording.

    uri string

    The URI of the recording.

    subresource_uris

    object

    Subresource URIs

    transcriptions string
Loading...