GET STARTED

Changelog

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.
August 4, 2025

Agents Platform

  • Conversation token generation: Added new route to generate Conversation Tokens for WebRTC connections. Learn more
  • Expandable widget options: Our embeddable widget can now be customized to start in the expanded state and disable collapsing altogether.
  • Simplified operation IDs: We simplified the OpenAPI operator IDs for Agents Platform endpoints to improve developer experience.

Workspaces

  • Simplified operation IDs: We simplified the operation IDs for our workspace endpoints to improve API usability.

SDK Releases

  • Python SDK v2.8.2: Released latest version with improvements and bug fixes. View release

NPM Packages

  • @elevenlabs/react-native@0.1.2: Enhanced React Native support
  • @elevenlabs/client@0.4.4: Client library improvements
  • @elevenlabs/react@0.4.5: React component updates

API

New Endpoints

Agents Platform

Updated Endpoints

Voice Management

  • List voices - Added voice_ids query parameter for filtering specific voices

Agents Platform Core

Operation ID Improvements

  • Agents Platform endpoints: Simplified operation IDs for better developer experience while maintaining full backward compatibility
  • Workspace endpoints: Streamlined operation IDs across all workspace-related endpoints to improve API usability
July 28, 2025

Workspaces

  • Service account API key management: Added comprehensive API endpoints for managing service account API keys, including creation, retrieval, updating, and deletion capabilities. See Service Accounts documentation.

Agents Platform

  • Post-call webhook migration: The post call webhook format is being migrated so that webhook handlers can be auto generated in the SDKs. This is not a breaking change, and no further action is required if your current handler accepts additional fields. Please see more information here.
  • Agent transfer improvements: Fixed system variable system_agent_id to properly update after agent-to-agent transfers, ensuring accurate conversation context tracking. Added new system_current_agent_id variable for tracking current active agent. Learn more about dynamic variables.
  • Enhanced public agent page: Added text input functionality and dynamic variable support to the public talk-to-agent page. You can now pass dynamic variables via URL parameters (e.g., ?var_username=value) and use text input during voice conversations. See dynamic variables guide.
  • Voicemail detection: Added voicemail detection as a built-in tool for ElevenLabs agents to improve call handling. Learn about voicemail detection.
  • Conversation filtering: Added user_id query parameter to conversation list endpoint for filtering conversations by initiating user.

Speech to Text

  • Multi-channel transcription: Added use_multi_channel parameter to transcription endpoint for processing audio files with multiple speakers on separate channels. Supports up to 5 channels with per-channel transcription results. See multichannel guide.

Studio

  • Caption support: Added caption functionality to Studio projects with new captions_enabled and caption_style properties for both podcasts and general projects. Learn more about Studio.

SDKs

API Schema Updates

New Endpoints

  • Service Account Management: Added 5 new endpoints for service account API key management:
    • GET /v1/service-accounts/{service_account_user_id}/api-keys - Retrieve service account API keys
    • POST /v1/service-accounts/{service_account_user_id}/api-keys - Create service account API key
    • DELETE /v1/service-accounts/{service_account_user_id}/api-keys/{api_key_id} - Delete service account API key
    • PATCH /v1/service-accounts/{service_account_user_id}/api-keys/{api_key_id} - Update service account API key
    • GET /v1/service-accounts - Get workspace service accounts

Removed Endpoints

  • Legacy Project Endpoints: Removed 22 deprecated project management endpoints as part of Studio API consolidation:
    • All /v1/projects/* endpoints (replaced by /v1/studio/projects/*)
    • Legacy Text to Voice endpoints (/v1/text-to-voice/create-voice-from-preview, /v1/text-to-voice/remixing-sessions/*)
    • Legacy ConvAI knowledge base endpoints

Updated Endpoints

Speech to Text

  • Multi-channel support: Updated /v1/speech-to-text endpoint:
    • Added use_multi_channel parameter for processing multi-speaker audio files
    • Modified response structure to include optional language_code, language_probability, text, and words properties

Agents Platform

  • Enhanced agent configuration: Updated agent creation and management endpoints:
    • Added voicemail detection to built-in tools
    • Improved RAG configuration with max_retrieved_rag_chunks_count parameter
    • Enhanced conversation token endpoint with source and version parameters
    • Added user_id filtering to conversations list endpoint

Studio Projects

  • Caption support: Updated Studio project endpoints to include:
    • captions_enabled property for enabling/disabling captions
    • caption_style property for global caption styling configuration

Text to Voice

  • Improved voice generation: Enhanced voice creation endpoints with:
    • loudness control (-1 to 1 range, 0 corresponds to -24 LUFS)
    • quality parameter for balancing output quality vs variety
    • guidance_scale parameter for controlling AI creativity vs prompt adherence