GET STARTED

Changelog

October 14, 2025

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

October 7, 2025

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/react-native@0.3.2 - Updated TypeScript types and API client with new fields for agent archiving, MCP server configuration, and test invocations
  • @elevenlabs/react@0.7.1 - Updated React hooks and components with support for new agent settings and WebSocket events
  • @elevenlabs/client@0.7.1 - Core client library updated with new endpoint for test invocations listing and reorganized SDK method paths for secrets management
  • @elevenlabs/agents-cli@0.4.2 - 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

New Endpoints

Agents Platform

  • GET /v1/convai/test-invocations - List all test invocations with pagination support
    • Parameters:
      • agent_id (required, string) - Filter by agent ID
      • page_size (optional, integer, default=30, max=100) - Number of results per page
      • cursor (optional, string) - Pagination cursor from previous response
    • Response: Returns paginated list with test run counts, pass/fail statistics, titles, and next cursor

New Fields

Agents Platform

  • Agent Settings: Added archived field (boolean, default false) to AgentPlatformSettingsRequestModel and AgentPlatformSettingsResponseModel for archiving agents
  • MCP Servers: Added disable_interruptions field (boolean, default false) to MCP server configuration schemas for preventing user interruptions during tool execution
  • Workflows: Added edge_order field (array of strings) to all workflow node types for explicit edge evaluation ordering
  • Test Invocations: Added agent_id field (string, nullable) to GetTestSuiteInvocationResponseModel for agent tracking

Telephony

  • SIP Trunks: Added remote_domains field (array of strings, nullable) to GetPhoneNumberInboundSIPTrunkConfigResponseModel and InboundSIPTrunkConfigRequestModel for TLS certificate validation

WebSocket Events

  • Added agent_chat_response_part to ServerEventType enum for streaming partial agent chat responses

Voice Management

  • Added VoiceGeneration to speech history source types

New LLM Models

Added the following models to the LLM enum:

  • claude-sonnet-4-5 - Claude Sonnet 4.5 latest
  • claude-sonnet-4-5@20250929 - Claude Sonnet 4.5 dated release (September 29, 2025)
  • gemini-2.5-flash-preview-09-2025 - Gemini 2.5 Flash preview (September 2025)
  • gemini-2.5-flash-lite-preview-09-2025 - Gemini 2.5 Flash Lite preview (September 2025)

Other Changes

Pronunciation Dictionaries

  • Updated parameter description for version_id in GET /v1/pronunciation-dictionaries/{dictionary_id}/{version_id}/download from “The id of the version of the pronunciation dictionary” to “The id of the pronunciation dictionary version”
  • Removed documentation note about UI limitation for multiple pronunciation dictionaries (multiple dictionaries now fully supported in UI)

Conversation History

  • Made type field optional in ConversationHistoryTranscriptOtherToolsResultCommonModel (previously required)
September 29, 2025

v1 TTS model deprecation

The eleven_monolingual_v1 and eleven_multilingual_v1 models are deprecated and will be removed on December 15th, 2025. Please migrate to newer models for continued service.

Agents Platform

  • Workflow Expressions: Workflows now support complex expressions that allow for defining deterministic conditions using logical operators, dynamic variables and LLM evaluation. This enables more sophisticated agent logic and decision-making capabilities.
  • MCP Server Interrupt Control: Added option to disable interruptions during all tool calls for MCP Servers, providing better control over agent behavior during tool execution.
  • Audio Alignment Data: Agents now have a flag to enable alignment data in audio events, useful for audio-text synchronization use cases such as lip sync applications.
  • Ignore Default Personality Setting: The Agents Platform configuration page now includes a checkbox to toggle whether agents should ignore the default helpful personality, giving developers more control over agent behavior.

Speech to Text

  • Fixed Base64 Encoding Flag: Resolved an issue where the is_base64_encoded flag in STT responses was incorrectly set to false for PDF and DOCX formats, even when content was actually base64 encoded.

SDK Releases

JavaScript SDK

  • v2.16.0: Updated with latest API schema changes from September 19, 2025.

Packages

  • @elevenlabs/types@0.0.1: New public TypeScript types package providing shared type definitions across ElevenLabs integrations.
  • @elevenlabs/react@0.7.0 and @elevenlabs/client@0.7.0: Added support for passing custom script paths to avoid blob: and data: URLs for improved security and flexibility.
  • @elevenlabs/convai-widget-embed@0.3.0 and @elevenlabs/convai-widget-core@0.3.0: Added use_rtc attribute for widget functionality and added expand event support for better widget interaction handling.

API

Updated Endpoints

Agents Platform

  • POST /v1/convai/agents/create: Added ignore_default_personality boolean parameter to control whether agents should ignore the default helpful personality behavior
  • PATCH /v1/convai/agents/{agent_id}: Added ignore_default_personality field support for agent updates
  • GET /v1/convai/agents/{agent_id}: Response now includes ignore_default_personality field in agent configuration
  • POST /v1/convai/mcp-servers: Added interrupt control configuration parameters for disabling interruptions during tool calls
  • PATCH /v1/convai/mcp-servers/{mcp_server_id}: Enhanced with interrupt control settings for MCP server configuration
  • GET /v1/convai/mcp-servers/{mcp_server_id}: Response includes new interrupt control configuration fields
  • GET /v1/convai/conversations/{conversation_id}: Response enhanced with alignment data fields for audio-text synchronization support
  • POST /v1/convai/agent-testing/create: Enhanced to support workflow expressions functionality in agent testing
  • GET /v1/convai/agent-testing/{test_id}: Response includes additional fields for workflow expression test results
  • PUT /v1/convai/agent-testing/{test_id}: Request and response schemas updated for workflow expression support
  • POST /v1/convai/agents/{agent_id}/simulate-conversation: Request schema updated to support workflow expressions in conversation simulation
  • POST /v1/convai/agents/{agent_id}/simulate-conversation/stream: Streaming conversation simulation with workflow expression support
  • GET /v1/convai/settings: Response includes new platform configuration options
  • PATCH /v1/convai/settings: Request schema updated with new platform settings
  • POST /v1/convai/batch-calling/submit: Request schema updates for batch calling functionality
  • PATCH /v1/convai/mcp-servers/{mcp_server_id}/approval-policy: Response schema updated for approval policy management
  • POST /v1/convai/mcp-servers/{mcp_server_id}/tool-approvals: Response schema enhanced for tool approval handling
  • DELETE /v1/convai/mcp-servers/{mcp_server_id}/tool-approvals/{tool_name}: Response schema updated for tool approval removal

Speech to Text

  • POST /v1/speech-to-text: Fixed is_base64_encoded boolean flag to correctly return true when PDF and DOCX document content is base64 encoded

Text to Speech

  • POST /v1/text-to-speech/{voice_id}/with-timestamps: Request and response schemas updated for enhanced timestamp functionality
  • POST /v1/text-to-speech/{voice_id}/stream: Request schema updated for improved streaming parameters
  • POST /v1/text-to-speech/{voice_id}/stream/with-timestamps: Request and response schemas updated for streaming with timestamps
  • POST /v1/text-to-voice/create-previews: Request schema enhanced with new preview generation options
  • POST /v1/text-to-voice: Response schema updated with additional voice creation data
  • POST /v1/text-to-voice/{voice_id}/remix: Request schema enhanced for voice remixing parameters

Voice Management

  • GET /v1/voices: Response schema updated with new voice metadata fields
  • GET /v1/voices/{voice_id}: Response schema enhanced with additional voice properties
  • GET /v1/voices/settings/default: Response schema updated for default voice settings
  • GET /v1/voices/{voice_id}/settings: Response schema enhanced with new configuration options
  • POST /v1/voices/{voice_id}/settings/edit: Request schema updated for voice settings modification
  • POST /v1/voices/pvc/{voice_id}/samples/{sample_id}: Request schema enhanced for PVC sample management
  • GET /v1/voices/pvc/{voice_id}/samples/{sample_id}/audio: Response schema updated for audio sample retrieval
  • GET /v1/voices/pvc/{voice_id}/samples/{sample_id}/speakers/{speaker_id}/audio: Response schema enhanced for speaker-specific audio
  • POST /v1/voice-generation/create-voice: Response schema updated with new voice generation data

Studio

  • POST /v1/studio/podcasts: Request schema enhanced with new podcast creation parameters

User Management

  • GET /v1/user: Response schema updated with additional user profile data

All changes are backward compatible and do not require immediate action from developers.

September 22, 2025

Productions launch

Introducing Productions - our new managed service offering for ordering human-edited content that looks, sounds and feels natural. Made for creators and media businesses.

Our network of linguists and audio professionals offer end-to-end production quality for:

  • Dubbing
  • Captions and subtitles
  • Transcription
  • Audiobooks

You can order a project directly from the ‘Productions’ page in your ElevenLabs account, or by emailing productions@elevenlabs.io. Pricing starts at $2/minute, contact us for more details.

Agents Platform

  • MCP pre-tool speech: Added support for configuring tools extracted from an MCP Server to require pre-tool execution speech. This enhancement allows agents to provide verbal context before executing specific tools, improving the conversational flow during tool usage.

  • ElevenLabs hosted LLMs: Added support for ElevenLabs hosted LLMs which unlock lower latency by running on ElevenLabs infrastructure alongside Speech to Text and Text to Speech services.

  • Enum values for tool parameters: Added support for specifying a tool’s parameters as enum values for greater control

SDK Releases

JavaScript SDK

  • v2.16.0: Updated the elevenlabs-js SDK with the latest API schema changes, including new MCP server endpoints and enhanced history filtering capabilities.

Python SDK

  • v2.16.0: Updated the elevenlabs-python SDK with the latest API schema changes, including new MCP server endpoints and enhanced history filtering capabilities.
  • v2.15.1: Fixed conversation handling when no authentication is required and added asyncio event loop support for better async operations.

Package Updates

  • @elevenlabs/agents-cli@0.3.2: Updated the Agents CLI package with improvements to agent development tools. The ConvAI CLI has been renamed to Agents CLI to align with the ElevenLabs Agents Platform branding.
  • @elevenlabs/convai-cli@0.2.3: Final release of the legacy ConvAI CLI package before migration to the new Agents CLI.
  • @elevenlabs/react@0.6.3: Updated the React components package with enhanced functionality.

API

New Endpoints

  • PATCH /v1/convai/mcp-servers/{mcp_server_id} - Update MCP Server Configuration: Added new endpoint to update MCP server configurations, replacing the deprecated approval policy endpoint.

Updated Endpoints

History Management

  • GET /v1/history - Get generated items: Enhanced with additional filtering parameters:
    • Added model_id parameter for filtering by specific models
    • Added date_before_unix parameter for filtering items before a specific date
    • Added date_after_unix parameter for filtering items after a specific date
    • Added sort_direction parameter for controlling sort order

Deprecated Endpoints

  • PATCH /v1/convai/mcp-servers/{mcp_server_id}/approval-policy - Deprecated in favor of the new general MCP server update endpoint
September 15, 2025

Text to Speech

  • WebSocket output format: Added support for specifying output format in the first message of a WebSocket connection, providing greater flexibility for real-time audio streaming workflows.

Agents Platform

  • First message interruption control: Added disable_first_message_interruptions setting to prevent agents from being interrupted during important opening messages like legal disclaimers.

MCP Server

  • Version 0.8.1: Added data residency support.

SDK Releases

JavaScript SDK

  • v2.15.0 - Added new Text to Voice Remix endpoint

Python SDK

  • v2.15.1 - Fixed conversation authentication issue and added asyncio event loop support
  • v2.15.0 - Added new Text to Voice Remix endpoint and fixed Pydantic issues

Packages

  • @elevenlabs/react@0.6.2 - Added correction and MCP tool call events
  • @elevenlabs/client@0.6.2 - Added correction and MCP tool call events
  • @elevenlabs/react-native@0.3.1 - Added correction and MCP tool call events

API

New Endpoints

Updated Endpoints

Backward Compatible Changes

September 8, 2025

Text to Speech

  • Language code support: All Text to Speech models now support language codes for improved output. Normalization has been enabled for Eleven v3, Flash, and Turbo models to enhance audio quality and consistency.

Agents Platform

  • Multi-voice agent history: Messages from multi-voice agents are now displayed in conversation history with clear separation by voice, making it easier to follow which voice spoke which part of a conversation.

SDK Releases

JavaScript SDK

  • v2.15.0 - Adds support for new voice remix functionality

Python SDK

  • v2.15.0 - Adds support for new voice remix functionality. Also fixed an issue with Pydantic.

React Components

  • @elevenlabs/react@0.6.1 - Fix output bytes and device input/output switching
  • @elevenlabs/client@0.6.1 - Fix output bytes and device input/output switching

MCP Server

  • v0.7.0 - Latest release of the ElevenLabs MCP Server with new features and improvements for Claude Desktop integration. Includes new loop parameter for SFX generation.

API

New Endpoints

Updated Endpoints

Backward Compatible Changes

  • Get Project - Added optional share_id query parameter for project sharing functionality
  • Convert Speech to Text - Modified enable_logging parameter for improved logging control

All API changes in this release are backward compatible and will not break existing integrations.

September 1, 2025

Agents Platform

  • Gemini 2.5 Flash Lite HIPAA compliance: Added Gemini 2.5 Flash Lite to the list of HIPAA approved models for compliant conversations when a BAA is signed and zero-retention mode is enabled.
  • Conversation ID in signed URLs: Added support for including conversation IDs in signed URL requests, providing better tracking and identification capabilities for conversation audio access.

SDK Releases

JavaScript SDK

  • v2.13.0 - Released August 29, 2025. Adds support for new loop parameter in SFX.

Python SDK

  • v2.13.0 - Released August 29, 2025. Adds support for new loop parameter in SFX.

ConvAI packages

MCP Server

  • ElevenLabs MCP Server v0.6.0 - Released August 26, 2025. Fixed diarization functionality in speech-to-text and added music generation endpoints.

API

Updated Endpoints

Dubbing

  • Render project - Added optional should_normalize_volume query parameter to control audio normalization during rendering

Agents Platform

  • Get signed URL - Added optional include_conversation_id query parameter to include conversation ID in the response

Sound Effects

  • Create sound effect - Added optional loop parameter to create sound effects that loop smoothly

Removed Endpoints

  • Delete workspace member - Removed the DELETE /v1/workspace/members endpoint for deleting workspace members. This endpoint was never meant to be publicly available.
August 25, 2025

Agents Platform

  • Agent testing framework: Introduced a comprehensive testing framework for ElevenLabs agents, allowing developers to create, manage, and execute automated tests for their agents. This includes test creation, execution tracking, and result analysis capabilities.
  • Test invocation management: Added support for resubmitting failed test invocations and viewing detailed test results to help developers debug and improve their agents.
  • Enhanced agent configuration: Improved agent creation and management with additional workspace override capabilities and refined platform settings.

Text to Speech

  • Pronunciation dictionary updates: Added support for updating pronunciation dictionaries with PATCH operations, enabling more flexible dictionary management.
  • Enhanced timestamp support: Improved timestamp generation for text-to-speech conversions with better alignment data and streaming capabilities.

SDK Releases

  • TypeScript SDK v2.12.2: Updated with the latest API schema changes, including full support for the new agent testing endpoints and enhanced Agents Platform capabilities.
  • Python SDK v2.12.1: Released with complete support for all new API features, including agent testing framework and improved workspace resource management.

API

New Endpoints

Added 10 new endpoints this week:

ElevenLabs agent Testing

Pronunciation Dictionaries

  • PATCH /v1/pronunciation-dictionaries/{pronunciation_dictionary_id} - Update Pronunciation Dictionary - Update existing pronunciation dictionaries with new rules or modifications
August 20, 2025

Eleven v3 API

Eleven v3 is now available via the API.

To start using it, simply specify the model ID eleven_v3 when making Text to Speech requests.

Additionally the Text to Dialogue API endpoint is now available to all.

Music Generation API

The Eleven Music API is now freely available to all paid users.

Visit the quickstart to lean how to integrate. The API section below highlights the new endpoints that have been released.

Global TTS API preview

ElevenLabs is launching inference servers in additional geographical regions to reduce latency for clients outside of the US. Initial request processing will be available in the Netherlands and in Singapore in addition to the US.

To learn how to get started head to the docs.

API

New Endpoints

Updated Endpoints

Text to Speech

Voice Management

Speech to Text

Usage and Analytics

  • Updated Usage endpoints:
    • Get character stats - Added aggregation bucket size parameter and improved breakdown type options

Workspace Management

August 11, 2025

Music

Eleven Music: Officially released new music generation model that creates studio-grade music with natural language prompts in any style. See the capabilities page and prompting guide for more information.

SDKs

v2.9.0 of the TypesScript SDK released

  • Includes better typing support for Speech to Text requests in webhook mode
  • Includes new enums for ChatGPT 5

v2.9.2 of the Python SDK released

  • Includes new enums for ChatGPT 5

Agents Platform

Agent response correction: Updated WebSocket event schema and handling for improved agent response correction functionality.

API

User Account Changes

  • Updated user account endpoint:
    • Get user subscription info - Deprecated convai_chars_per_minute and convai_asr_chars_per_minute fields in the response schema. These fields will now always return None.

Parameter Removals

  • Updated conversation token endpoint:
    • Get conversation token - Removed source and version query parameters. These were internal parameters not meant for public use and their removal does not affect functionality.