Recordings

Recordings are created when you use the verb. Recordings are hosted with teleapi for you to retrieve. The Recordings list resource represents the set of an account’s recordings.

Recording Resource URI

/2012-04-24/Accounts/{AccountSid}/Recordings/{RecordingSid}

The audio file is named using the RecordingSid and a file extension of .wav.

The URLs that contain the actual audio recordings are accessible by everyone without the need to authenticate with teleapi. This is per design to allow for your apps to easily access the recordings without revealing your credentials. The same is NOT true for the resource to retrieve the list of recordings. Unauthenticated users cannot access the RecordingSid and hence not able to download the actual recording..

Warning

Warning: Although Recording Sids in Recording URLs are essentially long random strings that are very difficult to guess, you still need to make sure that they don’t fall in the wrong hands.

Resource Properties

Property

Description

Sid

A string that uniquely identifies a recording.

DateCreated

The date that the recording was created.

DateUpdated

The date that the recording was last updated.

AccountSid

The unique id of the Account that created the recording.

CallSid

The unique id of the call during which the recording was made.

Duration

The length of the recording, in seconds.

ApiVersion

The API version in use during the recording.

Uri

The URI for this account, relative to https://calls.teleapi.net/call/2012-04-24/.

FileUri

The File URI for this recording, relative to https://calls.teleapi.net/call/2012-04-24/. It can be used to access the WAV file

S3Uri

The S3 URI for this recording. This exists ONLY IF Amazon S3 integration is enabled and security level is NONE.

Supported Operations

HTTP GET. Returns the representation of a Recording resource, including the properties above.

HTTP DELETE. Removes the recording from the account.

Recording List Resource URI

There is two types of tokens: Call API SID Token and API Token; both must be used.

7.5 API Tokens from teleapi Settings