Upload Audio File

POST

/v1/support/upload-audio

Uploads an audio file, converts it server-side to a FreeSWITCH-compatible WAV format, stores it in blob storage, and returns a public URL plus duration.

This is how you get a valid audioFileUrl to pass into POST /v1/outbound-ivr — that endpoint expects exactly this kind of pre-processed, telephony-compatible audio file. The returned url can be passed directly as AudioFileUrl (as an alternative to TtsText).

Any audio format is accepted as input — conversion happens automatically, but the maximum uploaded file size is 10 MB.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params multipart/form-dataRequired

Responses

🟢200OK

application/json

The file was uploaded and converted successfully.

Bodyapplication/json

🟠400Bad Request

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.voxa.sa/v1/support/upload-audio' \
--header 'Authorization: Bearer <token>' \
--form 'audioFile=@""'

Response Example

200 - Success Example

{
    "url": "https://.../abc123.wav",
    "durationSeconds": 4.32
}

Modified at 2026-06-21 15:16:22

Upload Image, Video, or PDF

Send Text