Save BYOK provider configuration
Store the non-secret configuration for a provider you have brought your own key for, such as the selected model or region. The API key itself is not set here — use POST /byok for that, which stores it in Vault.
Authorization
BearerAuth API key authentication. Get your key from the dashboard.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X POST "https://example.com/byok/config" \ -H "Content-Type: application/json" \ -d '{ "provider": "deepgram", "config": {} }'{
"byok_config": {}
}Delete BYOK configuration DELETE
Remove a Bring Your Own Key configuration. This will delete the secret from Vault and remove the reference from the database.
List available voices GET
Returns available voices for your agents. ## Voice Providers ### Local Voices (All Users) Local voices are lightweight, fast, and cost-effective. They provide clear, slightly robotic speech that works well for transactional calls like appointments, surveys, and customer service. This endpoint returns all available local voices grouped by language. Over 90 voices across 35+ languages are available. ### ElevenLabs (BYOK) This endpoint does NOT return ElevenLabs voices. Check your ElevenLabs Voice Library at https://elevenlabs.io/app/voice-library for available voices when using your own API key. **Available ElevenLabs models:** `eleven_flash_v2_5` (fastest, default), `eleven_v3` (expressive dialogue with audio tags - supports `[emotion]` cues in square brackets), `eleven_multilingual_v2` (best quality), `eleven_turbo_v2_5` (balanced), `eleven_monolingual_v1` (English only). ### xAI Grok Realtime (BYOK) Grok Realtime has built-in voices (not returned by this endpoint). Set voice via `llm_config.voice` when creating/updating an agent. Available xAI voices: `ara`, `rex`, `sal`, `eve`, `leo` ## Choosing the Right Voice | Use Case | Recommended | |----------|-------------| | Appointments, surveys, support | Local voices (fast, clear) | | Sales, relationship-building | ElevenLabs (natural, expressive) | | Real-time conversations | xAI Grok Realtime (low latency) | **Example agent with local voice:** ```json { "name": "Appointment Agent", "tts_config": { "provider": "local", "voice_id": "nl_NL-pim-medium", "language": "nl" } } ```