Call

/v0.1/RecordStart/

Initiates recording of a given call

post/v0.1/RecordStart/

Request

Request body application/x-www-form-urlencoded

CallUUIDstring

Unique identifier of the call to be recorded

FileFormat'wav' | 'mp3'

File format (extension)

FilePathstring

Directory path/URI where the recording file will be saved

FileNamestring

Recording file name (without extension); if empty, a timestamp based file name will be generated

TimeLimitinteger

Maximum recording length, in seconds

Example request

{
  "CallUUID": "052d04e4-019a-45ff-a562-f74d4ae99ea2",
  "FileFormat": "wav",
  "FilePath": "/tmp/recordings",
  "FileName": "sample_recording",
  "TimeLimit": 89
}

Response

Response

Message'RecordStart Executed' | 'CallUUID Parameter must be present' | 'FileFormat Parameter must be' | 'RecordStart Failed: invalid TimeLimit' | 'RecordStart Failed -- Call not found' | 'RecordStart Failed' required

Response message

RecordFilestring required

Directory path/URI where the recording file will be saved

Successboolean required

Whether the request was successful or not

Example response

{
  "Message": "RecordStart Executed",
  "RecordFile": "/tmp/recordings/sample.wav",
  "Success": true
}

Changes

No recorded changes to this operation across all 1 revision of this API.