POST
/
v1
/
speech-analytics
Upload a file
curl --request POST \
  --url https://api.wavix.com/v1/speech-analytics \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file='@example-file' \
  --form callback_url=https://you-site.com/webhook \
  --form insights=true
{
  "file": "file.mp3",
  "request_id": "e865ea07-25af-4fdd-876e-04b0d41d5ebd",
  "success": true
}

Authorizations

​
Authorization
string
header
required

Wavix API key. Pass as Authorization: Bearer <api_key>. Keys support per-resource scopes (none / read / write). See Restricted keys and scopes.

Body

multipart/form-data
​
file
file
required

Audio file to transcribe. Maximum size is 25 MB. Supported formats are WAV, MP3, and MP4 stereo.

​
callback_url
string
required

URL that receives the POST callback when transcription completes.

Example:

"https://you-site.com/webhook"

​
insights
boolean

When true, generates conversation insights alongside the transcript.

Example:

true

Response

Returns the transcription request_id for the uploaded file.

​
file
string
required

Uploaded file name.

Example:

"file.mp3"

​
request_id
string
required

Transcription request ID.

Example:

"e865ea07-25af-4fdd-876e-04b0d41d5ebd"

​
success
boolean
required

Indicates whether the request was successful.

Example:

true