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-liteorgemini-2.0-flash). When triggered, the guardrail ends the conversation. See the Security documentation for 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 includewhatsapp_phone_number_id,whatsapp_user_id,template_name,template_language_code,template_params, andagent_id. - Eleven v3 conversational model: Added
eleven_v3_conversationalto the available TTS models for agents, providing improved voice quality and expressiveness in agent conversations. - Suggested audio tags: Added
suggested_audio_tagsfield 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_modefield to webhook tool configurations with options:auto(default, determines handling based on tool type),summarized(sends LLM-generated summary),passthrough(sends raw error), orhide(does not share error with agent). - Dynamic variable sanitization: Added
sanitizefield (boolean, defaultfalse) toDynamicVariableAssignment. When enabled, the assignment value is removed from tool responses and transcripts while still being processed for variable assignment. - Turn model selection: Added
TurnModelenum withturn_v2andturn_v3options for selecting the turn detection model version. - Workflow node transfers: Added
is_workflow_node_transferfield (boolean, defaultfalse) toAgentTransferschema for identifying transfers within workflow nodes. - Transfer branch metadata: Added
TransferBranchInfoTrafficSplitandTransferBranchInfoDefaultingToMainschemas for tracking branch routing information in agent transfers. - Workflow node transition testing: Added
workflow_node_transitionassertion type for unit tests withUnitTestWorkflowNodeTransitionEvaluationNodeIdschema 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_memberto theSeatTypeenum for workspaces with limited access permissions. - Content templates resource: Added
content_templatestoWorkspaceResourceTypeenum 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
- @elevenlabs/react-native@0.5.10 - Fixed establishing text-only conversations
- @elevenlabs/react@0.14.0 - Reduced audio chunk length from 250ms to 100ms for lower latency in agent conversations
- @elevenlabs/client@0.14.0 - Reduced audio chunk length from 250ms to 100ms for lower latency, normalized
textOnlyoption handling between top-level and overrides object - @elevenlabs/types@0.5.0 - Added types for audio alignment data support
API
View API changes
New Endpoints
- Send outbound message via WhatsApp -
POST /v1/convai/whatsapp/outbound-message- Send an outbound message via WhatsApp using message templates - Get project muted tracks -
GET /v1/studio/projects/{project_id}/muted-tracks- Returns chapter IDs with muted tracks
Updated Endpoints
Agents Platform
- Create agent, Update agent, Get agent
- Added
customfield toGuardrailsV1schema for custom guardrails configuration - Added
alignmentfield toGuardrailsV1schema for alignment guardrails - Added
suggested_audio_tagsfield to TTS conversational config (array ofSuggestedAudioTag, max 20 items) - Added
eleven_v3_conversationaltoTTSConversationalModelenum
- Added
- Create tool, Update tool
- Added
tool_error_handling_modefield toApiIntegrationWebhookToolConfig(enum:auto,summarized,passthrough,hide, defaultauto) - Added
sanitizefield toDynamicVariableAssignment(boolean, defaultfalse)
- Added
Workspaces
- Get resource
- Added
content_templatestoWorkspaceResourceTypeenum
- Added
- Add workspace invite, Add workspace member
- Added
workspace_lite_membertoSeatTypeenum
- Added
Schema Changes
New Schemas
CustomGuardrail-Input,CustomGuardrail-Output- Container for custom guardrails configurationCustomGuardrailsConfig- Config container for custom guardrails listCustomGuardrailConfig- Single custom guardrail withname(string, required),prompt(string, required, max 10,000 chars),model(enum:gemini-2.5-flash-lite,gemini-2.0-flash, required), andis_enabled(boolean, defaultfalse)ToolErrorHandlingMode- Enum for tool error handling:auto,summarized,passthrough,hideTurnModel- Enum for turn detection model version:turn_v2,turn_v3SuggestedAudioTag- Audio tag configuration withtag(string, required, max 30 chars) anddescription(string, optional, max 200 chars)TransferBranchInfoTrafficSplit- Branch info for traffic split transfers withbranch_idandtraffic_percentageTransferBranchInfoDefaultingToMain- Branch info for default-to-main transfers withbranch_idUnitTestWorkflowNodeTransitionEvaluationNodeId- Workflow node transition test configuration withagent_idandtarget_node_idProjectMutedTracksResponseModel- Response model withchapter_idsarrayWhatsAppOutboundMessageResponse- Response for WhatsApp outbound message endpointWhatsAppTemplateHeaderComponentParams,WhatsAppTemplateBodyComponentParams,WhatsAppTemplateButtonComponentParams- Template parameter schemas for WhatsApp messagesConversationHistoryTranscriptSystemToolResultCommonModel-Input,ConversationHistoryTranscriptSystemToolResultCommonModel-Output- Split system tool result models for input/output variants
Modified Schemas
GuardrailsV1-Input,GuardrailsV1-Output- Addedcustom(CustomGuardrail) andalignment(AlignmentGuardrail) fieldsTTSConversationalConfig-Input,TTSConversationalConfig-Output- Addedsuggested_audio_tagsfieldTTSConversationalModel- Addedeleven_v3_conversationalenum valueApiIntegrationWebhookToolConfig-Input,ApiIntegrationWebhookToolConfig-Output- Addedtool_error_handling_modefield (required)DynamicVariableAssignment- Addedsanitizefield (boolean, defaultfalse)AgentTransfer- Addedis_workflow_node_transferfield (boolean, defaultfalse)SeatType- Addedworkspace_lite_memberenum valueWorkspaceResourceType- Addedcontent_templatesenum value
Removed Schemas
AgentBan- Removed unused schemaBanReasonType- Removed unused enumDubbingReleaseChannel- Removed unused enum