Set fallback voice
Set the agent's FALLBACK voice, the secondary voice the runtime switches to when the primary TTS provider fails mid-call (the TTS analogue of the per-call LLM voice failover). Pass voiceId plus voiceProvider, both from the same list_voices row; pick a provider DIFFERENT from the primary voice's so a single provider outage doesn't take both down. Pass voiceId: null to clear the explicit choice; the agent then inherits the platform-default pairing, a voice from the other main provider (sovereign workspaces and some primaries inherit none). Agent-scoped (applies across versions), stored on agents.settings.fallbackVoice. Use when the user says 'add a backup voice', 'set a fallback voice in case the voice provider goes down', or 'use the default fallback voice'.
Authorization
bearerAuth A personal access token from Settings > API tokens.
In: header
Header Parameters
A key you choose, such as a UUID, that makes this POST safe to retry. Within 24 hours the same key and request answers with the first successful answer and runs nothing, the same key with a different request answers 422 idempotency_key_reused, and a key whose request is still running answers 409 idempotency_key_in_use. A failed request keeps nothing, so the same key runs it again.
1 <= length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/operations/set_fallback_voice" \ -H "Content-Type: application/json" \ -d '{ "voiceId": "string", "agent": "string" }'{}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}Set fallback model POST
Set the FALLBACK LLM model the live agent runs on calls and chats when its primary model (set_model) becomes unavailable, a disabled or decommissioned key. It is versioned exactly like the primary model: the write lands on the current draft version (create a draft first if the current version is published). Pass null to clear the fallback so the runtime uses the platform's default model as the backstop. Pick a model different from the primary: the same model cannot stand in for itself, and validate_agent flags it as a risk. Take the key from the model picker, which lists every model with its tier (Fast, Balanced, Power, Speed) and marks the default; get_agent shows the key the agent runs on now. When the user names a model loosely, map it to the matching picker key.
Set greeting POST
Pin a fixed first utterance the agent speaks the moment a caller joins. The voice runtime sends this straight to TTS, no LLM round-trip, so the open of the call is instant and identical every time. Use this when the operator wants a deterministic opener like 'Hi, you've reached Mitchell's Plumbing, how can I help?'. Keep it under one sentence; longer greetings drag the call. Pass null to clear and fall back to LLM-generated greetings.