Eleven Labs Release Notes

Agents Platform

• Real-time conversation monitoring: Enterprise users can now monitor agent conversations in real-time via WebSocket connection at /v1/convai/conversations/{id}/monitor. Features include cached conversation history, selective event streaming, and control commands (end call, barge-in, human takeover toggle, send messages).
• Hinglish language support: Added hinglish_mode configuration option for agents. When enabled and the agent’s language is Hindi, responses will be in Hinglish (Hindi-English mix).
• Dynamic variables in voicemail messages: Voicemail detection messages now support dynamic variable substitution, enabling personalized messages when voicemail is detected.
• Localized widget terms and conditions: Chat widget terms and conditions can now be localized per language, configured through language presets.
• Widget conversation mode toggle: Added conversation_mode_toggle_enabled option to widget configuration for controlling conversation mode switching.
• Batch call retry tracking: Added retry_count field to batch call status responses for tracking retry attempts.

Text to Speech

• Quality preset credit costs: Quality preset descriptions now include credit cost information: high (+20%), ultra (+50%), and ultra_lossless (+100%).

WhatsApp Integration

• Simplified phone number configuration: Replaced whatsapp_business_account_id with whatsapp_phone_number_id in batch calling and conversation info schemas for simpler WhatsApp integration.

SDK Releases

Python SDK

• v2.27.0 - Fixed Scribe audio format parameter handling and updated API schema
• v2.26.1 - Extended on-premises agent configuration support

JavaScript SDK

• v2.28.0 - Fixed Scribe audio format parameter handling and updated API schema

Packages

• @elevenlabs/[email protected] - Localized chat terms and conditions and fixed Scribe audio format
• @elevenlabs/[email protected] - Localized chat terms and conditions and fixed Scribe audio format
• @elevenlabs/[email protected] - Added TTS speed parameter override and fixed startSession infinite loop in useEffect hooks
• @elevenlabs/[email protected] - Fixed WebSocket closure code, fixed useConversation race condition, added shadow host event dispatching, and expanded language support
• @elevenlabs/[email protected] - Fixed WebSocket closure code, fixed useConversation race condition, added shadow host event dispatching, and expanded language support

Android SDK

• v0.7.1 - Fixed agent_tool_request event handling and corrected expects_response default value

API

• View API changes

Original source Report a problem

Agents Platform

• Twilio call registration: Added new endpoint to register Twilio calls and receive TwiML response for agent conversations.

Music Generation

• Word timestamps: Added word-level timestamps to music generation with detailed responses. Enable with the with_timestamps parameter.
• Fine-tuning support: Added finetune_id parameter to music generation endpoints for using custom music fine-tunes.
• C2PA content signing: Added sign_with_c2pa option to music generation requests for content authenticity and provenance.

Voices

• Voice settings expansion: Added voice_stability, voice_similarity, and voice_style parameters to voice endpoints for more granular control.
• Pagination improvements: Clarified pagination behavior for Get all voices v2 endpoint with better documentation of next_page_token, has_more, and total_count fields.

Studio

• Voice settings override: Added voice_settings parameter to project creation for per-project voice configuration.

Webhook Tools

• Custom request headers: Added request_headers support to Webhook tool configuration for custom authentication and metadata.

Billing

• Schema improvements: Introduced BillingPeriod and CharacterRefreshPeriod enums for better type safety in subscription models.

Knowledge Base

• RAG query rewriting: Added query_rewrite_prompt_override to RAG configuration for customizing query rewriting behavior.

SDK Releases

JavaScript SDK

• v2.27.0 - Updated API schema with latest changes including Twilio registration endpoint and music word timestamps
• v2.26.0 - Added previous_text event support to Scribe and updated event types

Python SDK

• v2.26.0 - Fixed websocket disconnection code for user-triggered closures and updated API schema
• v2.25.0 - Added on-premises agent configuration support, previous_text event support to Scribe, and improved CI reliability

Packages

• @elevenlabs/[email protected] - Fixed bug with committed transcripts in React components
• @elevenlabs/[email protected] - Updated React version
• @elevenlabs/[email protected] - Improved scroll lock stability in agent widget
• @elevenlabs/[email protected] - Fixed auto-scroll behavior, added audioSessionConfiguration to ElevenLabsProvider, and added attributes for worklet scripts

Android SDK

• v0.7.0 - Added sendToolResult function for client tool support

iOS SDK

• v3.0.0 - Major release with breaking changes including onDisconnect now receives disconnect reason, added .thinking agent state, updated LiveKit to 2.10.0+, removed AsyncAlgorithms dependency, and added Swift 5.9+ support (previously required Swift 6.0). Includes SDK hardening, improved error handling, alignment data fixes, and agent response metadata support

ElevenLabs CLI

• @elevenlabs/[email protected] - Updated React version
• @elevenlabs/[email protected] - Fixed SDK dependencies to support recent features

API

• View API changes

Original source Report a problem

Agents Platform

• New LLM support: Extended LLM options with gemini-3-pro-preview model.
• Out-of-band DTMF: Added use_out_of_band_dtmf flag to PlayDTMFToolConfig for improved DTMF tone handling in telephony integrations.
• Validation improvements: Reduced maximum items for agent test submission from 200 to 100 for both ResubmitTestsRequestModel.test_run_ids and RunAgentTestsRequestModel.tests to improve performance and reliability.
• Live analytics: Added new analytics endpoint to retrieve real-time count of active conversations.
• Custom LLM API types: Added api_type field to CustomLLM schema with enum CustomLLMAPIType supporting chat_completions and responses options for flexible LLM integration.
• Conversation filtering: Enhanced conversation filtering with support for feedback ratings and comments.

Dubbing

• Speaker management: Added ability to create new speakers for dubbing resources and migrate segments between speakers.
• Speaker updates: Added speaker_name field support when updating dubbing speakers.
• Transcript defaults: Relaxed transcript schema requirements with defaults for text, word_type, and speaker_id fields, and removed some required field constraints for easier integration.
• Language code support: Clarified that source_lang and target_lang fields expect ISO 639-1/3 codes.

Studio

• Image asset support: Added ProjectImageResponseModel schema for image assets in projects.
• Project assets: ProjectResponseModel.assets now includes ProjectImageResponseModel for better asset management.
• Base voices: Added new ProjectResponseModel.base_voices field to project responses.
• Chapter voice IDs: Added voice_ids field to chapter response models.

Workspaces

• Webhook management: Added comprehensive webhook support with endpoints to create, update, and delete workspace webhooks for better integration capabilities.
• Extended billing periods: Expanded billing period options to include 3_month_period and 6_month_period.
• Conversation warnings: Added optional warnings array to conversation-related response models.

Music

• Enhanced prompts: Refined music prompt descriptions to include “musical directions” for more precise music generation guidance.

SDKs

JavaScript SDK

• v2.25.1 - Fixed PCM binary parsing for Music SDK.
• v2.25.0 - Updated SDK to support latest API schema changes including new dubbing endpoints, webhook management, and agent platform improvements.

Python SDK

• v2.24.0 - Updated SDK to support latest API schema changes including new dubbing endpoints, webhook management, and agent platform improvements.

React

• @elevenlabs/[email protected] - Fixed participant disconnect handling, added all Scribe event types, and improved iOS device ID handling.
• @elevenlabs/[email protected] - Added support for agent tool requests, enabling better integration with Agents Platform tools.
• @elevenlabs/[email protected] - Build improvements and version updates.

Client

• @elevenlabs/[email protected] - Fixed participant disconnect handling, added all Scribe event types, and improved iOS device ID handling.
• @elevenlabs/[email protected] - Added support for agent tool requests, enabling better integration with Agents Platform tools.
• @elevenlabs/[email protected] - Build improvements and version updates.
• @elevenlabs/[email protected] - Fixed LiveKit URL handling to respect custom LiveKit URLs.

React Native

• @elevenlabs/[email protected] - Fixed participant disconnect handling to properly clean up connections when participants leave.
• @elevenlabs/[email protected] - Fixed workspace resolution issue.
• @elevenlabs/[email protected] - Stabilized provider to prevent app reload during calls, added widget markdown renderer, fixed empty stream message handling, and updated Vite dependencies.

Types

• @elevenlabs/[email protected] - Added all Scribe event types for comprehensive speech-to-text event handling.
• @elevenlabs/[email protected] - Added types provenance for improved package security and integrity.

Swift SDK

• v3.0.0 - Major release with breaking changes including enhanced disconnect handling with reason parameter, new .thinking agent state, LiveKit 2.10.0+ support, Swift 5.9+ compatibility (down from 6.0 requirement), agent response metadata support, and improved error handling with audio pipeline control.

API

• View API changes

Original source Report a problem

Dubbing

• JSON transcript format: Added support for JSON format transcripts in the GET /v1/dubbing/{dubbing_id}/transcript/{language_code} endpoint, returning detailed word-level and character-level timing data via DubbingTranscriptResponseModel.

Agents Platform

• GPT-5.1 support: Added support for gpt-5.1 and gpt-5.1-2025-11-13 LLM models in agent configurations.
• Reasoning effort control: Added none option to LLMReasoningEffort for improved control over model reasoning behavior.
• Agent tool request events: Added agent_tool_request to ClientEvent for better tool interaction tracking in real-time conversations.
• Out-of-band DTMF: Added use_out_of_band_dtmf flag to PlayDTMFToolConfig for improved telephony integration.
• LLM model additions: Extended LLM enum with gemini-3-pro-preview for enhanced conversational AI capabilities.

Speech to Text

• Scribe quota exceeded events: Added quota_exceeded event in SDKs and include_timestamps parameter for better quota management and timestamp control.

Studio

• Chapter voice tracking: Added voice_ids field to chapter response models for better voice management in multi-voice projects.
• Project image assets: Introduced ProjectImageResponseModel for image asset support, now included in ProjectResponseModel.assets.
• Base voices field: Added base_voices field to ProjectResponseModel for improved voice management.

Text to Speech

• Text normalization control: Added TextNormalisationType enum and text_normalisation_type field across TTS voice settings for fine-grained control over text processing.
• TTS WebSocket tokens: Extended SingleUseTokenType with tts_websocket for secure WebSocket authentication.

SDK Releases

JavaScript SDK

• v2.25.0 - Updated with latest API schema changes including JSON dubbing transcripts and GPT-5.1 support
• v2.24.1 - Added include_timestamps parameter to Scribe API for timestamp control in transcriptions

Python SDK

• v2.24.0 - Updated with latest API schema changes including JSON dubbing transcripts and GPT-5.1 support
• v2.23.0 - Added include_timestamps parameter and quota_exceeded event to Scribe API for better quota management

Packages

• @elevenlabs/[email protected] - Added quota_exceeded event and include_timestamps parameter for Scribe integration
• @elevenlabs/[email protected] - Added quota_exceeded event and include_timestamps parameter for Scribe integration

API

• View API changes

Original source Report a problem

Agents Platform

• Widget end-call feedback: Widgets now support customizable end-of-call feedback collection with optional rating and comment fields, enabling you to gather user feedback directly within your agent conversations.
• Soft timeout configuration: Added comprehensive soft timeout settings to control how agents handle pauses in conversation, with configurable prompts and behavior across turn and conversation levels.
• Advanced conversation filtering: The conversations endpoint now supports filtering by call duration range, evaluation parameters, data collection parameters, and specific tool names.
• Enhanced conversation feedback: Updated conversation feedback system with structured feedback types including ratings and comments for better user experience tracking.

Studios

• Extended project metadata: Projects now include comprehensive asset tracking with video thumbnails, external audio references, and enhanced snapshot information including audio duration.

Billing

• Enhanced invoice details: Invoice responses now include detailed discount information with a new discounts array, replacing the deprecated discount_percent_off and discount_amount_off fields. The subtotal_cents and tax_cents fields provide clearer invoice breakdowns.

Music API

• Stem separation latency improvements: The stem separation endpoint has been updated to better handle audio files and provide more predictable latency for processing requests.

SDK Releases

JavaScript SDK

• v2.23.0 - Updated Speech to Text (Scribe) endpoint to scribe_realtime and exported additional TypeScript types for improved developer experience.
• v2.22.0 - Updated with latest API schema changes including conversation filtering, soft timeout configuration, and widget feedback features.

Python SDK

• v2.22.1 - Updated Speech to Text (Scribe) endpoint to scribe_realtime and fixed circular import issues for improved stability.
• v2.22.0 - Updated with latest API schema changes including conversation filtering, soft timeout configuration, and widget feedback features.

Android SDK

• v0.5.0 - Added setVolume and getVolume functions for programmatic audio control, with example implementation including a volume seek bar in the sample app.

Agents Packages

• @elevenlabs/[email protected] - Updated realtime endpoint configuration and improved documentation.
• @elevenlabs/[email protected] - Updated realtime endpoint configuration and improved documentation.
• @elevenlabs/[email protected] - Updated type definitions to match latest API schema changes.
• @elevenlabs/[email protected] - Minor bug fixes and stability improvements.
• @elevenlabs/[email protected] - Updated widget embed functionality with end-call feedback support.
• @elevenlabs/[email protected] - Added end-call feedback configuration to widget core.
• @elevenlabs/[email protected] - Added support for customizable end-of-call feedback collection.
• @elevenlabs/[email protected] - Introduced WidgetEndFeedbackConfig and WidgetEndFeedbackType for feedback handling.
• @elevenlabs/[email protected] - Updated client configuration with latest API changes.

API

• View API changes

Original source Report a problem

UI

• Improved notifications: Updated notification system to display notifications relevant to the active platform you’re viewing, providing a more focused and contextual experience.

Agents Platform

• Dynamic variable transfer destinations: Agent transfers now support dynamic variables for phone numbers and SIP URIs, enabling runtime-determined transfer destinations based on conversation context.
• MCP tool configuration overrides: Added the ability to create, update, retrieve, and delete custom configuration overrides for specific MCP Server tools, allowing fine-grained control over tool behavior and parameters.

Text to Dialogue

• Timestamps and voice segments: Text to Dialogue now supports timestamped outputs with character-level alignment and voice segment tracking, making it easier to synchronize dialogue with animations or subtitles.

Music API

• Stem separation: Added new stem separation endpoint to isolate different audio components (vocals, drums, bass, instruments) from existing music tracks.
• Increased prompt length: Music generation now supports prompts up to 4,100 characters, with individual lyric lines supporting up to 200 characters.

Security

• Single-use tokens: Introduced time-limited single-use token generation for secure operations, providing enhanced security for sensitive API operations.

SDK Releases

JavaScript SDK

• v2.22.0 - Updated with latest API schema changes including workspace model approvals and MCP tool configuration endpoints.
• v2.21.0 - Added support for intercepting raw WebSocket messages via a general message handler, allowing developers to access all messages beyond the standard callbacks, including undocumented message types like agent_tool_response.

Python SDK

• v2.22.0 - Updated with latest API schema changes including workspace model approvals and MCP tool configuration endpoints.
• v2.21.0 - Replaced print statements with proper logging to support better debugging and production use cases.

Agents Packages

• @elevenlabs/[email protected] - Package deprecated in favor of the unified ElevenLabs CLI.
• @elevenlabs/[email protected] - Fixed issue where end_call tool wasn’t properly ending conversations, and improved React Native reconnection logic after manual disconnection.
• @elevenlabs/[email protected] - Fixed issue where end_call tool wasn’t properly ending conversations, and improved reconnection logic after manual disconnection.
• @elevenlabs/[email protected] - Fixed issue where end_call tool wasn’t properly ending conversations, and improved React Native reconnection logic.

Android SDK

• v0.4.0 - Improved type safety by using ConversationMode enums instead of strings, migrated from LiveData to StateFlow with backward compatibility support, and fixed bug where agents wouldn’t end calls when requested.

iOS SDK

• v2.0.16 - Fixed issue where the end_call tool wasn’t properly ending conversations, ensuring agents can correctly terminate calls.

CLI

• @elevenlabs/[email protected] - Removed --env flag support for virtual environment isolation. This feature will be reintroduced once proper environment isolation is supported in the product.

API

TLS

Our TLS endpoints no longer allow some older and insecure cipher modes. Most clients should not be affected as they already negotiate a modern cipher mode.

View API changes

Original source Report a problem

Workspaces

• External voice sharing controls: External voice sharing and Voice Library publishing can now be disabled via workspace groups. Internal (in-organization) voice sharing is not impacted.

Agents Platform

• Multi-environment agent management: The Agents CLI now supports the --env flag, allowing you to manage agents deployed to multiple accounts simultaneously.
• Search functionality: Added search parameter to the Get conversations endpoint for filtering conversations.

SDK Releases

JavaScript SDK

• v2.20.1 - Fixed Music API type definitions and added Realtime Scribe language code support
• v2.20.0 - Added helper methods for Realtime Scribe with improved ASR capabilities. This is a beta feature and not widely available yet

Python SDK

• v2.20.1 - Fixed file parameter handling in client methods
• v2.20.0 - API schema updates and improvements
• v2.19.0 - Added helper method for Scribe Realtime with improved ASR capabilities. This is a beta feature and not widely available yet

Agents CLI

• @elevenlabs/[email protected] - Added support for --env flag to manage agents across multiple accounts, plus bug fixes and reliability improvements

React Native

• @elevenlabs/[email protected] - Removed build script and postinstall steps for improved installation experience

React

• @elevenlabs/[email protected] - Removed build script and postinstall steps for improved installation experience

Client

• @elevenlabs/[email protected] - Removed build script and postinstall steps for improved installation experience

API

• View API changes

Original source Report a problem

Agents Platform

• Genesys configuration overrides: Genesys users can now override agent configuration directly from their Genesys flows using session variables. Use system__override_system_prompt, system__override_first_message, and system__override_language to customize the agent’s behavior, first message, and language for specific call flows without modifying the base agent configuration.
• Batch call ID copying: Added copy-to-clipboard functionality for batch call IDs throughout the Agents Platform interface. Click on batch call IDs in the batch call details page or conversation history to quickly copy them for API interactions, support requests, or debugging.

SDK Releases

Python SDK

• v2.18.0 - Added streaming support for Agents Platform conversations via the Conversation class, Music API inpainting with new output format options, and Agent Workflows support including workflow models, node types, and conditional logic operators (AND, OR, equals, greater than, less than, etc.)

JavaScript SDK

• v2.19.0 - Added Agent Workflows support including AgentWorkflowRequestModel, AgentWorkflowResponseModel, and AST node types for building workflow conditions (boolean nodes, dynamic variable nodes, comparison operators), Music API inpainting with new output format options, and the archived parameter for agent list requests

Agents CLI

• @elevenlabs/[email protected] - Added --env flag to manage agents deployed to multiple accounts simultaneously
• @elevenlabs/[email protected] - Reworked agents pull functionality

React Native

• @elevenlabs/[email protected] - Fixed onConnect timing issue
• @elevenlabs/[email protected] - Reverted change to ICE transport policy

API

• View API changes

Original source Report a problem

Agents Platform

• LLM overrides: Added support for overriding an agent’s LLM during a conversation, enabling you to specify a different language model on a per-conversation basis. This is useful for testing different models or accommodating specific requirements while maintaining HIPAA and data residency compliance.
• Post-call webhook failures: Added the option to send post-call webhook events in the event of a phone call failure. This allows you to track and respond to failed call attempts through your webhook endpoint, providing better visibility into call issues.

SDK Releases

Python SDK

• v2.18.0 - Added support for streaming, Music API inpainting, and Agent Workflows

JavaScript SDK

• v2.19.0 - Added support for Music API inpainting and Agent Workflows
• v2.18.0 - API schema updates

Client Packages

• @elevenlabs/[email protected] - Significantly reworked agents pull command with bugfixes and improvements
• @elevenlabs/[email protected] - Fixed import issues
• @elevenlabs/[email protected] - Fixed onConnect timing
• @elevenlabs/[email protected] - Reverted change to ICE transport policy
• @elevenlabs/[email protected] - Fixed import issues

Original source Report a problem

Agents Platform

• Gemini 2.5 Flash Preview models: Added support for gemini-2.5-flash-preview-09-2025 and gemini-2.5-flash-lite-preview-09-2025 LLM models, providing access to the latest September 2025 preview versions of Google’s Gemini 2.5 Flash models.
• Claude Sonnet 4.5: Added support for claude-sonnet-4-5 and claude-sonnet-4-5@20250929 models, enabling access to the latest Claude Sonnet 4.5 model released on September 29, 2025.
• Test invocations listing: Added new GET /v1/convai/test-invocations endpoint to list all test invocations with pagination support. Includes agent_id filter, page_size parameter (default 30, max 100), and cursor for pagination. Response includes test run counts, pass/fail statistics, and titles.
• Agent archiving: Added archived field (boolean, default false) to agent platform settings, allowing agents to be archived without deletion while keeping them out of active agent lists.
• MCP Server interruption control: Added disable_interruptions field (boolean, default false) to MCP server configuration, preventing user interruptions during tool execution for more reliable tool completion.
• Streaming agent responses: Added agent_chat_response_part WebSocket event type for receiving partial agent chat responses in real-time during streaming conversations.
• Workflow edge ordering: Added edge_order field (array of strings) to all workflow node types, enabling explicit control over edge evaluation order for deterministic workflow execution.
• Test suite agent tracking: Added agent_id field (string, nullable) to test invocation responses for associating test runs with specific agents.

Voice Management

• Voice generation source tracking: Added VoiceGeneration as a new source type in the History API for tracking audio generated from voice generation features.

Telephony

• SIP trunk TLS validation: Added remote_domains field (array of strings, nullable) to SIP trunk configuration for specifying domains used in TLS certificate validation.

SDK Releases

• JavaScript SDK

  • v2.18.0 - Updated with latest API schema changes from October 8, 2025

• Python SDK

  • v2.17.0 - Updated with latest API schema changes and URL generation fixes from October 6, 2025

• Packages
  All packages updated with latest API schema changes:

  • @elevenlabs/[email protected] - Updated TypeScript types and API client with new fields for agent archiving, MCP server configuration, and test invocations
  • @elevenlabs/[email protected] - Updated React hooks and components with support for new agent settings and WebSocket events
  • @elevenlabs/[email protected] - Core client library updated with new endpoint for test invocations listing and reorganized SDK method paths for secrets management
  • @elevenlabs/[email protected] - CLI tool updated with support for new agent archiving flag and test invocation commands

MCP Server

• v0.9.0 - Added option to return MCP server results as resource items for better integration with resource-based workflows

API

• View API changes

Original source Report a problem