Create or update domain speech word

PUT

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

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

OperationId:UpdateSpeechWordDomain

Sets a domain's override of a speech word: its text, voice, and silence padding. The first call creates the override.

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.

Fields you leave out keep their stored value. A new speech word takes them from the system speech word of the same name, so script is required only when there is none. Changing the text or voice does not record new audio: call the matching /render endpoint afterward, or upload audio. Until the override is recorded, the domain keeps playing the system audio. Remove the override with DELETE on the same path.

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/jsonRequired

Examples

Responses

🟢200OK

application/json

The stored override.

Bodyapplication/json

🟠400Bad Request

🟠401Authentication Required

🟠403Forbidden

🟠404Record not found

Request Example

Shell

JavaScript

Java

Swift

cURL

New overrideChange the silence

curl --location --request PUT 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//speech-words/hour-10' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "script": "ten o clock",
    "voice-id": "en-US-Wavenet-F",
    "voice-language": "en-US"
}'

Response Example

200 - New override

{
    "filename": "hour-10",
    "domain": "example.com",
    "language": "en_us",
    "script": "ten o clock",
    "voice-engine": "WaveNet",
    "voice-id": "en-US-Wavenet-F",
    "voice-language": "en-US",
    "source-type": "default",
    "content-hash": null,
    "pre-silence-ms": 300,
    "post-silence-ms": 200,
    "created-datetime": "2026-10-01T14:30:00+00:00",
    "updated-datetime": "2026-10-01T14:30:00+00:00"
}

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

Read domain speech word

Delete domain speech word override