Delete BYOK configuration
Remove a Bring Your Own Key configuration. This will delete the secret from Vault and remove the reference from the database.
Remove a Bring Your Own Key configuration. This will delete the secret from Vault and remove the reference from the database.
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
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/byok" \ -H "Content-Type: application/json" \ -d '{ "provider": "deepgram" }'{
"success": true,
"byok_keys": {}
}{
"error": "Invalid API key",
"message": "string"
}{
"error": "Invalid API key",
"message": "string"
}{
"error": "Invalid API key",
"message": "string"
}{
"error": "Invalid API key",
"message": "string"
}Add BYOK configuration POST
Add or update a Bring Your Own Key configuration. The API key is securely stored in Supabase Vault and only the vault secret ID is stored in 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" } } ```