Eleven Labs Release Notes

Text to Speech

• v1 model removal: The eleven_monolingual_v1 and eleven_multilingual_v1 models are deprecated and will be removed on July 9, 2026. Migrate to eleven_multilingual_v2 or another current model before removal. See deprecated models for replacement suggestions.

Speech to Text

• Scribe v1 removal: The scribe_v1 model is deprecated and will be removed on July 9, 2026. Migrate to scribe_v2 or scribe_v2_realtime before removal. See deprecated models for replacement suggestions.

ElevenAgents

• Turn model configuration: TurnConfig and TurnConfigWorkflowOverride add optional turn_model (turn_v2 or turn_v3, default turn_v3) to select the turn detection model version per agent or workflow node.
• Soft timeout filler messages: SoftTimeoutConfig and SoftTimeoutConfigWorkflowOverride add optional additional_soft_timeout_messages (array of strings, up to 7) and max_soft_timeouts_per_generation (integer, 1–8, default 1). The primary message applies to the first timeout; subsequent timeouts use the additional messages or a built-in filler.
• ASR provider default: The default ASRConversationalConfig.provider value changes from elevenlabs to scribe_realtime. The elevenlabs value remains in the enum but is deprecated. …

ElevenAgents

• Exotel telephony integration: Added Exotel as a first-class telephony provider alongside Twilio and SIP trunking. New Exotel outbound call endpoint (POST /v1/convai/exotel/outbound-call) initiates outbound calls via the Exotel Connect API with agent_id, agent_phone_number_id, to_number, optional conversation_initiation_client_data and optional telephony_call_config. Exotel phone number create, list, get and update schemas are available, and exotel is added to TelephonyProvider, conversation initiation source and transfer result enums.
• Workflow-aware agent transfers: AgentTransfer now allows a nullable agent_id so transfers can stay on the current agent, adds optional node_id to start at a specific node in the destination workflow, and only requires condition. Successful transfer_to_agent tool results can include nullable to_node, aligning transfers with workflow-node targets.
• Agent test repeat runs: Run tests on the agent accepts optional repeat_count (integer, 1–20, default 1) to run each test multiple times. When repeat_count is greater than 1, responses include bucketing_status and result_groups for grouped summaries. Unit test create, update and summary schemas add optional conversation_initiation_source so tests can simulate a specific channel. …

Introducing Speech Engine

ElevenLabs Speech Engine adds real-time voice to your own chat agent or LLM. ElevenLabs handles speech-to-text, turn-taking, text-to-speech and browser playback while your server owns the agent logic and streams response text over a Speech Engine WebSocket. Use it when you want voice on a custom runtime rather than a fully hosted ElevenAgents configuration.

ElevenAgents

• Text behavior overrides: Added text_behavior_overrides, a per-ConversationInitiationSource map of BehaviorOverride objects with optional verbosity, output_format and interaction_budget fields for channel-specific agent behavior.
• Integration sources: Added Intercom, Telegram and Freshdesk.
• OTLP conversation traces: Get conversation details now accepts an optional format query parameter. Set format=otlp_traces to return OTLP-compatible trace data alongside the standard conversation payload.
• ASR keyword overrides: Added ASRConversationalConfigOverride and ASRConversationalConfigOverrideConfig schemas with optional keywords arrays, wired into conversation config client override models.
• Webhook auth metadata: Webhook tool configuration schemas now expose optional auth_resolved_params (string array) documenting URL placeholders resolved from the auth connection.

Music …

ElevenAgents

• Agent version metadata: Added an API endpoint to retrieve metadata for a specific agent version. The response includes the version ID, agent ID, branch ID, description, sequence number, commit timestamp, parents and access information.
• Conversation filtering: Added a text_only filter to conversation list and message text search endpoints so developers can narrow results to text-only conversations.
• Procedure loading: Added load_procedure as a system tool configuration with ProcedureAtVersion, and added skills to ProcedureCompilerMode. ProcedureSettings.compiler_mode now defaults to skills.
• Agent configuration updates: Added gemini-3.1-flash-lite and qwen35-397b-a17b as LLM options, added genesys_bot_connector as a conversation initiation source, added auto_resolve_after_inactive_minutes to alerting settings, and added attributes_to_headers to SIP trunk configuration.
• Custom LLM temperature: Agent prompt temperature can now be set to null to omit the temperature field from downstream LLM requests.

Workspaces

• Auth connection updates: Added an API endpoint to update workspace auth connections. The endpoint supports updating basic auth, OAuth2 client credentials and OAuth2 JWT connections. OAuth2 client credentials now support custom_headers for token requests.
• Auth connection types: Added bearer auth create request support and Slack bot auth response schemas. …

ElevenAgents

• SIP logs: SIP signaling logs are now available for SIP trunk calls in conversation history and phone number settings. Logs include the SIP call ID, phone numbers, addresses, transport, message direction, raw messages and errors to help debug call setup and routing issues.
• Knowledge base document updates: New API to list indexed (RAG) chunks for a document. Documents can also be edited in place: rename the item and, for text-based documents, update the body without re-uploading the file. (File-based documents still use the existing replace-file flow where applicable.)
• SMS conversation metadata: Added SMS support to conversation metadata with SMSConversationInfo, sms as an authorization method and twilio_sms as a conversation initiation source.
• Agent configuration updates: Added background music configuration schemas, alerting monitor configuration, 2D layout fields, widget file upload configuration, and new LLM options gpt-5.4-mini, gpt-5.4-nano, gpt-5.4-mini-2026-03-17 and gpt-5.4-nano-2026-03-17.

Workspaces

• API request analytics: Added a workspace analytics endpoint for querying API requests with time range, filtering, search, sort and limit controls. …

ElevenAgents

• Conversation tags: Added first-class conversation tags for organizing and filtering conversations. You can now create, update, list and delete tags, assign tags to conversations, and filter conversation history by tag_ids.
• Conversation list filters: Added exclude_statuses to list conversations, allowing clients to hide conversations with statuses such as initiated, in-progress, processing, done, or failed.
• Model options: Added claude-opus-4-7, gpt-5.4, gpt-5.5, gpt-5.4-2026-03-05, gpt-5.5-2026-04-23, and qwen36-35b-a3b to the LLM enum.
• Contextual update metadata: Added contextual_update_info to conversation transcript response items. The field references ContextualUpdateInfo, which includes context_id and is_superseded, so clients can identify contextual updates and whether they have been replaced by later context.
• Batch calling filter: Added an optional agent_id query parameter to list workspace batch calling jobs, allowing clients to return jobs for a single agent.
• Test invocation listing: Made the agent_id query parameter optional and nullable on list test invocations, allowing clients to list test invocations without filtering by one agent. …

ElevenAgents

• agent_response_complete WebSocket event: A new agent_response_complete client event fires exactly once when an agent's response is fully delivered -- after all LLM generation, tool call chains, and audio playback complete. After this event, the agent will only produce further output if the user provides new input or a turn timeout triggers a new turn. The event lets clients reliably detect end of turn for batching messages, wake-word activation, or post-turn UI updates. Added a new AGENT_RESPONSE_COMPLETE value to the ClientEvent enum and a corresponding AgentResponseCompleteClientEvent response model.

• Pre-tool speech mode: Added a new pre_tool_speech field (PreToolSpeechMode enum, default auto) on MCP server configuration and per-tool overrides. Replaces the now-deprecated force_pre_tool_speech boolean. Values: auto decides whether the agent speaks before the tool call based on recent tool latency, force always asks the agent to speak, and off opts out entirely.

• Tool dispatch respects execution mode: Workflow tool dispatch nodes now correctly respect each nested tool's execution_mode. If any tool in a dispatch node uses POST_TOOL_SPEECH, the workflow waits for the current turn's audio to be fully exposed before executing the dispatch. …

Developer Resources

• ElevenLabs Devs YouTube channel: A new developer-focused YouTube channel is now live, featuring tutorials, API walkthroughs, and technical deep dives to help you get the most out of the ElevenLabs platform.

ElevenAgents

• Workflow starting node override: Conversations can now be started at a specific workflow node by passing starting_workflow_node_id in the conversation initiation client data. This is gated by an opt-in enable_starting_workflow_node_id_from_client field in the agent's platform override settings. When enabled, clients can specify which node to begin a conversation at, which is useful for agent memory and longer-term WebSocket use cases. If the specified node does not exist, the conversation falls back to the default entry point.

• Post-call analysis LLM configuration: Agent platform settings now include an analysis_llm field (default: gemini-2.5-flash) that sets the default LLM for post-call analysis, including evaluation criteria and data collection. Individual data collection properties can override this default with a per-item llm field via the new AnalysisProperty schema, giving fine-grained control over which model processes each analysis item. …

ElevenAgents

• Conversation topic discovery: A new conversation topics endpoint (GET /v1/convai/agents/{agent_id}/topics) returns the latest topic discovery results for a given agent, surfacing recurring themes across conversations. The list conversations endpoint now accepts a topic_ids query parameter to filter conversations by discovered topic.

• Knowledge base content search: A new search knowledge base endpoint (GET /v1/convai/knowledge-base/search) provides fuzzy text search over knowledge base document content. Results include highlighted snippets with SearchHighlightSegment objects and support cursor-based pagination with configurable page sizes (up to 100, default 30). Filter by document type with the optional types parameter.

• Flexible branch merging: The merge branch endpoint no longer restricts merges to the main branch -- any branch can now be used as a merge target. A new optional force boolean parameter overrides timestamp-based conflict resolution when set to true. Branch metadata responses now include parent_branch_id and merged_from_version_id for better lineage tracking. …

ElevenAgents

• Scoped conversation analysis: Evaluation criteria and data collection items can now be scoped to conversation (full transcript) or agent (only the portion where a specific agent was active). Added scope field to PromptEvaluationCriteria, data_collection_scopes to agent platform settings, and a new scoped array of ScopedAnalysisResult on the conversation analysis response. This is particularly useful for multi-agent workflows where each agent should be evaluated independently.

• Agent test folder management: Tests can now be organized into folders. New endpoints for creating, retrieving, updating, and deleting test folders, plus bulk moving tests between folders.

• Tool and knowledge base overrides in workflows: Agent workflow node overrides now support tool_ids and knowledge_base fields in PromptAgentAPIModelOverrideConfig, allowing workflow nodes to control which tools and knowledge base documents each sub-agent can access. …

ElevenAgents

• MCP tool scoping in agent workflows: Agent workflow nodes can now restrict which MCP tools a sub-agent is permitted to call. When tool inheritance is disabled on a node, only the explicitly selected MCP tools are loaded for that sub-agent, giving teams precise control over tool access per workflow step.

• Conversation file uploads: The create agent and update agent endpoints now support a file_input field on ConversationConfig. When enabled, end users can attach images or PDFs in chat (requires an LLM with multimodal input support). Configurable with enabled (boolean) and max_files_per_conversation (integer).

• Re-run conversation analysis: New run conversation analysis endpoint (POST /v1/convai/conversations/{conversation_id}/analysis/run) re-evaluates a completed conversation using the agent's current evaluation criteria and data collection settings, without needing a new call.

• Tool response mocking for tests: Agent simulation tests and test suite invocations now support a tool_mock_config field to control how tool calls are handled during testing. Use MockingStrategy (all, selected, none) to choose which tools are mocked and MockNoMatchBehavior (call_real_tool, raise_error) to set the fallback when no mock matches. …

ElevenAgents

• Environment Variables API: New environment variables endpoints for managing workspace-level configuration that agents can reference at runtime via {{system_env__<label>}} templating. Supports string, secret, and auth-connection variable types with per-environment value overrides. Endpoints include create, list, get, and update.

• Auth Connections management: New workspace-level auth connections API for managing authentication credentials used by agent tools and integrations. Supports multiple auth methods including OAuth2 client credentials, JWT, basic auth, bearer tokens, custom headers, and integration-managed OAuth2 authorization code flows. Endpoints include create, list, and delete operations.

• Knowledge Base URL refresh: New refresh endpoint (POST /v1/convai/knowledge-base/{documentation_id}/refresh) to re-fetch and update content for URL-sourced knowledge base documents. Knowledge base documents also now support auto-sync configuration with enable_auto_sync, auto_remove, and auto_sync_info fields. …

ElevenAgents

• Users page is now generally available: The list users page, which groups conversations by a user identifier, is now available to all workspaces. This allows you to view all users who have interacted with your agents, their conversation history, and contact details in a unified view.

• SIP inbound headers as dynamic variables: Custom SIP X- headers from inbound SIP trunking calls are now automatically exposed as dynamic variables in ElevenAgents conversations. Any custom SIP header (e.g., X-Contact-ID, X-Campaign-ID) passed by the caller is available in the agent prompt using {{sip_contact_id}}, {{sip_campaign_id}}, etc. These variables are also visible in the conversation history under the Phone Call tab. Reserved headers such as X-Call-ID and X-Caller-ID continue to map to system__call_sid and system__caller_id and are not overridden.

• Conversation filtering by tool outcome: The list conversations and text search conversations endpoints now accept tool_names_successful and tool_names_errored query parameters (array of strings) to filter conversations by which tools succeeded or returned errors during the call. …

ElevenAgents

• New LLM options: Added claude-sonnet-4-6 and gemini-3.1-flash-lite-preview as supported LLM providers for agent conversation configuration.

• Guardrail execution mode: Custom guardrails now support a configurable execution_mode field with the GuardrailExecutionMode enum, and have separate input and output schema definitions. This allows more precise control over when guardrail logic runs and which message direction it applies to.

• Guardrail triggered client event: Added guardrail_triggered to the ClientEvent enum, enabling agent workflows and client-side handlers to respond when a guardrail fires during a conversation.

• Batch calling concurrency: Added target_concurrency_limit field to the submit batch call request body, allowing you to control the target number of concurrent calls for a given batch.

• Agent testing type filter: The list agent tests endpoint now accepts a types query parameter to filter results by test type. The include_folders query parameter is deprecated in favor of the new types filter. …

ElevenAgents

• New widget configuration options: Several new settings are now available for the ElevenAgents conversation widget in the agent dashboard:

  • Collapsible widget (widget.dismissible): Allow users to minimize or dismiss the widget during a conversation.
  • Action indicator (widget.show_agent_status): Display a visual indicator when the agent is actively using tools, with distinct states for working, done, and error. Enabling this setting automatically adds agent_tool_request and agent_tool_response to the agent's client events.
  • Conversation ID display (widget.show_conversation_id): Show the conversation ID to users after a call ends. Defaults to true for both new and existing agents.
  • Audio tag visibility (widget.strip_audio_tags): Hide audio tags from conversation transcripts. Defaults to true for both new and existing agents.
  • Syntax highlighting theme (widget.syntax_highlight_theme): Configure code block highlighting in transcripts. Accepts null (Auto), light, or dark. …

ElevenAgents

• OAuth and advanced authentication for MCP servers: MCP servers now support workspace auth connections, enabling OAuth2 Client Credentials, Basic Auth, Bearer Auth, JWT, and custom header authentication. Select an auth connection when creating or editing an MCP server to automatically handle token refresh and authentication headers. See the MCP server documentation for more details.
• LLM information endpoint: Added a new endpoint to list available LLMs with deprecation status, capabilities, and context limits. This enables clients to programmatically discover which models are available and which are being deprecated. See List Available LLMs for details.
• Conversation history redaction: Added support for redacting sensitive information from conversation transcripts, audio, and analysis before being stored. Configure specific entity types to redact (such as names, email addresses, etc.) using the new conversation_history_redaction setting in agent privacy configuration. See the docs page for more details.
• Enhanced guardrails: Introduced two new guardrail types for agents:
  • focus: Helps keep conversations on-topic
  • prompt_injection: Detects and prevents prompt injection attempts
  • Note: The alignment guardrail has been removed …

ElevenAgents

• Conversation users endpoint: Added Get conversation users endpoint (GET /v1/convai/users) to list users who have had conversations with your agents. Supports pagination and filtering by agent, time range, and other criteria.
• Agent versioning: Fetch specific agent configurations by version using the new version_id and branch_id query parameters on the Get agent endpoint. The Update agent endpoint also now accepts a branch_id parameter for branch-specific updates.
• Search documentation tool: Added search_documentation as a new built-in system tool for RAG (retrieval-augmented generation). Configure multi-source retrieval with MultiSourceConfigJson, SourceConfigJson, and SourceRetrievalConfig schemas. Supports configurable merging strategies via the MergingStrategy enum.
• MCP tool support: Added mcp as a new tool type alongside webhook, client, and system tools. Configure MCP tools using the new MCPToolConfig schema in your agent tool definitions.
• Content guardrails: Added content moderation guardrails to GuardrailsV1 with configurable thresholds for different content categories: sexual, violence, harassment, self-harm, profanity, religion/politics, and medical/legal content. Use the new ContentGuardrail and ContentConfig schemas. …

ElevenAgents, ElevenCreative and ElevenAPI

We’re moving from a single-product perception (“ElevenLabs”) to a platform-based structure with clearly defined product families:

• ElevenAgents (Formerly Agents Platform)
• ElevenCreative (Formerly Creative Platform)
• ElevenAPI (New, the Developer Platform)

You'll already see this reflected in the docs and SDK readmes.

Global servers out of beta

Global routing is now the default rather than opt-in.

Previously the default ElevenLabs API server was located in the United States, with an opt-in beta for routing traffic through the Netherlands or Singapore based servers. As of now global routing is the default, meaning that the server will automatically be chosen based on geographic proximity to optimize latency.

The opt-in base URL api-global-preview.elevenlabs.io is now deprecated, please use the default api.elevenlabs.io base URL instead. If you're using the SDKs, this is already the default.

Text to Speech

• TTS Normalizer v3.1: Upgraded the text normalizer to version 3.1, which includes improved accuracy and lower latency for text-to-speech conversion.

Agents Platform …

Eleven v3

v3 is out of alpha - it's more stable, accurate and has lower latency. Read more about Eleven v3.

Text-to-Dialogue

• WAV output formats: Text-to-Dialogue endpoints now support WAV output formats (wav_8000, wav_16000, wav_22050, wav_24000, wav_32000, wav_44100, wav_48000) in addition to existing MP3, PCM, OPUS, and other formats. WAV formats with 44.1kHz sample rate require a Pro tier subscription or above.

Agents Platform

• Agent branch renaming: You can now rename agent branches using the Update branch endpoint. The new optional name field accepts 1-140 characters.
• Alignment guardrails: Added AlignmentGuardrail type to GuardrailsV1 schema for enhanced conversation safety controls.
• Speculative turn configuration: Added speculative_turn field to turn configuration for fine-tuning agent turn-taking behavior.
• Procedure references: Agent patch requests now support procedure_refs for referencing reusable procedures.
• Webhook response filtering: Added response_filter_mode and response_filters fields to webhook overrides, with new ResponseFilterMode enum for controlling which response data is passed through.
• Error details in tool events: Added raw_error_message field to API integration webhook, system, and workflow tool event models for improved debugging. …