Upload domain speech word audio

POST

/domains/{domain}/speech-words/{filename}/upload

Last modified:2026-10-09 00:58:15

OperationId:UploadSpeechWordDomain

Replaces the recorded audio of a speech word with a file you send.

Requires Office Manager, Call Center Supervisor, Route Manager, Reseller, or Super User scope for the domain. A Reseller can change only domains in its own reseller; any other domain returns 403.

The audio is stored as the domain's override. The audio is converted to 8 kHz, 8-bit mono WAV, and the speech word is marked source-type upload. Its text is kept unless you send script.

Upload a file. Send multipart/form-data with the audio in the file part. The part's Content-Type picks the decoder: audio/mpeg or audio/mp3 for MP3, audio/ogg or audio/webm for Ogg or WebM, and WAV otherwise.

Base64 file. Send JSON with the audio as base64 in file-base64, and its format in file-encoding. Without file-encoding, MP3 is recognized by its header and anything else is read as WAV.

Audio that cannot be converted returns 400 and nothing is stored.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Body Params

application/json

Required

Examples

Responses

🟢202Accepted

application/json

The audio is replaced and plays from now on.

Bodyapplication/json

🟠400Bad Request

🟠401Authentication Required

🟠403Forbidden

🟠404Record not found

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//speech-words/hour-10/upload' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "file-base64": "UklGRiQAAABXQVZFZm10IBAAAAABAAEAQB8AAEAfAAABAAgAZGF0YQAAAAA=",
    "file-encoding": "audio/wav"
}'

Response Example

202 - Accepted

{
    "code": 202,
    "message": "Accepted"
}

Modified at 2026-10-09 00:58:15

Render domain speech word with text to speech

Play system speech word from signed link