Changelog

March 2, 2026

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.

  • Folder-aware agent testing: The List agent tests endpoint now supports organizing tests into folders. Added parent_folder_id, include_folders, and sort_mode query parameters for filtered listing. Test creation and update endpoints accept parent_folder_id to assign tests to folders, and test summaries now include entity type, parent folder path, and children count.

  • Workflow say node: Added a new say node type to agent workflows (WorkflowSayNodeModel). This node supports conversation_config, additional_prompt, and tool and knowledge base overrides. The node’s message payload uses a discriminated union with two variants: literal (static text via text) and prompt (LLM-generated via prompt).

  • SMB tool configuration: Formalized the SMBToolConfig schema with a required, discriminated params object. Supported operation types are create, list, search, update, and delete, each applicable to SMB entity categories including clients, staff, services, products, and assets.

  • Summary language for agents: Added summary_language field to agent configuration to specify the language for post-conversation summaries.

  • Twilio call recording: Added optional call_recording_enabled field to the Twilio outbound call request body to enable recording of outbound calls.

  • WhatsApp messaging flag: Added enable_messaging flag to WhatsApp account models and update requests to control whether messaging is enabled for a given phone number.

Pronunciation Dictionaries

  • Set all rules at once: New Set rules endpoint (POST /v1/pronunciation-dictionaries/{pronunciation_dictionary_id}/set-rules) replaces all existing rules in a pronunciation dictionary in a single call, as an alternative to incrementally adding or removing individual rules.

  • Rule matching options: Added case_sensitive (boolean) and word_boundaries (boolean) fields to pronunciation dictionary rule definitions for more precise control over how rules match text.

Music

  • Upload audio: New Upload music endpoint (POST /v1/music/upload) accepts a multipart/form-data request with an audio file. Optionally extracts a composition plan from the uploaded audio and returns a MusicUploadResponse with a song_id.

  • Phonetic name support: Added use_phonetic_names parameter to Generate music, Generate music detailed, and Stream music endpoints.

  • Song ID in responses: Music generation responses now surface the song_id field, making it easier to reference generated songs in subsequent API calls.

Audio Native

  • Update project content from URL: New Update content endpoint (POST /v1/audio-native/content) allows updating an AudioNative project by providing a URL. The endpoint extracts the content from the URL and queues it for conversion and auto-publishing.

Voices

  • Voice bookmarking: Added bookmarked field to voice update requests and is_bookmarked to voice response objects, enabling users to bookmark voices for easy access.

SDK Releases

JavaScript SDK

  • v2.37.0 - Added support for surfacing song_id in music generation responses. Updated to include latest API schema changes from Fern regeneration.

Python SDK

  • v2.37.0 - Added support for new music generation parameters and surfacing song_id in music generation responses. Updated to include latest API schema changes from Fern regeneration.

Packages

  • @elevenlabs/convai-widget-core@0.10.0 - Propagated event_id through transcript and streaming callbacks. Refactored tool status tracking from Map-based to inline transcript entries with a display-transcript utility. Added show-conversation-id config option (boolean, defaults to true) to control visibility of conversation ID in disconnection messages.
  • @elevenlabs/convai-widget-embed@0.10.0 - Propagated event_id through transcript and streaming callbacks. Refactored tool status tracking to inline transcript entries.
  • @elevenlabs/types@0.6.0 - Propagated event_id through transcript and streaming callbacks.

API

New Endpoints

  • Set pronunciation dictionary rules - POST /v1/pronunciation-dictionaries/{pronunciation_dictionary_id}/set-rules - Replace all rules in a pronunciation dictionary in a single call
  • Upload music - POST /v1/music/upload - Upload an audio file to create or reference a song, optionally extracting a composition plan
  • Update Audio Native content from URL - POST /v1/audio-native/content - Update an AudioNative project by extracting content from a provided URL and queuing for conversion

Updated Endpoints

ElevenAgents

  • List agent tests

    • Added parent_folder_id query parameter (string, optional) to filter tests by folder
    • Added include_folders query parameter (boolean, optional) to include folder objects in results
    • Added sort_mode query parameter (string, optional) to control result ordering
    • Response now includes folder metadata: entity type, parent path, and children count on UnitTestSummaryResponseModel

  • Create agent test, Update agent test

    • Added parent_folder_id field (string, optional) for assigning a test to a folder

  • Create agent, Update agent, Get agent

    • Added summary_language field (string, optional) to agent configuration for post-conversation summary language
    • Added widget.dismissible (boolean) - allow users to collapse or dismiss the widget
    • Added widget.show_agent_status (boolean) - display tool usage status indicator in widget
    • Added widget.show_conversation_id (boolean) - show conversation ID after call ends; defaults to true
    • Added widget.strip_audio_tags (boolean) - hide audio tags from transcripts; defaults to true
    • Added widget.syntax_highlight_theme (string, nullable) - code block highlighting theme (null, light, or dark)
    • Added new workflow node type say with WorkflowSayNodeModel schema, including conversation_config, additional_prompt, and tool/knowledge base overrides; message payload supports literal and prompt discriminated variants

  • Twilio outbound call

    • Added call_recording_enabled field (boolean, optional) to enable recording of outbound Twilio calls

  • Update WhatsApp account

    • Added enable_messaging field (boolean, optional) to enable or disable messaging for the account

  • Update webhook

    • Added schema_overrides field (object, optional) for customizing webhook payload schema

Pronunciation Dictionaries

Music

Voices

Schema Changes

New Schemas

  • WorkflowSayNodeModel - Workflow node for agent say operations with conversation config, prompts, and tool overrides
  • WorkflowSayNodeMessageLiteral - Literal (static text) message payload for say nodes
  • WorkflowSayNodeMessagePrompt - Prompt-based (LLM-generated) message payload for say nodes
  • MusicUploadResponse - Response model for music upload including song_id
  • SMBToolConfigCreateClientParams, SMBToolConfigListClientsParams, SMBToolConfigSearchClientsParams, SMBToolConfigUpdateClientParams, SMBToolConfigDeleteClientParams - Discriminated parameter types for SMB tool operations

Modified Schemas

  • AgentConfig - Added summary_language field
  • WidgetConfigV2 - Added dismissible, show_agent_status, show_conversation_id, strip_audio_tags, and syntax_highlight_theme fields
  • SMBToolConfig - params field is now required and uses a discriminated union
  • PronunciationDictionaryRule - Added case_sensitive and word_boundaries fields
  • CustomGuardrailConfig - model field is now optional with a default value
  • UnitTestSummaryResponseModel - Added folder metadata fields: entity type, parent path, children count
February 23, 2026

February 23, 2026

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
  • Conversation search endpoints: Added two new endpoints for searching conversation messages:
    • Text search - Full-text and fuzzy search over transcript messages
    • Smart search - Semantic search using embeddings
  • File uploads in conversations: Added endpoints to upload and manage files within conversations:
  • New embedding model: Added support for qwen3_embedding_4b embedding model in knowledge base RAG indexing.

Workspaces

  • Image and video generation permission: Workspace administrators can now control access to image and video generation features. This new permission allows you to restrict which workspace members can use these capabilities. Configure this in your workspace settings under member permissions.

Music

  • Workspace sharing: Songs can now be shared within workspaces. The songs resource type has been added to workspace resource sharing endpoints.

SDK Releases

JavaScript SDK

  • v2.36.0 - Added overloaded convert method signatures to Speech to Text wrapper for improved type safety and ergonomics. Updated SDK to include latest API schema changes including LLM list endpoint, conversation search, and MCP auth connection support.

Python SDK

  • v2.36.1 - Added missing music generation parameters including seed, loudness, quality, and guidance_scale to ensure full feature parity with the API.
  • v2.36.0 - Renamed package references from “Conversational AI” to “ElevenAgents” to reflect the product rebrand. Updated SDK to include latest API schema changes including LLM list endpoint, conversation search, and MCP auth connection support.

Packages

API

New Endpoints

  • Text search conversation messages - GET /v1/convai/conversations/messages/text-search - Perform full-text or fuzzy search over conversation transcript messages
  • Smart search conversation messages - GET /v1/convai/conversations/messages/smart-search - Perform semantic search over conversation messages using embeddings
  • List available LLMs - GET /v1/convai/llm/list - Retrieve available LLMs with deprecation information, capabilities, and context limits
  • Upload file to conversation - POST /v1/convai/conversations/{conversation_id}/files - Upload files to a conversation context
  • Delete conversation file - DELETE /v1/convai/conversations/{conversation_id}/files/{file_id} - Remove an uploaded file from a conversation

Removed Endpoints

The following legacy voice generation endpoints have been removed:

  • GET /v1/voice-generation/generate-voice/parameters - Voice Generation Parameters
  • POST /v1/voice-generation/generate-voice - Generate A Random Voice
  • POST /v1/voice-generation/create-voice - Create A Previously Generated Voice

Use the Voice Design and Voice Remix endpoints instead.

Updated Endpoints

ElevenAgents

  • Create agent, Update agent, Get agent

    • Added coaching_settings field for agent training configuration
    • Added conversation_history_redaction in platform_settings.privacy with configurable entity types
    • Added new guardrails: focus and prompt_injection in platform_settings.guardrails
    • Removed alignment guardrail from platform_settings.guardrails
    • Added qwen3_embedding_4b as an embedding model option in RAG configuration
    • Updated numeric field descriptions for better clarity on ranges and defaults

  • Create MCP server, Update MCP server, Get MCP server

    • Added auth_connection field (optional) to enable OAuth and advanced authentication methods
    • Added secret_token field to PATCH endpoint for backward compatibility
    • Auth connection takes precedence over secret_token when both are provided

  • Create MCP tool config, Update MCP tool config, Get MCP tool config

    • Added input_overrides field - allows overriding tool input parameters with constants, dynamic variables, or LLM-generated values

  • Create RAG index, Delete RAG index

    • Added qwen3_embedding_4b to the embedding_model enum

  • Get conversations

    • Deprecated search query parameter (use the new dedicated search endpoints instead)

  • Get conversation

    • Added hiding_reason field to indicate why a conversation might be hidden
    • Extended conversation transcript entries to support file_input metadata with new ChatSourceMedium type (audio, text, image, file)

  • Simulate conversation, Simulate conversation stream

    • Updated all nested configuration fields with improved descriptions and validation ranges

  • Get agent branches, Update agent branch

    • Updated current_live_percentage field description for clarity

  • Get ElevenAgents settings, Update ElevenAgents settings

    • Updated rag_retention_period_days field with improved description

Workspaces

Music

  • Generate music, Generate music detailed, Stream music
    • Clarified seed parameter description: Random seed for music generation initialization. Providing the same seed with identical parameters helps achieve more consistent results, but exact reproducibility is not guaranteed and outputs may change across system updates. Cannot be used with prompt parameter.

Text to Voice

  • Create voice previews, Design voice, Remix voice
    • Updated loudness parameter description: Controls the volume level of the generated voice. -1 is quietest, 1 is loudest, 0 corresponds to roughly -24 LUFS
    • Updated guidance_scale parameter description: Controls how closely the AI follows the prompt. Lower numbers give the AI more freedom to be creative, while higher numbers force it to stick more to the prompt. High numbers can cause voice to sound artificial or robotic. Longer, more detailed prompts work better at lower guidance scale.
    • Updated quality parameter description for voice preview creation

Voices

  • Get voices, Get voice settings, Get default voice settings, Edit voice settings
    • Updated style parameter description: Determines the style exaggeration of the voice. Attempts to amplify the style of the original speaker. Consumes additional computational resources and might increase latency if set to anything other than 0
    • Updated speed parameter description: Adjusts the speed of the voice. 1.0 is default, values less than 1.0 slow down speech, values greater than 1.0 speed it up
February 16, 2026

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.
  • Expressive mode: Added expressive_mode field (boolean) to agent configuration schemas to automatically prompt your agent to make the most of the new v3 conversational model.
  • Post-dial digits: Phone number transfers now support post_dial_digits for sending DTMF tones after connection. Configurable as static values or dynamic variables.
  • Agent testing types: Agent testing now supports three distinct test types with dedicated schemas: llm (response evaluation), tool (tool-call verification), and simulation (full conversation simulation). Simulation tests include simulation_scenario and simulation_max_turns configuration fields.

Pronunciation Dictionaries

  • Rules in API response: The Get pronunciation dictionary endpoint now returns a rules array containing full rule details. Response uses the new GetPronunciationDictionaryWithRulesResponseModel schema with PronunciationDictionaryAliasRuleResponseModel and PronunciationDictionaryPhonemeRuleResponseModel for rule types.

Knowledge Base

  • Folder deletion: The Delete knowledge base document endpoint now supports deleting folders in addition to documents. When deleting folders, set force=true to enable recursive deletion of all contained documents and subfolders.

SDK Releases

Python SDK

  • v2.36.0 - Added conversation users endpoint, agent versioning, search documentation tool, MCP tool support, content guardrails, and agent testing types

JavaScript SDK

  • v2.36.0 - Added overloaded convert signatures to speechToText.convert() for improved type inference based on request parameters (access .text, .transcripts, or webhook fields without manual type narrowing), added conversation users endpoint, agent versioning, search documentation tool, MCP tool support, content guardrails, and agent testing types

Widget Packages

  • @elevenlabs/convai-widget-core@0.9.0 - Added agent tool usage status display and new status badge for long-running tool calls, fixed emotion tag stripping, fixed rating and feedback submission for signed-url widget embedding
  • @elevenlabs/convai-widget-embed@0.9.0 - Added agent tool usage status display and new status badge for long-running tool calls, fixed emotion tag stripping

API

New Endpoints

Updated Endpoints

ElevenAgents

  • Get agent
    • Added version_id query parameter (string, optional) for fetching a specific agent version
    • Added branch_id query parameter (string, optional) for fetching from a specific branch
  • Update agent
    • Added branch_id query parameter (string, optional) for branch-specific updates
  • Create agent
    • Added search_documentation to system tools with multi-source RAG configuration
    • Added mcp tool type to tool discriminator
    • Added content field to GuardrailsV1 for content moderation guardrails
    • Added expressive_mode field (boolean) to agent configuration
  • Create agent test, Update agent test, Get agent test
    • Changed to discriminated union schemas with type field (llm, tool, simulation)
    • Added simulation_scenario and simulation_max_turns fields for simulation tests

Pronunciation Dictionaries

Knowledge Base

Schema Changes

New Schemas

  • GetPronunciationDictionaryWithRulesResponseModel - Response model with embedded rules array
  • PronunciationDictionaryAliasRuleResponseModel - Alias rule with string_to_replace and alias
  • PronunciationDictionaryPhonemeRuleResponseModel - Phoneme rule with string_to_replace, phoneme, and alphabet
  • MultiSourceConfigJson - Multi-source RAG configuration
  • SourceConfigJson - Individual source configuration for RAG
  • SourceRetrievalConfig - Retrieval configuration for RAG sources
  • MergingStrategy - Enum for RAG result merging strategies
  • MCPToolConfig - Configuration for MCP tools
  • ContentGuardrail-Input, ContentGuardrail-Output - Content moderation guardrail configuration
  • ContentConfig - Content category thresholds configuration
  • TestType - Enum with values llm, tool, simulation
  • CreateAgentTestResponseModel - Response for test creation
  • LLMResponseTest*, ToolCallTest*, SimulationTest* - Per-type test schemas replacing legacy Create/Get/UpdateUnitTest* models

Modified Schemas

  • GuardrailsV1-Input, GuardrailsV1-Output - Added content field for content guardrails
  • AgentConfig - Added expressive_mode field (boolean)
  • PhoneNumberTransferConfig - Added post_dial_digits field (string or dynamic variable)
  • DistributionTerritories - Relaxed items constraint to allow arbitrary territory strings
February 9, 2026

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

  • Custom guardrails: Added support for user-defined output guardrails that allow you to create custom content filtering rules beyond standard moderation. Configure guardrails with a name, prompt instruction (up to 10,000 characters), and choice of evaluation model (gemini-2.5-flash-lite or gemini-2.0-flash). When triggered, the guardrail ends the conversation. See the Create agent API reference for configuration details.
  • WhatsApp outbound messaging: Added Send outbound message endpoint (POST /v1/convai/whatsapp/outbound-message) to initiate conversations via WhatsApp using message templates. Required fields include whatsapp_phone_number_id, whatsapp_user_id, template_name, template_language_code, template_params, and agent_id.
  • Eleven v3 conversational model: Added eleven_v3_conversational to the available TTS models for agents, providing improved voice quality and expressiveness in agent conversations.
  • Suggested audio tags: Added suggested_audio_tags field to TTS configuration for agents using v3 models. Define up to 20 tags (e.g., “happy”, “excited”) to guide expressive speech generation, with optional descriptions for when each tag should be used.
  • Tool error handling: Added tool_error_handling_mode field to webhook tool configurations with options: auto (default, determines handling based on tool type), summarized (sends LLM-generated summary), passthrough (sends raw error), or hide (does not share error with agent).
  • Dynamic variable sanitization: Added sanitize field (boolean, default false) to DynamicVariableAssignment. When enabled, the assignment value is removed from tool responses and transcripts while still being processed for variable assignment.
  • Turn model selection: Added TurnModel enum with turn_v2 and turn_v3 options for selecting the turn detection model version.
  • Workflow node transfers: Added is_workflow_node_transfer field (boolean, default false) to AgentTransfer schema for identifying transfers within workflow nodes.
  • Transfer branch metadata: Added TransferBranchInfoTrafficSplit and TransferBranchInfoDefaultingToMain schemas for tracking branch routing information in agent transfers.
  • Workflow node transition testing: Added workflow_node_transition assertion type for unit tests with UnitTestWorkflowNodeTransitionEvaluationNodeId schema to validate agent workflow transitions.

Studio

  • Muted tracks endpoint: Added Get project muted tracks endpoint (GET /v1/studio/projects/{project_id}/muted-tracks) that returns a list of chapter IDs with muted tracks in a project.

Workspaces

  • Lite member seat type: Added workspace_lite_member to the SeatType enum for workspaces with limited access permissions.
  • Content templates resource: Added content_templates to WorkspaceResourceType enum for sharing content templates within workspaces.

User Interface

  • Voice collection scrolling: Fixed an issue preventing mouse wheel and touch scrolling in the voice collection icon picker on macOS.

SDK Releases

Python SDK

  • v2.35.0 - Added custom guardrails, WhatsApp outbound messaging, tool error handling mode, dynamic variable sanitization, turn model selection, and Eleven v3 conversational model support

JavaScript SDK

  • v2.35.0 - Added custom guardrails, WhatsApp outbound messaging, tool error handling mode, dynamic variable sanitization, turn model selection, and Eleven v3 conversational model support

React and Client SDKs

API

New Endpoints

Updated Endpoints

Agents Platform

  • Create agent, Update agent, Get agent
    • Added custom field to GuardrailsV1 schema for custom guardrails configuration
    • Added alignment field to GuardrailsV1 schema for alignment guardrails
    • Added suggested_audio_tags field to TTS conversational config (array of SuggestedAudioTag, max 20 items)
    • Added eleven_v3_conversational to TTSConversationalModel enum
  • Create tool, Update tool
    • Added tool_error_handling_mode field to ApiIntegrationWebhookToolConfig (enum: auto, summarized, passthrough, hide, default auto)
    • Added sanitize field to DynamicVariableAssignment (boolean, default false)

Workspaces

Schema Changes

New Schemas

  • CustomGuardrail-Input, CustomGuardrail-Output - Container for custom guardrails configuration
  • CustomGuardrailsConfig - Config container for custom guardrails list
  • CustomGuardrailConfig - Single custom guardrail with name (string, required), prompt (string, required, max 10,000 chars), model (enum: gemini-2.5-flash-lite, gemini-2.0-flash, required), and is_enabled (boolean, default false)
  • ToolErrorHandlingMode - Enum for tool error handling: auto, summarized, passthrough, hide
  • TurnModel - Enum for turn detection model version: turn_v2, turn_v3
  • SuggestedAudioTag - Audio tag configuration with tag (string, required, max 30 chars) and description (string, optional, max 200 chars)
  • TransferBranchInfoTrafficSplit - Branch info for traffic split transfers with branch_id and traffic_percentage
  • TransferBranchInfoDefaultingToMain - Branch info for default-to-main transfers with branch_id
  • UnitTestWorkflowNodeTransitionEvaluationNodeId - Workflow node transition test configuration with agent_id and target_node_id
  • ProjectMutedTracksResponseModel - Response model with chapter_ids array
  • WhatsAppOutboundMessageResponse - Response for WhatsApp outbound message endpoint
  • WhatsAppTemplateHeaderComponentParams, WhatsAppTemplateBodyComponentParams, WhatsAppTemplateButtonComponentParams - Template parameter schemas for WhatsApp messages
  • ConversationHistoryTranscriptSystemToolResultCommonModel-Input, ConversationHistoryTranscriptSystemToolResultCommonModel-Output - Split system tool result models for input/output variants

Modified Schemas

  • GuardrailsV1-Input, GuardrailsV1-Output - Added custom (CustomGuardrail) and alignment (AlignmentGuardrail) fields
  • TTSConversationalConfig-Input, TTSConversationalConfig-Output - Added suggested_audio_tags field
  • TTSConversationalModel - Added eleven_v3_conversational enum value
  • ApiIntegrationWebhookToolConfig-Input, ApiIntegrationWebhookToolConfig-Output - Added tool_error_handling_mode field (required)
  • DynamicVariableAssignment - Added sanitize field (boolean, default false)
  • AgentTransfer - Added is_workflow_node_transfer field (boolean, default false)
  • SeatType - Added workspace_lite_member enum value
  • WorkspaceResourceType - Added content_templates enum value

Removed Schemas

  • AgentBan - Removed unused schema
  • BanReasonType - Removed unused enum
  • DubbingReleaseChannel - Removed unused enum
February 2, 2026

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.
  • Flexible tool call matching: Testing models now include check_any_tool_matches option to relax tool call matching requirements during agent testing.
  • Secrets pagination: Get workspace secrets endpoint now supports pagination with page_size (max 100) and cursor query parameters, returning next_cursor and has_more in responses.

Workspaces

  • Permission clarifications: Workspace group and invite endpoints now document specific permission requirements (group_members_manage for group member operations, WORKSPACE_MEMBERS_INVITE for workspace invitations) instead of requiring workspace administrator status.
  • New permission types: Added group_members_manage and terms_of_service_accept to the PermissionType enum.

User

  • Compliance terms visibility: Added show_compliance_terms field to user response model.

Metrics

  • ASR provider tracking: Added convai_asr_provider field to metrics for tracking automatic speech recognition provider usage.

SDK Releases

Python SDK

  • v2.34.0 - Added WAV output formats for Text-to-Dialogue, webhook response filtering, agent branch renaming, secrets pagination, and speculative turn configuration
  • v2.33.1 - Fixed bug with URL streaming in Scribe
  • v2.33.0 - Fixed bug with agent initialization and user_id handling, added audio alignment callback for agent conversations

JavaScript SDK

  • v2.34.0 - Added WAV output formats for Text-to-Dialogue, webhook response filtering, agent branch renaming, secrets pagination, and speculative turn configuration

React and Client SDKs

Widget Packages

API

Updated Endpoints

Text-to-Dialogue

  • Text to Dialogue, Text to Dialogue with timestamps
    • Added WAV output formats to output_format parameter: wav_8000, wav_16000, wav_22050, wav_24000, wav_32000, wav_44100, wav_48000
    • Updated description to clarify that WAV formats with 44.1kHz sample rate require Pro tier subscription
    • Added NonStreamingOutputFormats schema reference for non-streaming endpoints

Agents Platform

  • Update agent branch
    • Added optional name field (string, 1-140 characters, nullable) for renaming branches
  • Get workspace secrets
    • Added page_size query parameter (integer, optional, max 100) for pagination
    • Added cursor query parameter (string, optional) for fetching next page
    • Response now includes next_cursor (string) and has_more (boolean) fields
  • Create agent, Update agent
    • Added speculative_turn field to turn configuration
    • Added procedure_refs field to agent patch schema
    • Added AlignmentGuardrail to GuardrailsV1 schema
    • Added response_filter_mode and response_filters to webhook overrides
  • Create agent test, Update agent test
    • Added check_any_tool_matches field (boolean, optional) for relaxed tool call matching

Workspaces

User

  • Get user info
    • Added show_compliance_terms field (boolean) to response

Schema Changes

New Schemas

  • NonStreamingOutputFormats - Enum for non-streaming audio output formats including WAV variants
  • ResponseFilterMode - Enum for webhook response filtering modes
  • AlignmentGuardrail - Configuration for alignment-based conversation guardrails

Modified Schemas

  • SongMetadata - Removed bpm and time_signature fields
  • PermissionType - Added group_members_manage and terms_of_service_accept enum values
  • TurnConfig - Added speculative_turn field
  • GetWorkspaceSecretsResponseModel - Added next_cursor and has_more pagination fields
  • UserResponseModel - Added show_compliance_terms field
  • WebhookToolApiConfigOutput - Added response_filter_mode and response_filters fields
  • AgentTestingCriteriaEvaluateToolCall - Added check_any_tool_matches field
  • Multiple tool event models (ApiIntegrationWebhookToolEventModel, SystemToolEventModel, WorkflowToolEventModel) - Added raw_error_message field
January 26, 2026

Agents Platform

  • Agent branching and deployments: Added a complete version control system for agents, enabling teams to create branches, iterate on agent configurations in isolation, and merge changes when ready. New endpoints include POST /v1/convai/agents/{agent_id}/branches for creating branches, POST /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge for merging, and POST /v1/convai/agents/{agent_id}/deployments for creating deployments. Drafts can also be created and deleted via the new drafts endpoints. See the Branches and Deployments documentation for details.
  • WhatsApp account management: Added PATCH and DELETE endpoints for WhatsApp Business accounts, allowing you to update and remove connected WhatsApp accounts from agents.
  • Conversation agent name: The Get conversation endpoint now returns agent_name in the response for easier identification of which agent handled a conversation.
  • Error type tracking: Added error_type field to conversation event models for improved debugging and error categorization.

Knowledge Base

  • Folder management: Added support for organizing knowledge base documents into folders. New endpoints include Create folder for creating folders, Move document for moving single documents, and Bulk move for moving multiple documents at once.

Tools

  • Enhanced tools listing: The Get tools endpoint now supports filtering and pagination with new query parameters including search, page_size, types, sort_by, sort_direction, and cursor. Response now includes next_cursor and has_more fields for pagination.

Music

  • Song metadata enhancements: Added bpm and time_signature fields to song metadata for richer audio analysis information.

Studio

  • Caption style templates: Added caption_style_template_overrides field to project models, allowing customization of caption styling per template.
  • Video dubbing project type: Added dub_video to the project creation type enum.
  • Publishing metadata: Added last_updated_from_project_unix timestamp to publishing and project metadata.

Workspaces

  • Seat type management: Introduced new SeatType enum with seat_type and workspace_seat_type fields, deprecating the previous workspace_permission and workspace_role fields.
  • Workspace analytics permission: Added workspace_analytics_full_read to the PermissionType enum for granular analytics access control.

SDK Releases

Python SDK

  • v2.32.0 - Added agent branching, deployments, and drafts endpoints, knowledge base folder management, enhanced tools listing with filtering and pagination, and seat type management

JavaScript SDK

  • v2.33.0 - Added agent branching, deployments, and drafts endpoints, knowledge base folder management, enhanced tools listing with filtering and pagination, and seat type management

API

New Endpoints

  • List agent branches - GET /v1/convai/agents/{agent_id}/branches - List all branches for an agent
  • Create agent branch - POST /v1/convai/agents/{agent_id}/branches - Create a new branch for an agent
  • Get agent branch - GET /v1/convai/agents/{agent_id}/branches/{branch_id} - Get a specific branch
  • Update agent branch - PATCH /v1/convai/agents/{agent_id}/branches/{branch_id} - Update branch configuration
  • Merge agent branch - POST /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge - Merge a branch into a target branch
  • Create deployment - POST /v1/convai/agents/{agent_id}/deployments - Create or update agent deployments
  • Create draft - POST /v1/convai/agents/{agent_id}/drafts - Create an agent draft
  • Delete draft - DELETE /v1/convai/agents/{agent_id}/drafts - Delete an agent draft
  • Create folder - POST /v1/convai/knowledge-base/folder - Create a folder for grouping documents
  • Move document - POST /v1/convai/knowledge-base/{document_id}/move - Move a document to a folder
  • Bulk move - POST /v1/convai/knowledge-base/bulk-move - Move multiple documents to a folder

Updated Endpoints

Agents Platform

  • Get tools
    • Added search query parameter (string, optional) for filtering tools by name prefix
    • Added page_size query parameter (integer, optional, max 100, default 30)
    • Added show_only_owned_documents query parameter (boolean, optional, default false)
    • Added types query parameter (array, optional) for filtering by tool type
    • Added sort_by query parameter (enum, optional) for sorting results
    • Added sort_direction query parameter (enum, optional) for sort order
    • Added cursor query parameter (string, optional) for pagination
    • Response now includes next_cursor (string) and has_more (boolean, required) fields
  • Create agent
    • Request schema updated with branching support
  • Get conversation
    • Added agent_name (string, optional) to response model
  • Create agent draft
    • Made tags field optional and removed from required fields

Pronunciation Dictionaries

  • Add rules
    • Updated description to clarify that rules with duplicate string_to_replace values will be replaced

Workspaces

Studio

  • Create project
    • Added create_publishing_read (boolean, optional) field
    • Added dub_video to project type enum
  • Get project, Update project
    • Added caption_style_template_overrides (object, optional) for custom caption styling

Schema Changes

New Schemas

  • AgentBranch, AgentBranchInput, AgentBranchOutput - Branch configuration for agents
  • AgentDeployment, AgentDeploymentInput - Deployment configuration for agents
  • AgentVersion - Agent version information
  • BranchProtectionStatus - Branch protection settings
  • SeatType - Enum for workspace seat types
  • ToolSortBy - Enum for tools sorting options
  • ToolTypeFilter - Enum for filtering tools by type
  • CaptionStyleModel - Caption style configuration

Modified Schemas

  • ToolsResponseModel - Added next_cursor and has_more fields for pagination
  • SongMetadata - Added bpm (number) and time_signature (string) fields
  • GetConversationResponseModel - Added agent_name field
  • PermissionType - Added workspace_analytics_full_read enum value
  • ProjectCreationType - Added dub_video enum value
  • Multiple event models - Added error_type field for error categorization
January 19, 2026

Agents Platform

  • Agent summaries endpoint: Added GET /v1/convai/agents/summaries endpoint for retrieving lightweight summaries of all agents in your workspace. This is useful for building agent selection interfaces without fetching full agent configurations.
  • Delete batch calls: Added DELETE /v1/convai/batch-calling/{batch_id} endpoint for removing batch call jobs that are no longer needed.
  • Branch filtering for conversations: Added optional branch_id query parameter to conversation endpoints including GET /v1/convai/conversation/get-signed-url, GET /v1/convai/conversation/token, and GET /v1/convai/conversations for filtering conversations by agent version branch.
  • Spelling patience configuration: Added spelling_patience setting to turn configuration with values auto, low, medium, and high. Controls how long the agent waits before assuming the user has finished spelling something out character by character.
  • Custom SIP headers for transfers: Added support for custom SIP headers when transferring calls via REFER. Configure custom_sip_headers arrays on phone number transfer configurations and workflow phone nodes for advanced telephony integrations.
  • WhatsApp accounts on agents: Agent responses now include whatsapp_accounts array for viewing connected WhatsApp Business accounts.
  • Zendesk integration support: Added zendesk_integration to the ConversationInitiationSource enum for conversations initiated through Zendesk.

Audio Output Formats

  • Expanded format options: Audio generation endpoints now support additional output formats including WAV family variants, new OPUS bitrate options, alaw_8000 for telephony, and ultra_lossless quality preset. This applies to Text-to-Speech, Text-to-Dialogue, Sound Generation, Music, and Voice Design endpoints.

Dubbing

  • Expanded status values: Dubbing project status now includes additional states for more granular tracking of dubbing progress.
  • Source language: The source_language field is now always returned when fetching a dub’s metadata.

SDK Releases

Python SDK

  • v2.31.0 - Added agent summaries endpoint, delete batch call, branch filtering for conversations, spelling patience configuration, and expanded audio output formats
  • v2.30.0 - Added WhatsApp accounts on agents, Zendesk integration source, custom SIP headers for transfers, and standardized output format schema

JavaScript SDK

  • v2.32.0 - Added audio_format parameter support for Scribe WebSocket URI, agent summaries endpoint, delete batch call, and expanded audio output formats
  • v2.31.0 - Added WhatsApp accounts on agents, Zendesk integration source, custom SIP headers for transfers, and standardized output format schema

React and Client SDKs

  • @elevenlabs/react@0.13.0 - Added conversation initiation overrides, audio alignment event support, WebSocket close code exposure on connection errors, and fixed Firefox AudioContext issue with useScribe hook
  • @elevenlabs/client@0.13.0 - Added conversation initiation overrides, audio alignment event support, and improved Scribe cleanup and disconnect handling

Widget Packages

API

New Endpoints

  • Get agent summaries - GET /v1/convai/agents/summaries - Retrieve lightweight summaries of all agents
  • Delete batch call - DELETE /v1/convai/batch-calling/{batch_id} - Remove a batch call job

Updated Endpoints

Agents Platform

Voice Management

Audio Generation

Speech to Text

Dubbing

  • Get dubbing project
    • Expanded status enum with additional progress states
    • Added source_language (string, required) to dubbing models

Knowledge Base

Schema Changes

New Schemas

  • CustomSIPHeader - Configuration for custom SIP headers on call transfers
  • SpellingPatience - Enum for spelling patience settings (auto, low, medium, high)
  • AllowedOutputFormats - Centralized enum for audio output format options

Modified Schemas

  • ConversationInitiationSource - Added zendesk_integration enum value
  • PermissionType - Centralized permission enum with new permissions including voice library publishing and user API key creation
  • PhoneNumberTransfer - Added custom_sip_headers array
  • TurnConfig - Added spelling_patience field
January 12, 2026

Scribe v2

We launched Scribe v2, the new state of the art transcription model. Learn more about Scribe v2 in the docs.

Agents Platform

  • Timezone support for batch call scheduling: You can now select a timezone when scheduling batch calls. The scheduled time is converted to UTC based on your chosen timezone. Your browser’s timezone is automatically selected by default, and validation prevents scheduling calls for times that have already passed in the selected timezone. This makes it easier to schedule outbound calls for the right time in your recipients’ time zones.
  • Knowledge Base source file URL: Added a new endpoint to retrieve the original source file URL for knowledge base documents, enabling direct access to uploaded files.
  • LLM fallback cascade timeout: Added cascade_timeout_seconds configuration option for agent backup LLM configs, allowing control over how long to wait before cascading to the next LLM. Default is 8 seconds with an allowed range of 2-15 seconds.
  • Soft timeout LLM-generated messages: Added use_llm_generated_message option to soft timeout configuration. When enabled, the agent will generate a contextual message using the LLM instead of using a predefined message when soft timeout triggers.
  • Knowledge Base folder navigation: Knowledge Base document responses now include folder_path field showing the path segments from root to parent folder, making it easier to understand document hierarchy.
  • Conversation filtering by initiation source: The Get Conversations endpoint now supports filtering by conversation_initiation_source query parameter.

Dubbing

  • New transcript format endpoint: Added GET /v1/dubbing/{dubbing_id}/transcripts/{language_code}/format/{format_type} endpoint supporting srt, webvtt, and json output formats. The previous GET /v1/dubbing/{dubbing_id}/transcript/{language_code} endpoint is now deprecated.
  • Required filename for dubbed files: Knowledge Base file models now require a filename field.

Speech to Text

  • Entity detection: Added entity_detection option to Speech-to-Text requests. Accepts 'all', specific entity type strings, or an array of entity types. Detected entities are returned in a new entities response field using the DetectedEntity schema.
  • Keyterm prompting: Added keyterms array parameter to Speech-to-Text requests for biasing transcription toward specific terms or phrases.

SDK Releases

Python SDK

  • v2.29.0 - Added entity detection and keyterm prompting for Speech-to-Text, LLM cascade timeout configuration, soft timeout LLM message generation, and batch call timezone support
  • v2.28.0 - Added agent versioning fields, voice collection IDs, batch call enhancements, and phone number labels

JavaScript SDK

  • v2.30.0 - Added entity detection and keyterm prompting for Speech-to-Text, LLM cascade timeout configuration, soft timeout LLM message generation, and batch call timezone support
  • v2.29.0 - Added agent versioning fields, voice collection IDs, batch call enhancements, and phone number labels

MCP Server

  • v0.9.1 - Added Gemini Extension support, fixed path handling for non-absolute output_directory and missing base_path

API

New Endpoints

  • Get dubbing transcript with format - GET /v1/dubbing/{dubbing_id}/transcripts/{language_code}/format/{format_type} - Retrieve dubbing transcripts in SRT, WebVTT, or JSON format
  • Get knowledge base source file URL - GET /v1/convai/knowledge-base/{documentation_id}/source-file-url - Get the original source file URL for a knowledge base document

Deprecated Endpoints

  • GET /v1/dubbing/{dubbing_id}/transcript/{language_code} - Use the new format-specific endpoint instead

Updated Endpoints

Agents Platform

Knowledge Base

  • List knowledge base documents
    • Removed deprecated use_typesense query parameter
    • Added folder_path (array of path segments) to document response models
    • Added filename (string, required) to knowledge base file models

Speech to Text

  • Transcribe speech
    • Added keyterms (array of strings, optional) for biasing transcription toward specific terms
    • Added entity_detection (string, array, or 'all', optional) for detecting entities in transcribed text
    • Added entities (array of DetectedEntity, optional) to response model

Dubbing

  • Create dubbing project
    • Updated mode description to note that manual mode is experimental and not recommended for production use
January 5, 2026

Agents Platform

  • Conversation ID in Twilio/SIP webhooks: The conversation_id is now included in webhook payloads when fetching conversation initiation client data for Twilio, SIP, and WhatsApp integrations. This enables real-time monitoring without polling the API to retrieve conversation IDs.
  • Agent versioning fields: Agent response models now include version_id, branch_id, and main_branch_id fields (nullable strings) for tracking agent versions and branches.
  • Conversation version tracking: Added version_id field to conversation models to identify the agent version used for each conversation.
  • Batch call enhancements: The BatchCallRecipientStatus enum now includes dispatched status, and batch call responses include total_calls_finished field with improved defaults for tracking.

Voices

  • Collection IDs: Voice models now include a collection_ids field (array of strings, nullable) indicating which collections a voice belongs to.
  • Voice type filter expansion: The GET /v2/voices endpoint now supports saved as a voice_type filter value for retrieving non-default voices that have been added to a collection.

SDK Releases

Python SDK

  • v2.28.0 - Updated API schema with agent versioning fields, voice collection IDs, batch call enhancements, and phone number labels

JavaScript SDK

  • v2.29.0 - Updated API schema with agent versioning fields, voice collection IDs, batch call enhancements, and phone number labels

API

Updated Endpoints

Voices

  • Get all voices v2
    • Added saved option to voice_type query parameter for filtering voices added to collections

Agents Platform

  • Get agent, Update agent
    • Added version_id (string, nullable) for agent version identification
    • Added branch_id (string, nullable) for agent branch identification
    • Added main_branch_id (string, nullable) for main branch reference
  • Get conversation
    • Added version_id (string, nullable) with description “The ID of the agent version used for this conversation”
  • Get batch call, Submit batch call
    • Added total_calls_finished (integer, default 0) to batch call response models
    • Expanded BatchCallRecipientStatus enum to include dispatched status
    • Made signed_url nullable for video assets

Phone Numbers

December 15, 2025

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

Android SDK

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

API

New Endpoints

Updated Endpoints

Knowledge Base

  • List knowledge base documents
    • Added parent_folder_id query parameter (string) for filtering by parent folder
    • Added ancestor_folder_id query parameter (string) for filtering by ancestor folder
    • Added folders_first query parameter (boolean) for sorting folders before documents
  • Document response schemas
    • Added folder document type
    • Added folder_parent_id field (string, optional)
    • Added folder_path field (string, optional)
    • Added children_count field (integer, for folders)
    • Added GetKnowledgeBaseFolderResponseModel schema
    • Added GetKnowledgeBaseSummaryFolderResponseModel schema
  • RAG index endpoints
    • Added cannot_index_folder status to RAGIndexStatus enum
    • Added batch request/response models for RAG index operations

Agents Platform

  • Create agent, Update agent, Get agent

    • Added hinglish_mode (boolean, default false) to agent configuration
    • Added hinglish_mode to workflow override schemas (nullable boolean)

  • Widget configuration endpoints

    • Added conversation_mode_toggle_enabled (boolean, default false) to widget settings

  • Batch calling endpoints

    • Added retry_count (integer, default 0) to batch call response models

  • Conversation token model

    • Added token_requester_user_id (string, nullable) for identifying token requester

WhatsApp Integration

  • Submit batch calling
    • Replaced whatsapp_business_account_id with whatsapp_phone_number_id (string, nullable, optional)
  • Conversation info schemas
    • Replaced whatsapp_business_account_id with whatsapp_phone_number_id in WhatsAppConversationInfo

Text to Speech

  • All TTS endpoints with quality preset
    • Updated quality_preset descriptions to include credit cost percentages

Workspaces

  • Resource type enum
    • Added convai_agent_drafts to WorkspaceResourceType enum