Upload system speech word audio

POST

/speech-words/{filename}/upload

Last modified:2026-10-03 14:35:16

OperationId:UploadSpeechWord

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

Requires Super User scope. A Reseller changes speech words only as overrides for domains in its own reseller.

The audio replaces the system audio, which every domain without an override plays. 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

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/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-03 14:35:16

Render system speech word with text to speech

List domain speech words