POST
/
upload-call

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
agentId
string
required

the ID of the agent associated with the call. this can be your internal agent ID. this is used to identify which calls came from which agent. if you haven't added an agent with this ID to fixa, it will be created automatically

callId
string
required

unique identifier for the call

stereoRecordingUrl
string
required

URL where the stereo call recording is stored. it can either be a presigned url or a public url to a file in your storage bucket. recordings must be two channel audio files with the caller on the left channel and your agent on the right channel.

language
enum<string>
default:
en

language of the call. defaults to english

Available options:
bg,
ca,
zh,
zh-CN,
zh-Hans,
zh-TW,
zh-Hant,
zh-HK,
cs,
da,
da-DK,
nl,
en,
en-US,
en-AU,
en-GB,
en-NZ,
en-IN,
et,
fi,
nl-BE,
fr,
fr-CA,
de,
de-CH,
el,
hi,
hu,
id,
it,
ja,
ko,
ko-KR,
lv,
lt,
ms,
no,
pl,
pt,
pt-BR,
pt-PT,
ro,
ru,
sk,
es,
es-419,
sv,
sv-SE,
th,
th-TH,
tr,
uk,
vi
metadata
object

optional custom metadata fields you'd like to use to analyze your call data (i.e. region, llm, tts model, etc.). these can be used to filter calls in the dashboard

saveRecording
boolean
default:
true

whether to save the recording to fixa's storage. must be true if you are sending presigned urls.

webhookUrl
string

url for fixa to post call data to when analysis is complete

Response

200 - application/json
success
boolean
required

whether the call was uploaded successfully

callId
string

the id of the call