Generate a voice preview

Served by the standalone Voice API. Requires a Bearer session for a workspace owner/admin/manager when VOICE_AI_TELEPHONY_TURN_CONTROL_V2 is enabled. Legacy flag-off access is preserved. Existing route-specific validation still applies.

POST

https://api.channelautomation.com/api/workspaces/{workspaceId}/voice-ai/preview/tts

Authorization

BearerAuth
HTTP Bearer (JWT)
required

Path parameters

workspaceId
string
required

Request body JSON

text
optional
string
Text to speak; required.
voice
optional
string
Supported voice identifier.

Returns

200

Audio preview

400

Invalid call or preview parameters

401

Missing or invalid session

403

Workspace owner/admin/manager required

404

Requested resource not found

409

Call is not in a state permitting this operation

500

Operation failed

503

Access verification or service unavailable

Generate a voice preview

curl --request POST \
  --url 'https://api.channelautomation.com/api/workspaces/<workspaceId>/voice-ai/preview/tts' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "text": "string",
  "voice": "string"
}
'

const url = 'https://api.channelautomation.com/api/workspaces/<workspaceId>/voice-ai/preview/tts';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json', Authorization: 'Bearer <token>'},
  body: JSON.stringify({text: 'string', voice: 'string'})
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "https://api.channelautomation.com/api/workspaces/<workspaceId>/voice-ai/preview/tts"

payload = {
    "text": "string",
    "voice": "string"
}
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer <token>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

Response example

string