Changelog
September 23, 2026
Section titled “September 23, 2026”Image & Video
Section titled “Image & Video”- Sora 2 and Sora 2 Pro retired: OpenAI is discontinuing the Sora API on September 24, 2026. Both models have been removed from the Image & Video model picker and stop generating on that date. Existing generations remain available in your history. Flows and templates that use a Sora node need to be switched to another video model, such as Gemini Omni 1.1 Flash, before they can run again.
- Seedance 1.5 Pro deprecated: ByteDance retires Seedance 1.5 Pro on November 11, 2026. The model is no longer offered for new generations and will stop working on that date. Use a Seedance 2.0 model instead.
September 21, 2026
Section titled “September 21, 2026”ElevenAgents
Section titled “ElevenAgents”- Parallel tool calls: Agent prompt configuration now includes
enable_parallel_tool_calls(boolean, defaulttrue). When enabled, supported models can execute multiple tools in one turn. - Agent models: Added
gpt-6-astrato the agent LLM options. - Alerting: Agent alerting now supports Slack channels alongside PagerDuty and webhook notifiers.
- Phone number search: Added a cursor-paginated phone number endpoint with filters for provider, outbound support, assigned agent and branch, label and phone number.
Image and video
Section titled “Image and video”- GPT Image 2.5 models: Image generation now supports
gpt-image-2.5-flareandgpt-image-2.5-sunburst. Both models accept up to 10 reference images, quality levels throughmax, 14 fixed aspect ratios plusauto, and 1K, 2K or 4K output.
Speech Engine
Section titled “Speech Engine”- Cascade timeout: Speech Engine create and update requests now accept
cascade_timeout_seconds(number, 2–15, default4) to control how long ElevenLabs waits for an upstream speech engine before retrying.
Text to Speech
Section titled “Text to Speech”- Multi-context turn boundaries: The
is_final_audio_for_turnmarker is now emitted after every buffered byte for that turn, including MP3 and Opus output. Clients can use the marker as an exact turn boundary without switching to PCM.
SDK releases
Section titled “SDK releases”JavaScript SDK
Section titled “JavaScript SDK”- v2.69.0 - Added
transcriptEditto the realtime Speech to Text wrapper, with edited text delivered throughedited_transcriptevents. Fixed Speech Engine JWT verification for API keys with data residency suffixes. AddedphoneNumbers.listV2and Flows template methods to list and get templates and list, create and get runs. Regenerated clients and types for GPT Image 2.5, Slack agent alerting, parallel tool calls,gpt-6-astra, service account API key concurrency limits, Music zero retention, conversation filters and MCP tool approval statuses.
Python SDK
Section titled “Python SDK”- v2.69.0 - Added
transcript_editto the realtime Speech to Text wrapper, with edited text delivered throughedited_transcriptevents. Fixed Speech Engine JWT verification for API keys with data residency suffixes, and madeplayraise an error whenffplayfails. Addedphone_numbers.list_v2and Flows template methods to list and get templates and list, create and get runs. Regenerated clients and types for GPT Image 2.5, Slack agent alerting, parallel tool calls,gpt-6-astra, service account API key concurrency limits, Music zero retention, conversation filters and MCP tool approval statuses.
ElevenLabs CLI
Section titled “ElevenLabs CLI”- v1.3.2 - Added optional
--intentmetadata to collect feedback on CLI usage. Addedelevenlabs feedback missing-capabilityto report workflows that the CLI does not support.
View API changes
New endpoints
ElevenAgents
- List phone numbers page -
GET /v1/convai/v2/phone-numbers- Added optional
page_size(integer, 1–1,000, default100) andcursor(nullable string) pagination parameters. - Added optional
search,label,phone_number,provider,supports_outbound,agent_id,branch_id,sort_byandsort_directionfilters.sort_byacceptslabelorphone_number;sort_directiondefaults toasc. - The response contains required
phone_numbers(array), optional nullablenext_cursor(string) andhas_more(boolean, defaultfalse).
- Added optional
Updated endpoints
ElevenAgents
- Create agent, Get agent and Update agent
- Prompt configuration adds
enable_parallel_tool_calls(boolean, defaulttrue). Workflow overrides accept a nullable boolean. - The
LLMenum addsgpt-6-astra, including conversation initiation overrides. - Alerting integration notifiers now use
integration_typeto selectpagerdutyorslack. Slack notifiers requireconnection_idandchannel_id(strings);channel_idaccepts 1–64 characters.
- Prompt configuration adds
- List conversations and Resolve conversation reference
data_collection_paramsno longer accepts themissingoperator. Use an empty value to match conversations where the field was not collected.- An empty value in
dynamic_variable_paramsmatches conversations where the variable was not set.
- Create Speech Engine, Get Speech Engine and Update Speech Engine
- Added
cascade_timeout_seconds(number, 2–15). Create requests default to4, update requests accept a nullable value and responses require the field.
- Added
Image and video
- Create image generation -
POST /v1/flows/image- Added request variants for
gpt-image-2.5-flareandgpt-image-2.5-sunburst. - Both variants require
promptandmodel_id, accept up to 10images, and addresolution(1K,2Kor4K, default1K). qualityacceptslow,medium,high,xhighormaxand defaults tohigh.aspect_ratioacceptsautoand 14 fixed ratios and defaults to16:9.
- Added request variants for
Dubbing
- Create dubbing project -
POST /v1/dubbing/project- Multipart
keytermsaccepts repeated fields or a single JSON array. - Multipart
webhook_idsaccepts repeated fields, a single JSON array or a comma-separated string.
- Multipart
- Get workspace resource, Share workspace resource and Unshare workspace resource
WorkspaceResourceTypeaddsdubbing_project.
Knowledge base
- Create crawl job -
POST /v1/convai/knowledge-base/crawl- Deprecated
max_depth(integer, default3). The field is now a no-op and no longer has minimum or maximum constraints. - Crawl job metadata no longer requires
max_depth.
- Deprecated
User
- Get user and Get subscription
- Currency enums add
gbp.
- Currency enums add
Schema changes
Text to Speech
- Multi-context WebSocket
audioandfinalmessages now defineis_final_audio_for_turnas occurring after all buffered bytes for the turn have been delivered.
September 14, 2026
Section titled “September 14, 2026”ElevenAgents
Section titled “ElevenAgents”- Call queueing and hold audio: Added call queueing for agents at their concurrency limit. Queued callers hear hold audio and receive
queue_statusevents until they are admitted or time out. New API methods upload or delete custom hold audio. - Test version metadata: Agent test results now identify the agent version they ran against and whether they included draft changes. Invocation summaries also indicate when partial resubmissions ran against different versions.
- Model and account metadata: Agent LLM configuration now accepts
gemini-3.8-flash. WhatsApp account responses identify whether the account uses the Cloud API or coexistence signup flow.
- Music v2.5 API support: Music endpoints and SDKs now accept
music_v2_5. Composition plan generation chunks support up to 6,132 characters, with up to 30 lines of 200 characters each.
SDK releases
Section titled “SDK releases”JavaScript SDK
Section titled “JavaScript SDK”- v2.68.0 - Added methods to upload and delete agent hold audio. Regenerated types for call queueing, procedure references, draft branch creation, RAG query limits, test version metadata,
gemini-3.8-flashandmusic_v2_5.
Python SDK
Section titled “Python SDK”- v2.68.0 - Added synchronous and asynchronous methods to upload and delete agent hold audio. Regenerated types for call queueing, procedures, draft branch creation, RAG query limits, test version metadata,
gemini-3.8-flashandmusic_v2_5. Thecompose_detailedwrapper now accepts every generated music model ID and both prompt- and chunk-based composition plans.
iOS SDK
Section titled “iOS SDK”- v3.3.1 - Reconciles agent messages by
response_idinstead ofevent_id, preserving multiple responses around tool calls and preventing streamed parts or corrections from attaching to the wrong message.
ElevenLabs CLI
Section titled “ElevenLabs CLI”- v1.3.0 - Added optional
--intentmetadata to generated API commands. Addedelevenlabs feedback missing-capabilityto report workflows that the CLI does not support.
Packages
Section titled “Packages”- @elevenlabs/convai-widget-core@0.18.2 and @elevenlabs/convai-widget-embed@0.18.2 - Fixed duplicate agent replies after tool and procedure calls. Streamed text replies retain Markdown formatting, and voice conversations no longer render unspoken streamed chat parts. The embed package also limits
user_activityevents to once per second and clears the limit when a session ends.
View API changes
New endpoints
ElevenAgents
- Upload agent hold audio -
POST /v1/convai/agents/{agent_id}/hold-audio- Accepts required
hold_audio_file(binary) as multipart form data. The file must be MP3 or WAV, up to 40 MB and 180 seconds. - Returns required
agent_id(string) andhold_audio(AgentHoldAudioConfig). The hold-audio object requiresaudio_path,audio_url,original_filename(strings),duration_secs(number) andsize_bytes(integer).
- Accepts required
- Delete agent hold audio -
DELETE /v1/convai/agents/{agent_id}/hold-audio- Removes the custom clip so queued callers hear the default hold tone.
- Returns required
agent_id(string).
Updated endpoints
ElevenAgents
- Create agent, Get agent and Update agent
- Added optional
platform_settings.queueing_config(AgentQueueingConfig) withenabled(boolean, defaultfalse) andwait_timeout_seconds(integer, 1–1,800, default180). - Queue configuration responses include read-only nullable
hold_audio(AgentHoldAudioConfig). Agent responses also include optionaldefault_hold_audio_url(string).
- Added optional
- Get conversation -
GET /v1/convai/conversations/{conversation_id}- Metadata adds optional nullable
queue_wait_secs(number). Queue time is excluded fromcall_duration_secsand billed time.
- Metadata adds optional nullable
- Create agent branch -
POST /v1/convai/agents/{agent_id}/branches- Added optional
include_draft(boolean, defaultfalse). Whentrue, a branch created from the branch tip includes the caller's draft procedure set.
- Added optional
- List procedures and procedure create, get and draft endpoints
- List items add optional
referenced_tool_ids,referenced_kb_ids,referenced_procedure_idsandreferenced_dynamic_variables(string arrays). - Agent and merge-preview responses add optional
procedures, a map keyed by procedure ID.
- List items add optional
- List test invocations -
GET /v1/convai/test-invocations- Added optional nullable
search(string) to filter tests and folders by name.
- Added optional nullable
- Run tests on agent and Get test invocation
- Test suite invocation and unit test run responses add optional nullable
version_id(string) and optionalran_against_draft(boolean, defaultfalse). - Invocation summaries also add optional
runs_diverged_from_version(boolean, defaultfalse).
- Test suite invocation and unit test run responses add optional nullable
POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query- The request body adds optional nullable
max_documents_length(integer, 1–50,000) andmax_retrieved_rag_chunks_count(integer, 1–20) query-specific overrides.
- The request body adds optional nullable
- Get WhatsApp account -
GET /v1/convai/whatsapp-accounts/{phone_number_id}- Added optional
account_type(WhatsAppAccountType, defaultcloud_api). Values arecloud_apiandcoexistence.
- Added optional
- Calculate expected LLM usage -
POST /v1/convai/agent/{agent_id}/llm-usage/calculateLLMUsageCalculatorLLMResponseModeladds requiredprice_per_message(number).
Music
MusicModelIDaddsmusic_v2_5forPOST /v1/music/video-to-music,POST /v1/music/plan, Compose music,POST /v1/music/detailed,POST /v1/music/detailed/stream,POST /v1/music/stream,POST /v1/music/uploadandPOST /v1/music/finetunes.GenerationChunk.textincreasesmaxLengthfrom 6,000 to 6,132 characters forPOST /v1/music/plan,POST /v1/music,POST /v1/music/detailed,POST /v1/music/detailed/stream,POST /v1/music/streamandPOST /v1/music/upload. Section names can contain 1–100 characters, and chunks can contain up to 30 lines with 200 characters per line.
Schema changes
ElevenAgents
- Real-time server events add
queue_status. Its requiredqueue_status_event.statusacceptswaiting,admittedortimed_out;timed_outprecedes WebSocket close code4300. Hold audio continues to arrive as regularaudioevents. - The
LLMenum addsgemini-3.8-flash, including conversation initiation overrides. - Conversation system tool result unions add
start_procedure_success,start_procedure_error,end_procedure_successandend_procedure_error. FeaturesUsageCommonModeladds optionalfreeform_procedureandstructured_procedurefeature statuses.
September 11, 2026
Section titled “September 11, 2026”Scribe v2 Medical
Section titled “Scribe v2 Medical”Scribe v2 Medical is now generally available. It is a batch speech recognition model specialized for medical and clinical audio, billed at the same rate as Scribe v2.
Pass scribe_v2_medical as model_id on Create transcript. Keyterm prompting, entity detection, speaker diarization, and no-verbatim mode work the same way as Scribe v2.
Models
Model ID, features, and when to use Scribe v2 Medical.
Create transcript
Transcribe audio with model_id set to scribe_v2_medical.
September 7, 2026
Section titled “September 7, 2026”ElevenAgents
Section titled “ElevenAgents”- Workspace-wide conversation tickets: Added List workspace tickets to retrieve conversation triage tickets across accessible agents. Filter by status or assignee and use cursor pagination to retrieve up to 100 tickets per page.
- Dynamic variable conversation filters: List conversations and Text search conversation messages now accept repeatable
dynamic_variable_paramsfilters. Usename:op:valuewitheq,gt,gte,ltorlte; comparison operators require numeric values. - Twilio answering machine detection: Outbound telephony and batch call configurations now support optional
twilio_machine_detection. Chooseenablefor an early human-or-machine verdict ordetect_message_endto wait for a voicemail greeting to finish. Results arrive through the newanswering_machine_detectionwebhook event. - Data collection value constraints: Data collection properties can now use
allowed_valuesto name a dynamic variable containing the permitted values. The previousallowed_values_dynamic_variablefield is deprecated. - Agent metadata: List agent branches responses now indicate when a draft was created and whether it predates the branch tip. Agent and Speech Engine summaries now require
voice_id. - Knowledge base source URLs: Agent RAG query chunks now include required nullable
source_url, containing the tracked URL for URL documents. - Agent response attachments:
agent_responseWebSocket events now include optionalattachments. Each attachment requiresurlandnameand can includemime_type.
Workspaces
Section titled “Workspaces”- API key platform limits: Service account API key responses can now include enterprise
platform_limitsfor credits, Professional Voice Clones, and TTS, Dubbing, and Music concurrency.
SDK releases
Section titled “SDK releases”JavaScript SDK
Section titled “JavaScript SDK”- v2.67.0 - Added
dynamicVariableParamsto conversation listing and text search requests. Regenerated types for Twilio answering machine detection, data collection value constraints, API key platform limits, agent branch draft metadata and knowledge base source URLs.
Python SDK
Section titled “Python SDK”- v2.67.0 - Added
dynamic_variable_paramsto synchronous and asynchronous conversation listing and text search methods. Regenerated types for Twilio answering machine detection, data collection value constraints, API key platform limits, agent branch draft metadata and knowledge base source URLs. The real-time text-to-speech client no longer passes the internal omit sentinel to the connection.
ElevenLabs CLI
Section titled “ElevenLabs CLI”- v1.2.0 - Added the
elevenlabs saycommand and its agent skill, regenerated API command bindings and madeeleven_v3the default TTS model.
Packages
Section titled “Packages”- @elevenlabs/client@1.25.0, @elevenlabs/react@1.15.2, @elevenlabs/react-native@1.2.27, @elevenlabs/convai-widget-core@0.18.1 and @elevenlabs/convai-widget-embed@0.18.1 - Re-exported
MessageAttachmentfrom@elevenlabs/clientso consumers can import the type directly. - @elevenlabs/client@1.24.0, @elevenlabs/types@0.23.0, @elevenlabs/react@1.15.1, @elevenlabs/react-native@1.2.26, @elevenlabs/convai-widget-core@0.18.0 and @elevenlabs/convai-widget-embed@0.18.0 - Forwarded agent-response file attachments to
onMessageand added the optionalwebRtc.singlePeerConnectionsession setting. The widget also localizes greeting buttons and fixes dropped or duplicated text-chat responses.
View API changes
New endpoints
ElevenAgents
- List workspace tickets -
GET /v1/convai/triage-tickets- Lists conversation triage tickets across every agent the caller can access, ordered by most recently created first.
- Added optional
page_size(integer, 1–100, default100),status(AgentConversationTicketStatus),assignee_user_id(string orunassigned) andcursor(string) query parameters. - Returns
GetAgentConversationTicketsPageResponseModel.
Updated endpoints
ElevenAgents
- List conversations -
GET /v1/convai/conversations- Added optional nullable
dynamic_variable_params(repeatable string array). Each value usesname:op:value, whereopiseq,gt,gte,ltorlte.
- Added optional nullable
- Text search conversation messages -
GET /v1/convai/conversations/messages/text-search- Added optional nullable
dynamic_variable_params(repeatable string array) with the same syntax.
- Added optional nullable
- Twilio outbound call, SIP trunk outbound call, Exotel outbound call and Submit batch calling
telephony_call_confignow uses separate input and output schemas.- Added optional nullable
twilio_machine_detection(TwilioMachineDetectionConfig). Itsmodeacceptsenableordetect_message_endand defaults toenable. The setting is ignored for non-Twilio providers and inbound calls.
- Import phone number -
POST /v1/convai/phone-numbers- Added optional nullable
account_auth_token(string) for Twilio API key imports to validate inbound webhook signatures.
- Added optional nullable
Schema changes
ElevenAgents
WebhookEventTypeaddsanswering_machine_detection.AgentBranchSummaryadds optional nullabledraft_created_at(integer) and optionaldraft_is_behind_tip(boolean, defaultfalse).AgentKnowledgeBaseRagChunkResponseModeladds required nullablesource_url(string).AgentSummaryResponseModelandSpeechEngineSummaryResponseadd requiredvoice_id(string).AnalysisPropertyadds optional nullablename(string) andallowed_values(AllowedValues).LiteralJsonSchemaPropertyalso addsallowed_values. Both deprecateallowed_values_dynamic_variable.DataCollectionResultCommonModeladds optional nullablename(string).WorkspaceApiKeyResponseModeladds optional nullableplatform_limits(PlatformLimits).- MCP tool
Iconadds optional nullabletheme(lightordark). SMBToolConfigaddssend_custom_email,create_service_quote_requestandcreate_product_quote_requestparameter variants.- Webhook query parameter schemas and telephony call configuration now use separate input and output models.
agent_responseWebSocket events add optionalattachments(array). Each item requiresurlandname(strings) and accepts optionalmime_type(string).
ElevenCreative
ReferenceVideo.studio_clipnow usesStudioClipLocatorinstead ofStudioClipReference. The fields and wire format are unchanged.
August 31, 2026
Section titled “August 31, 2026”ElevenAgents
Section titled “ElevenAgents”- Phone keypad input: Agent conversation configuration now supports optional
dtmf_input_settingsfor DTMF input. Configure the digit timeout, use#as a terminator and redact keypad entries from transcripts, logs and analysis. - Conversation attachment history: Get conversation transcript entries now include
file_inputs, an array containing every attached file's ID, name, MIME type and URL. - Agent tag filtering: List agents now accepts an optional
tagsquery parameter. Repeat the parameter to match agents with any of the supplied tags. - Batch campaign context: Get conversation now identifies batch calls with nullable
campaignmetadata containing the requiredcampaign_idandcampaign_lead_id.
- Waveform visual data: Generate music detailed, Stream music with details and Upload music now accept optional
with_waveform_visual(boolean, defaultfalse). Opted-in responses return a low-resolutionwaveform_visualinteger array with four samples per second.
Dubbing
Section titled “Dubbing”- Project pagination behavior: List Dubbing projects and List language targets now clamp
page_sizeto 1–100. Project status filtering includesqueued, and both endpoints document usingnext_cursorto retrieve the next page.
SDK releases
Section titled “SDK releases”JavaScript SDK
Section titled “JavaScript SDK”- v2.66.0 - Added
fileIdstosendMultimodalMessage, allowing one message to include multiple file attachments.
Python SDK
Section titled “Python SDK”- v2.66.0 - Added
file_idstosend_multimodal_message, allowing one message to include multiple file attachments.
Android SDK
Section titled “Android SDK”- v0.12.2 - Preserved the
onUnhandledClientToolCallcallback when wiring session events. Unhandled client tool calls that expect a response now receive the automatic error response instead of remaining unresolved.
ElevenLabs CLI
Section titled “ElevenLabs CLI”- v1.1.0 - Regenerated API command bindings and added command-scoped request attribution for ElevenAgents workflows. These commands append
cmd/<command>to the CLIUser-Agent, allowing requests from workflows such asagents pushandagents createto be distinguished.
Packages
Section titled “Packages”- @elevenlabs/client@1.23.0, @elevenlabs/react@1.15.0, @elevenlabs/types@0.22.1, @elevenlabs/react-native@1.2.25, @elevenlabs/convai-widget-core@0.17.1 and @elevenlabs/convai-widget-embed@0.17.1 - Added
fileIdstosendMultimodalMessage. The client sends bothfileandfilesfields for compatibility, and React exposes the updated client API.
View API changes
Updated endpoints
ElevenAgents
- List agents -
GET /v1/convai/agents- Added optional nullable
tags(string array). Repeat the query parameter to match any supplied tag.
- Added optional nullable
- Create agent, Get agent and Update agent
- Added optional nullable
conversation_config.conversation.dtmf_input_settings(DTMFInputConfig). It supportsdtmf_input_timeout(number, 0.5–10 seconds, default2),hash_terminator(boolean, defaulttrue) andredact_input(boolean, defaultfalse). - Added optional
sip_refer_play_dialtone(boolean, defaulttrue) to phone-number transfer configuration. Set it tofalseto keep the original call leg silent while a SIP REFER transfer completes. - Start- and end-procedure system tools now accept either a
ProcedureVersionRefor aProcedureDraftRef. Draft references requireprocedure_id(string) and setversion_idtonull.
- Added optional nullable
- Get conversation -
GET /v1/convai/conversations/{conversation_id}- Added
file_inputs(array ofConversationHistoryTranscriptFileInputResponseModel) to transcript entries. Each item requiresfile_id,original_filename,mime_typeandfile_url(strings). - Added optional nullable
campaign(BatchCallingCampaignInformation) to batch-call metadata. The object requirescampaign_idandcampaign_lead_id(strings). - Added
dtmftoChatSourceMedium.
- Added
- Conversation triage ticket issue types add
incorrect_information,documentation_gap,platform_bugandwrong_action.
Music
- Generate music detailed (
POST /v1/music/detailed) and Stream music with details (POST /v1/music/detailed/stream)- Added optional
with_waveform_visual(boolean, defaultfalse). - Detailed responses add nullable
waveform_visual(integer array), sampled four times per second from-1000to1000.
- Added optional
- Upload music -
POST /v1/music/upload- Added optional
with_waveform_visual(boolean, defaultfalse) and nullablewaveform_visual(integer array) in the response.
- Added optional
ElevenCreative
- Create Studio project and Create podcast
quality_presetnow acceptsnull, and itsstandardschema default was removed.
Dubbing
- List Dubbing projects -
GET /v1/dubbing/projectpage_sizeremains an optional integer with default20, but values are now clamped to 1–100 instead of rejected.- The
statusfilter now documentsqueued,preparing,readyandfailed. - Pass the preceding response's
next_cursorincursor; omit it for the first page.
- List language targets -
GET /v1/dubbing/project/{project_id}/languagepage_sizeremains an optional integer with default20, but values are now clamped to 1–100 instead of rejected.- The
statusfilter supportsqueued,processing,completed,staleandfailed. - Pass the preceding response's
next_cursorincursor; omit it for the first page.
Schema changes
Workspace
PendingSubscriptionSwitchResponseModel.next_tieraddsgrant.
August 24, 2026
Section titled “August 24, 2026”ElevenLabs CLI
Section titled “ElevenLabs CLI”The ElevenLabs CLI v1.0.0 is now available. Every ElevenLabs API operation is available as a subcommand, with JSON, table, YAML and CSV output, automatic pagination and shell completion.
The CLI also provides local configuration workflows for ElevenAgents. Store agent, tool and test configurations as files, synchronize them with push and pull commands, manage branches, run tests, install ElevenLabs UI components and select a data residency region.
Procedures
Section titled “Procedures”Procedures are now generally available in ElevenAgents. A procedure contains task-specific instructions and a trigger that determines when they apply. During a conversation, the agent loads the relevant procedure, allowing one agent to handle distinct tasks without placing every instruction in its system prompt.
Use free-form procedures when the agent can adapt the wording or order of instructions. Use structured procedures when steps must run in a defined order. Both types can be used alongside workflows on the same agent.
Procedures overview
Learn when to use procedures and how they compare with prompts and workflows.
Free-form procedures
Write natural-language instructions that the agent can adapt to the conversation.
Structured procedures
Define typed steps that the agent follows in a consistent order.
ElevenAgents
Section titled “ElevenAgents”- Conversation triage tickets: Added APIs for creating tickets about agent performance, creating manual follow-up tickets, listing tickets, assigning workspace members, updating status and assignee, and adding ticket-level or turn-level comments.
- Conversation observability: Realtime clients can receive a
context_usageevent after each completed agent turn. The event reports the model, prompt token count and model context limit.
SDK Releases
Section titled “SDK Releases”JavaScript SDK
Section titled “JavaScript SDK”- v2.65.0 - Added clients and types for conversation triage tickets and lightweight conversation summaries. Conversation APIs add procedure, invalid-tool-call and sort filters; procedure APIs add agent version selection; topic APIs add evaluation detail controls and frustration sorting. The release also adds knowledge base refresh frequency, test environment and alerting integration fields, plus realtime Dubbing message types.
Python SDK
Section titled “Python SDK”- v2.65.0 - Added clients and types for conversation triage tickets and lightweight conversation summaries. Conversation APIs add procedure, invalid-tool-call and sort filters; procedure APIs add agent version selection; topic APIs add evaluation detail controls and frustration sorting. The release also adds knowledge base refresh frequency, test environment and alerting integration fields, and preserves repeated multipart fields for Speech to Text
keytermsand Dubbingwebhook_ids.
Swift SDK
Section titled “Swift SDK”- v3.3.0 - Added typed client error parsing,
expects_responsehandling and type-safe tool results. WebRTC startup now becomes ready when the agent joins instead of waiting for audio-track subscription. The release also hardens URL handling, suppresses unknown-event noise and removes realtime-thread allocation from software mute processing.
Packages
Section titled “Packages”- @elevenlabs/client@1.19.1, @elevenlabs/react@1.12.3, @elevenlabs/react-native@1.2.21, @elevenlabs/convai-widget-core@0.16.2 and @elevenlabs/convai-widget-embed@0.16.2 - WebRTC output capture now uses self-hosted AudioWorklet paths under strict content security policies. Worklet caching includes the requested source, preventing an earlier inline URL from replacing a self-hosted path. React Native setup errors now point to
@elevenlabs/react-native. - @elevenlabs/client@1.20.0, @elevenlabs/react@1.12.4, @elevenlabs/react-native@1.2.22, @elevenlabs/convai-widget-core@0.16.3 and @elevenlabs/convai-widget-embed@0.16.3 - Added optional
webRtc.iceTransportPolicy. Set it torelayto restrict WebRTC ICE candidates to TURN relays on networks that block direct UDP traffic. - @elevenlabs/client@1.21.0, @elevenlabs/react@1.13.0, @elevenlabs/types@0.21.1, @elevenlabs/react-native@1.2.23, @elevenlabs/convai-widget-core@0.16.4 and @elevenlabs/convai-widget-embed@0.16.4 - Added the
onContextUsagecallback andContextUsageEventtype. React exposes the callback throughuseConversation. React Native now resolves through its package export condition instead of browser-global detection. - @elevenlabs/client@1.22.0, @elevenlabs/react@1.14.0, @elevenlabs/types@0.22.0, @elevenlabs/react-native@1.2.24, @elevenlabs/convai-widget-core@0.17.0 and @elevenlabs/convai-widget-embed@0.17.0 - Added first-message rich content with attributed button responses,
onExternalAgentDisconnectedandonMCPToolApprovalRequest. WebRTC now uses the selected input device, preserves mute state when switching microphones and fails setup if initiation data cannot be sent. The widget adds concurrency queue status, optional language selection on the collapsed trigger and first-message rendering for agents that support both text and voice.
View API changes
New Endpoints
ElevenAgents
- Added nine conversation triage ticket endpoints:
- Create conversation ticket -
POST /v1/convai/triage-tickets. The request requiresconversation_id(string) and acceptsqa_comment(nullable string, 1–10,000 characters) and up to 200 turn comments. - List tickets -
GET /v1/convai/agents/{agent_id}/triage-tickets, with cursor pagination. - Create manual ticket -
POST /v1/convai/agents/{agent_id}/triage-tickets. The request requiresqa_comment(string, 1–10,000 characters). - List assignable users -
GET /v1/convai/agents/{agent_id}/triage-tickets/assignable-users. The response lists non-service-account workspace members and whether each member has access to the agent. - Get ticket -
GET /v1/convai/triage-tickets/{agentqa_ticket_id}. - Update ticket -
PATCH /v1/convai/triage-tickets/{agentqa_ticket_id}. The request accepts optionalstatusand nullableassignee_user_id. - Delete ticket -
DELETE /v1/convai/triage-tickets/{agentqa_ticket_id}. - Add comment -
POST /v1/convai/triage-tickets/{agentqa_ticket_id}/comments. The request requirescomment(string, 1–10,000 characters). - Add turn comment -
POST /v1/convai/triage-tickets/{agentqa_ticket_id}/turn-comments. The request requires zero-basedturn_index(integer) andcomment(string, 1–10,000 characters).
- Create conversation ticket -
Updated Endpoints
ElevenAgents
- Get signed URL -
GET /v1/convai/conversation/get-signed-url- Added optional
debug_events_request(boolean, defaultfalse). Debug events require editor access to the agent.
- Added optional
- Get WebRTC token -
GET /v1/convai/conversation/token- Added optional
debug_events_request(boolean, defaultfalse). The legacyGET /v1/convai/conversation/get_signed_urlroute accepts the same parameter.
- Added optional
- List conversations -
GET /v1/convai/conversations- Added optional
triggered_procedure_ids(nullable string array, maximum 50) to match conversations where any specified procedure ran. - Added optional
include_invalid_tool_calls(boolean, defaultfalse) to include tool calls that did not run. - Added optional
sort_direction(ascordesc, defaultdesc) for call start time.
- Added optional
- Text search conversation messages -
GET /v1/convai/conversations/messages/text-search- Added optional
triggered_procedure_ids(nullable string array, maximum 50). - Added optional
include_invalid_tool_calls(boolean, defaultfalse).
- Added optional
- Get agent conversation topics -
GET /v1/convai/agents/{agent_id}/topics- Added optional
include_evaluation_criteria(boolean, defaulttrue). - Added
frustrationtosort_by. - Topic responses add nullable
success_rate(number), while the overall response addsaggregated_run_count(integer, default0). from_unix_secsis floored to the start of its UTC day. A bounded range aggregates completed daily discovery runs; omitting both bounds returns the latest run.
- Added optional
- List procedures (
GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures) and Get procedure (GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id})- Added optional nullable
agent_version_id(string) to retrieve procedures from a specific agent version.
- Added optional nullable
- Create test and Update test
- Added optional nullable
environment(string) to response, simulation and tool-call unit test schemas. The value selects environment-specific URLs, headers and auth connections; it defaults toproduction.
- Added optional nullable
- Create URL document, Create crawl job and Create folder
- Added optional nullable
minimum_frequency_days(integer, 1–180) for auto-sync. The default is7, and a stricter parent-folder frequency takes precedence.
- Added optional nullable
Music
- List Music Finetunes -
GET /v1/music/finetunes- Increased the maximum
page_sizefrom 100 to 150. The default remains 50.
- Increased the maximum
Schema Changes
ElevenAgents
- Agent update requests add optional nullable
procedures(object<string, ProcedureVersionRef>). Each value requiresprocedure_idandversion_id(strings). An empty object removes all procedures. - Conversation initiation configuration adds
enable_procedure_ids_from_client(boolean, defaultfalse). Initiation data adds optional nullableprocedure_ids(string array); an empty array disables all procedures for the starting agent. ClientEventaddscontext_usage.- Soft-timeout overrides add optional nullable
additional_soft_timeout_messages(string array). - Constant values in analysis and schema override models now accept
null. - Widget configuration defaults for
mic_muting_enabledandtranscript_enabledchanged fromfalsetotrue. Set them explicitly tofalseto preserve the previous behavior.
Workspace
- Get user responses removed
xi_api_keyfromUserResponseModel. ResourceMetadataResponseModel.role_to_group_idsnow accepts custom role IDs as keys instead of restricting keys toadmin,editor,commenterandviewer.- Direct publishing responses add optional nullable
restricted_to_user_email_domains(string array). - Pending subscription switch responses add
gotonext_tier.
August 22, 2026
Section titled “August 22, 2026”MCP server
Section titled “MCP server”- Local MCP server deprecated: The local ElevenLabs MCP server and MCP player are deprecated in favor of the hosted MCP server. Both repositories are archived and will no longer receive updates. The hosted server is available at
https://api.elevenlabs.io/v1/mcp, signs in with your ElevenLabs account through OAuth and requires no local installation or API key. See the hosted MCP server documentation for setup instructions for Claude, Cursor and other MCP clients.
August 17, 2026
Section titled “August 17, 2026”ElevenCreative
Section titled “ElevenCreative”- Image, video and speech generation APIs: New asynchronous Flows APIs create, list and retrieve video, image and speech generations. Generation responses expose
pending,generating,completedandfailedstates, and requests can include a webhook target for completion events. - Reusable media assets: New asset APIs upload, list, retrieve and delete workspace media. Image, video and audio references can use an uploaded asset, a previous generation or inline base64 data, allowing generation jobs to be chained. See References and assets.
ElevenAgents
Section titled “ElevenAgents”- Lightweight conversation summaries: Get conversation summary returns the generated title, transcript summary, call outcome and plain user or agent messages without loading the full transcript. The optional
max_messagesquery parameter is an integer from 1 to 200 (default40); longer conversations setmessages_omittedtotrue. Useful for agents that need to preserve context. - Conversation topic pagination and sorting: Get agent conversation topics adds optional cursor pagination and sorting. Use
page_size(integer, 1–100),cursor(string),sort_by(conversations,sentimentorsuccess_rate) andsort_direction(ascordesc). Responses addhas_moreand nullablenext_cursor. - Concurrency wait queues: Agent platform settings add optional
queueing(AgentQueueingConfig). Setenabledtotrueto hold callers when the agent reaches its concurrency limit;wait_timeout_secondsis an integer up to 1,800 (default180). - Turn and workflow controls: Turn configuration adds
merge_with_default_ignore_terms(boolean, defaultfalse) to combine custom interruption terms with curated defaults. Soft timeouts adddisable_until_first_user_message(boolean, defaultfalse), and workflow tool locators add optionalschema_overridesfor per-node parameter overrides. - Background audio defaults:
BackgroundSoundConfig.volumenow defaults to0.15instead of0.6, andcrossfade_loopnow defaults totrueinstead offalse. Set these fields explicitly to retain the previous behavior.
SDK Releases
Section titled “SDK Releases”JavaScript SDK
Section titled “JavaScript SDK”- v2.64.0 - Added
client.assetsfor uploading, listing, retrieving and deleting assets, plusclient.flowsfor asynchronous video, image and speech generation. Turn configuration addsmergeWithDefaultIgnoreTerms. RemovedCustomToolApiSchemaConfigandscimExternalIdfromWorkspaceGroupResponseModel.
Python SDK
Section titled “Python SDK”- v2.64.0 - Added assets and Flows clients for asynchronous video, image and speech generation, plus
merge_with_default_ignore_termsin turn configuration. On-prem session setup addsextra_setup_configfor passing additional setup-message fields.
Packages
Section titled “Packages”- @elevenlabs/client@1.18.0, @elevenlabs/react@1.12.1, @elevenlabs/types@0.20.0, @elevenlabs/react-native@1.2.19, @elevenlabs/convai-widget-core@0.16.0 and @elevenlabs/convai-widget-embed@0.16.0 - Added experimental self-hosted orchestrator sessions and rich-content events. Scribe audio worklets can now be self-hosted for strict content security policies. Disconnect handling now reaches
disconnectedconsistently and prevents late callbacks from clearing a newer session. The widget renders quick replies and links inline, restores Markdown in voice transcripts and fixes language menu positioning inside container-query layouts. - @elevenlabs/client@1.19.0, @elevenlabs/react@1.12.2, @elevenlabs/types@0.21.0, @elevenlabs/react-native@1.2.20 and @elevenlabs/convai-widget-core@0.16.1 - Added realtime Speech to Text options for secondary languages, entity detection and background audio filtering. Added final transcript, detected entity and invalid request events; aligned timestamp word types with the live schema; and fixed microphone permission failures preventing
useScribereconnection.
View API changes
New Endpoints
ElevenCreative
- Create video generation -
POST /v1/flows/video - List video generations -
GET /v1/flows/video - Get video generation -
GET /v1/flows/video/{generation_id} - Create image generation -
POST /v1/flows/image - List image generations -
GET /v1/flows/image - Get image generation -
GET /v1/flows/image/{generation_id} - Create speech generation -
POST /v1/flows/text-to-speech - List speech generations -
GET /v1/flows/text-to-speech - Get speech generation -
GET /v1/flows/text-to-speech/{generation_id} - Upload asset -
POST /v1/assets - List assets -
GET /v1/assets - Get asset -
GET /v1/assets/{asset_id} - Delete asset -
DELETE /v1/assets/{asset_id}
ElevenAgents
- Get conversation summary -
GET /v1/convai/conversations/{conversation_id}/summary- Accepts optional
max_messages(integer, 1–200, default40) - Returns
GetConversationSummaryResponseModelwith requiredconversation_id,agent_id,status,message_countandnote - Plain
messagescontain onlyrole(useroragent) andmessage; conversations over the limit returnmessages_omitted: true
- Accepts optional
Updated Endpoints
ElevenAgents
- Get live count -
GET /v1/convai/analytics/live-count- Added optional
agent_ids(string array, maximum 25), which takes precedence overagent_id
- Added optional
- Get agent conversation topics -
GET /v1/convai/agents/{agent_id}/topics- Added optional
page_size(integer, 1–100),cursor(string),sort_by(conversations,sentimentorsuccess_rate) andsort_direction(ascordesc) - Responses add
has_more(boolean, defaultfalse) and nullablenext_cursor(string)
- Added optional
Schema Changes
ElevenAgents
- Added optional
queueing(AgentQueueingConfig) to agent platform settings. It containsenabled(boolean, defaultfalse) andwait_timeout_seconds(integer greater than 0 and at most 1,800, default180) - Added optional
schema_overridestoWorkflowToolLocator; per-node constant, dynamic variable, LLM or omit overrides take precedence over tool-level overrides - Added
merge_with_default_ignore_terms(boolean, defaultfalse) to turn configuration and related override schemas - Added
disable_until_first_user_message(boolean, defaultfalse) to soft-timeout configuration and related override schemas - Added required read-only
status(success,error,blockedorskipped) to realtime agent tool response events - Added
avayato conversation initiation sources andavaya_api_keyto authorization methods - Added
gemini-3.6-flashandgemini-3.7-flashto supported agent LLM values - Changed
BackgroundSoundConfig.volumedefault from0.6to0.15andcrossfade_loopdefault fromfalsetotrue - Removed
CustomToolApiSchemaConfig; generated SDK users importing this type must remove the import - Removed
scim_external_idfromWorkspaceGroupResponseModel
August 10, 2026
Section titled “August 10, 2026”Dubbing v2 API
Section titled “Dubbing v2 API”Dubbing v2 is now available through the API. It translates audio and video into more than 90 languages while preserving each speaker's voice, tone and pacing.
The new project-based API keeps source transcripts and translations as editable JSON. Create a project from a file or URL, add one or more target languages, edit individual transcript segments or translations, then regenerate only the regions that changed. Follow the Dubbing quickstart to create your first dub.
Quickstart
Create your first Dubbing v2 project and generate a translated audio track.
Refine and regenerate
Edit source transcripts and translations, then regenerate changed regions.
API reference
Explore Dubbing project, language and transcript endpoints.
ElevenAgents
Section titled “ElevenAgents”- Conversation guardrail filters: List conversations adds optional
guardrail_types(GuardrailType[]) andcustom_guardrail_names(string array) query parameters. The existing conversation hierarchy can now be filtered with optionalparent_conversation_id(string). - Branch divergence status: List agent branches adds optional
include_commit_status(boolean, defaultfalse). When enabled, branch summaries include nullablecommits_ahead,commits_behindandmerged_into_branch_idfields. - Conversation and tool controls: Client overrides now support
max_duration_secondsandpronunciation_dictionary_locators. MCP server configuration addsrequest_metafor passing MCP_metavalues to tool calls, and webhook tool timeouts now support up to 300 seconds. - Post-call analysis usage: Conversation charging adds an
analysisbreakdown with per-feature running totals and run snapshots. Transcript messages addtriggered_guardrails, and conversation turns add optionalproducing_llm.
Voices
Section titled “Voices”- Voice search filters: Get all voices v2 adds optional
gender,age,language,accent,use_cases,min_notice_period_days,include_custom_rates,include_live_moderatedandhigh_qualityquery parameters.
SDK Releases
Section titled “SDK Releases”JavaScript SDK
Section titled “JavaScript SDK”- v2.63.0 - Added realtime Speech to Text options for secondary languages, language and entity detection, background audio filtering, logging and single-use token authentication. Added final transcript, entity and invalid request events; fixed unaccepted terms dispatch, duplicate
audio_formatparameters and inclusive VAD bounds. - v2.62.0 - Added Dubbing bulk transcript update methods and
DubbingRegenerateResponse; added conversation guardrail filters, agent branch commit status, agent alerting and MCPrequestMetasupport. Language target creation no longer acceptsmodelId. - v2.61.0 - Added conversation hierarchy filtering, post-call analysis charging, triggered guardrail metadata, branch merge conflict details, DTMF input redaction and Dubbing transcript uploads. Removed exported OpenAI realtime session types and
run_subagent_*tool-result variants.
Python SDK
Section titled “Python SDK”- v2.63.0 - Added realtime Speech to Text options for secondary languages, language and entity detection, background audio filtering, logging and single-use token authentication. Added final transcript, entity and invalid request events; fixed unaccepted terms dispatch and now rejects connections without an API key or token.
- v2.62.0 - Added Dubbing
update_segmentsmethods andDubbingRegenerateResponse; addedguardrail_types,custom_guardrail_names,include_commit_statusand MCPrequest_metasupport. Dubbing segment updates now use request body models, and language target creation no longer acceptsmodel_id. - v2.61.0 - Added
parent_conversation_id, analysis charging, triggered guardrail metadata, branch merge conflicts, DTMF input redaction and Dubbing transcript uploads. Removed OpenAI realtime session types andrun_subagent_*result models.
Android SDK
Section titled “Android SDK”- v0.12.1 - Fixed intentional text-only session disconnects being reported as
ConversationStatus.ERROR. - v0.12.0 - Added
ConversationConfig.useMediaStreamfor routing conversation audio through the Android media stream. Remote normal WebSocket closures now reportDisconnectionDetails.Agent, while locally initiated closures reportDisconnectionDetails.User.
MCP Server
Section titled “MCP Server”- v0.12.2 - Fixed an issue with path traversal.
View API changes
New Endpoints
Dubbing
- Batch update source segments -
PATCH /v1/dubbing/project/{project_id}/transcript/segments- Requires
DubbingBulkSegmentUpdateRequest - Atomically updates source segment text, speaker or timing
- Returns
DubbingBulkSourceSegmentUpdateResponsewith the updatedsegmentsandrevision
- Requires
- Batch update target segments -
PATCH /v1/dubbing/project/{project_id}/language/{language_id}/transcript/segments- Requires
DubbingBulkTargetSegmentUpdateRequest - Atomically updates translations for multiple target segments
- Returns
DubbingBulkTargetSegmentUpdateResponsewith the updatedsegmentsandrevision
- Requires
Updated Endpoints
ElevenAgents
- List conversations -
GET /v1/convai/conversations- Added optional
parent_conversation_id(string) - Added optional repeatable
guardrail_types(GuardrailType[]) andcustom_guardrail_names(string array)
- Added optional
- List agent branches -
GET /v1/convai/agents/{agent_id}/branches- Added optional
include_commit_status(boolean, defaultfalse) - Branch summaries add nullable
commits_ahead(integer),commits_behind(integer) andmerged_into_branch_id(string)
- Added optional
Voices
- Get all voices v2 -
GET /v2/voices- Added optional
gender,ageandaccent(string) filters - Added optional
languageanduse_cases(string array) filters - Added optional
min_notice_period_days(integer),include_custom_rates,include_live_moderatedandhigh_quality(boolean) filters
- Added optional
Schema Changes
ElevenAgents
- Client override schemas add
max_duration_seconds(integer) andpronunciation_dictionary_locators(array) - MCP server input and output schemas add
request_metamaps - Agent platform settings add
alerting; language detection addsonly_at_conversation_start(boolean) AnalysisCharging.last_runis now required and non-nullable; running totals add requiredruns(integer)- RAG chunk responses now require
content_formatanddocument_type
August 3, 2026
Section titled “August 3, 2026”ElevenAgents
Section titled “ElevenAgents”- Test-specific tool mocks: Agent simulations and unit tests can now define
tool_mock_overrides, keyed by tool ID, to replace shared mocks for one test.ToolResponseMockConfigalso adds optionalis_error(boolean, defaultfalse) so a mock can exercise tool-failure paths. - Translated workflow messages: Literal Say node messages add
text_translations, a map of language keys toTranslatedStringobjects. The field is optional on input and required on output, so strict response validators must accept it. - Conversation version filters: List conversations and Text search conversation messages add the optional
version_idquery parameter (string) to filter results by agent version. - Knowledge base system tool: Agent configuration adds a
knowledge_basesystem tool with configurableenabled_strategies(SearchStrategy[]). Agent knowledge base RAG queries add optionaluse_agent_defaults(boolean, defaulttrue); set it tofalseto use neutral retrieval settings while retaining the agent's embedding model. - Agent voice activity detection: Agent create, update, response and workflow-override schemas add
vadconfiguration.VADConfigcurrently supportsbackground_voice_detection(boolean, defaultfalse). - WebSocket custom LLMs:
CustomLLMAPITypeaddswebsocket. - File memory controls: Widget file-input configuration adds
max_files_in_memory(integer, 1–30, default10). Files beyond the limit are summarized and released from memory;max_files_per_conversationmust be-1or at least the memory limit. - DTMF input redaction:
DTMFInputConfigadds optionalredact_input(boolean, defaultfalse) to replace caller keypad digits in transcripts, conversation logs and analysis. Digits repeated by the agent or passed to tools remain unchanged.
Speech to Text
Section titled “Speech to Text”- Realtime entity detection: Scribe v2 Realtime adds the
entity_detectionquery option. It acceptsall, one entity type or category, or an array of types and categories, and emits detected entities incommitted_transcript_entitiesevents. See the entity detection guide for supported categories.
Voices
Section titled “Voices”- Voice replication across data residencies: Added
POST /v1/voices/{voice_id}/replicate-to-isolated-environmentfor copying an Instant Voice Clone or Voice Design voice to a workspace in the same consolidated billing group. Requests requiretarget_workspace_id(string) and acceptpreserve_voice_id(boolean, defaulttrue); responses return the targetvoice_id. - Character metadata: Character responses add
recommended_voice_ids(string array, default[]), metadata adds nullablerole(CharacterRole), andCharacterAgereplacesmiddle-agedwithmiddle_aged.
SDK Releases
Section titled “SDK Releases”Packages
Section titled “Packages”- @elevenlabs/client@1.16.0, @elevenlabs/react@1.11.0, @elevenlabs/types@0.18.0, @elevenlabs/react-native@1.2.17 and @elevenlabs/convai-widget-core@0.15.0 - Added
onAgentReasoningResponsePart, which receives streaming agent reasoning events withstart,deltaandstoptypes. - @elevenlabs/convai-widget-core@0.15.0 and @elevenlabs/convai-widget-embed@0.15.0 - Added
show_resize_buttonand theshow-resize-buttonembed attribute. Set either tofalseto hide the widget header's expand and collapse control. - @elevenlabs/client@1.17.0, @elevenlabs/react@1.12.0, @elevenlabs/types@0.19.0, @elevenlabs/react-native@1.2.18 and @elevenlabs/convai-widget-core@0.15.1 - Added the
enableLoggingoption toScribe.connectanduseScribe. Setting it tofalsestarts an enterprise zero-retention session. The Scribesession_startedtype now reportsenable_logging; the unuseddisable_loggingfield was removed.
MCP Server
Section titled “MCP Server”- v0.12.1 - Includes the v0.11 tool updates and a dependency refresh that resolves 44 security alerts.
- v0.11.0 - Added
simulate_conversationwith configurable simulated-user behavior, evaluation criteria, transcript output and pass/fail analysis. Thespeech_to_texttool now defaults toscribe_v2, andvoice_clonenow sends audio file contents instead of path strings.
View API changes
New Endpoints
Voices
POST /v1/voices/{voice_id}/replicate-to-isolated-environment- Replicates an Instant Voice Clone or Voice Design voice into another workspace's isolated environment
- Requires
target_workspace_id(string) - Accepts optional
preserve_voice_id(boolean, defaulttrue) - Returns required
voice_id(string)
Updated Endpoints
ElevenAgents
- List conversations -
GET /v1/convai/conversations- Added optional
version_id(string) query parameter
- Added optional
- Text search conversation messages -
GET /v1/convai/conversations/messages/text-search- Added optional
version_id(string) query parameter
- Added optional
POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query- Added optional
use_agent_defaults(boolean, defaulttrue) request field
- Added optional
Schema Changes
ElevenAgents
- Simulation and unit-test payloads add optional
tool_mock_overridesmaps;ToolResponseMockConfigadds optionalis_error(boolean, defaultfalse) SayNodeLiteralMessageaddstext_translations(map ofTranslatedString); the field is optional on input and required on output- Agent configuration adds
knowledge_base(KnowledgeBaseToolConfig) andvad(VADConfig) CustomLLMAPITypeaddswebsocketFileInputConfigaddsmax_files_in_memory(integer, 1–30, default10)DTMFInputConfigadds optionalredact_input(boolean, defaultfalse)- Realtime agent configuration now defaults to
eleven_realtime_v1_mini
Voices
- Character responses add
recommended_voice_ids(string array, default[]) - Character metadata adds nullable
role(CharacterRole) - Breaking:
CharacterAgereplacesmiddle-agedwithmiddle_aged; clients sending the old value must migrate
Text to Speech
- Breaking: removed
AudioFilterIdandaudio_filterfrom ElevenAgents Text to Speech configuration schemas
July 27, 2026
Section titled “July 27, 2026”ElevenAgents
Section titled “ElevenAgents”- WhatsApp branch and environment overrides: Outbound WhatsApp messages and outbound calls now honor
branch_idandenvironmentpassed inconversation_initiation_client_data. Overrides are validated before anything is sent — an unknown branch or environment is rejected with an error — and persist for the conversation, so a customer's reply resumes on the requested branch and environment. See the WhatsApp guide for examples. - Procedure APIs: Added eight public, branch-scoped operations for managing procedures. You can create, list, retrieve and remove procedures; create, retrieve or discard draft changes; and compile procedure drafts into an agent workflow. Procedure creation accepts
name,content,typeandtrigger. An emptytriggercreates a sub-procedure, while an omitted ornulltrigger is derived from the procedure content. - Knowledge base crawl jobs: Added APIs to create, list, inspect and cancel crawl jobs. Create requests require
url(string) and support crawl depth, page limits, URL patterns, sitemap URLs, folder placement, automatic synchronization and removal of unavailable documents. - Bulk knowledge base management: Added bulk dependency checks and bulk deletion for 1–20 unique document or folder IDs. Dependency checks support pagination and
dependent_type; deletion returns an independent success or failure for each ID. Settingforce: truealso removes dependencies and recursively deletes non-empty folders. - Batch call result export: Added Export batch call results to download recipients and conversation results from a terminal batch as CSV.
- Conversation filters and analysis data: List conversations and Text search conversation messages add optional
visited_agent_idsandvisited_agent_branch_idsarray filters, each limited to 50 values. List requests also acceptdata_collection_idsandevaluation_criteria_idsto include corresponding results in each conversation summary. Summaries add optionaldata_collection_results,evaluation_criteria_resultsandtag_ids. - Referenced analysis configuration: Agent platform settings add the optional, nullable
analysis_itemsfield, typed asAgentAnalysisItems, to attach evaluation and data-collection items by reference. Anullvalue indicates that the agent still uses the legacy inline fields; an empty value indicates a migrated agent with no attached items. - Procedure dependency metadata: Procedure references add
trigger(string) and arrays forreferenced_tool_ids,referenced_kb_ids,referenced_procedure_idsandreferenced_dynamic_variables. - WebRTC token response: Get WebRTC token responses now require
conversation_id(string) in addition totoken. This is a breaking schema change for clients that validate or deserialize the response shape. - Knowledge base RAG results:
KnowledgeBaseRagToolResultModeladdschunks(KnowledgeBaseRagChunkModel[]) for RAG-result-in-tool-result mode.
Studio
Section titled “Studio”- Draft project status:
ProjectCreationMetaResponseModel.statusaddsdraft. The project creation type now uses the sharedProjectCreationMetaTypeenum with the same existing values.
Voices
Section titled “Voices”- Voice accents: Added
GET /v1/voices/accentsto list the accents available in the shared voice library. Results can be filtered bylanguageandmodel_id, and each accent returns itsaccent,language,codeand human-readablename. Theaccentvalue can be passed to theaccentquery parameter on Get shared voices to filter shared voices.
Workspaces
Section titled “Workspaces”- Webhook usage reporting:
WebhookUsageTypeaddsFlows.
SDK Releases
Section titled “SDK Releases”JavaScript SDK
Section titled “JavaScript SDK”- v2.60.0 - Added
voices.accents.getto list voice accents in the shared voice library, along with the ElevenAgents procedure, knowledge base crawl job and bulk management APIs and the referenced analysis configuration from the latest schema.
Python SDK
Section titled “Python SDK”- v2.60.0 - Added the voice accents, ElevenAgents procedure, knowledge base crawl job and bulk management APIs from the latest schema. Also fixed
AsyncConversationstartup so it no longer blocks, and corrected list-of-primitive multipart fields to be sent as repeated form fields.
Packages
Section titled “Packages”- @elevenlabs/client@1.15.2 - Fixed
onAudioAlignmenton WebRTC transports by forwarding alignment metadata from audio messages while leaving audio playback on the LiveKit track. - @elevenlabs/react@1.10.2, @elevenlabs/react-native@1.2.16, @elevenlabs/convai-widget-core@0.14.12 and @elevenlabs/convai-widget-embed@0.14.12 - Updated dependencies to include the WebRTC alignment fix from
@elevenlabs/client@1.15.2.
View API changes
New Endpoints
ElevenAgents
POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures- Creates a procedure and returns its
procedure_id(string) - Accepts optional
name(string, maximum 200 characters),content(string),type(ProcedureType, defaultfree_form) andtrigger(nullable string)
- Creates a procedure and returns its
GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures- Lists branch procedures with
procedure_id,version_id,name,type,triggerandhas_draft - Excludes procedure content; retrieve an individual procedure to read its content
- Lists branch procedures with
GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}- Accepts optional
version_id(string); otherwise returns the version at the branch head - Returns
name,content,typeandtrigger
- Accepts optional
DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}- Removes the procedure from the branch's draft working set
GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft- Returns the current procedure draft
PATCH /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft- Creates or updates a draft
- Requires
name(string, maximum 200 characters),content(string, maximum 50,000 characters) andtype(ProcedureType); accepts optionaltrigger(nullable string)
DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft- Discards draft changes and resets the procedure to its committed version
POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/compile- Compiles procedure drafts into an
AgentWorkflowResponseModel
- Compiles procedure drafts into an
- Create crawl job -
POST /v1/convai/knowledge-base/crawl- Requires
url(string) - Accepts optional
max_depth(integer, 1–5, default3),max_pages(integer, 1–10,000, default1000),pattern(string),sitemap_urls(string array),parent_folder_id(string),enable_auto_sync(boolean, defaultfalse) andauto_remove(boolean, defaultfalse)
- Requires
- List crawl jobs -
GET /v1/convai/knowledge-base/crawl- Accepts optional
include_job_ids(string array),page_size(integer, 1–100, default30) andcursor(string)
- Accepts optional
- Get crawl job -
GET /v1/convai/knowledge-base/crawl/{crawl_job_id} - Cancel crawl job -
POST /v1/convai/knowledge-base/crawl/{crawl_job_id}/cancel - Get dependent agents for multiple documents -
POST /v1/convai/knowledge-base/dependent-agents- Requires
document_ids(array of 1–20 unique strings) - Accepts optional
dependent_type(KnowledgeBaseDependentType, defaultall),page_size(integer, 1–100, default30) andcursor(string)
- Requires
- Bulk delete knowledge base documents -
POST /v1/convai/knowledge-base/bulk-delete- Requires
document_ids(array of 1–20 unique strings) - Accepts optional
force(boolean, defaultfalse) - Returns a success or failure result for each document ID
- Requires
- Export batch call results -
GET /v1/convai/batch-calling/{batch_id}/export- Returns terminal batch recipients and conversation results as CSV
Voices
GET /v1/voices/accents- Lists the accents available in the shared voice library
- Accepts optional
language(string) andmodel_id(string) query parameters - Each accent returns
accent,language,codeandname
Updated Endpoints
ElevenAgents
- List conversations -
GET /v1/convai/conversations- Added optional
visited_agent_idsandvisited_agent_branch_idsstring array filters, each limited to 50 values - Added optional
data_collection_idsandevaluation_criteria_idsstring arrays to select analysis results for each summary - Response summaries add the optional object fields
data_collection_resultsandevaluation_criteria_results, plus the string arraytag_ids
- Added optional
- Text search conversation messages -
GET /v1/convai/conversations/messages/text-search- Added optional
visited_agent_idsandvisited_agent_branch_idsstring array filters, each limited to 50 values
- Added optional
- Get WebRTC token -
GET /v1/convai/conversation/token- Responses now require
conversation_id(string) - Breaking: strict response validators and deserializers must accept the new required field
- Responses now require
Schema Changes
ElevenAgents
- Agent platform request and response settings add the optional, nullable
analysis_itemsfield, typed asAgentAnalysisItems, for referenced evaluation and data-collection configuration - Procedure references add
trigger(string),referenced_tool_ids(string array),referenced_kb_ids(string array),referenced_procedure_ids(string array) andreferenced_dynamic_variables(string array) KnowledgeBaseRagToolResultModeladdschunks(KnowledgeBaseRagChunkModel[])
Studio
ProjectCreationMetaResponseModel.statusaddsdraftProjectCreationMetaResponseModel.typenow references the sharedProjectCreationMetaTypeenum
Workspaces
WebhookUsageTypeaddsFlows
July 20, 2026
Section titled “July 20, 2026”- Music Finetunes API: Added API support for managing Music Finetunes. Five endpoints let you create a Finetune from uploaded audio, list accessible Finetunes, retrieve training status, update metadata and visibility, or delete a Finetune. All music generation SDK methods now expose
finetune_id.
ElevenAgents
Section titled “ElevenAgents”- Resolve external conversation references: Added
GET /v1/convai/conversations/resolveto resolve a Slack message URL or Zendesk ticket URL to a conversation. Requests requireagent_idandreferencequery parameters (strings). - Query agent knowledge bases: Added
POST /v1/convai/agents/{agent_id}/knowledge-base/rag-queryfor read-only RAG queries against an agent's knowledge base. The request requiresquery(string), accepts optionalbranch_id(string), and returns ranked chunks with document, chunk, text and vector-distance metadata. This endpoint is excluded from generated SDKs. - Knowledge base content formats: Knowledge base file, text and URL responses add optional
content_format(html|markdown, defaulthtml). - Agent voice configuration: TTS override schemas add optional client-overridable
model_id(TTSConversationalModel). The default forenable_phoneme_tagschanges fromfalsetotrue. - Faster backup LLM cascade: The default
cascade_timeout_secondschanges from 8 to 4 seconds. The allowed range remains 2–15 seconds. - Tool parameter value sources: Object tool parameters can now use
dynamic_variable,constant_valueoris_omitted, matching existing scalar and array controls. Constant schema overrides now accept arbitrary arrays and objects. - Full-response guardrails: Custom guardrails add optional
evaluate_full_response_only(boolean, defaultfalse) to evaluate the complete non-TTS response once. This option requires blocking mode. - Twilio call recording: Telephony call configuration adds optional
twilio_call_recording_enabled(boolean, defaultfalse). Recordings are stored in the connected Twilio account and the setting is ignored by other providers. - Widget file-upload text: Widget text configuration adds optional labels and error messages for attaching and removing files, upload failures, unsupported types, oversized files, file-count limits and the typing indicator.
- Knowledge base sync status: Knowledge base file responses add optional
auto_sync_infoandrefresh_status(FileRefreshStatus). Folder responses add requireddocument_count(integer), a recursive count of non-folder documents capped at 1000. - Conversation text search filters: Text search conversation messages adds optional
exclude_statusesandtermination_reasonsarray query parameters. - LLM options: Agent LLM configuration adds
gpt-5.6-sol,gpt-5.6-terraandgpt-5.6-luna.LLMReasoningEffortaddsmax. - WhatsApp typing indicators: WhatsApp account request and response schemas add optional
enable_typing_indicator(boolean).
Speech to Text
Section titled “Speech to Text”- Single-use batch authentication: Convert speech to text adds optional
token(string) as an alternative to API key or bearer authentication. Create the single-use token withPOST /v1/single-use-token/batch_scribe; it expires after 15 minutes. - Realtime client reliability:
@elevenlabs/clientnow reports microphone setup and malformed server errors throughRealtimeEvents.ERROR, releases microphone resources after setup failures and connection closure, and drops late microphone frames after socket teardown.
Text to Speech
Section titled “Text to Speech”- Archived pronunciation dictionaries: List pronunciation dictionaries adds optional
include_archived(boolean, defaulttrue).
Workspaces
Section titled “Workspaces”- Webhook event subscriptions: Update workspace webhook requests add optional
events(WorkspaceWebhookEventType[]) withvoice_library_removal_notice,speech_to_textandagent_qa. Webhook responses can return the subscribed event list. - Usage analytics dimensions: Get workspace usage adds
surfaceandactorto thegroup_byvalues. - Clear service account limits: Update service account API key accepts
character_limit: "clear"to remove a monthly character limit, alongside"no_update"and integer values. - Alerting webhook references: Alerting webhook notifier schemas now identify a workspace webhook with required
webhook_id(string) instead of embeddingurl,methodandheaders.
SDK Releases
Section titled “SDK Releases”JavaScript SDK
Section titled “JavaScript SDK”- v2.59.0 - Added
music.finetunesmethods to list, create, get, update and delete Music Finetunes. Also added conversation reference resolution, archived pronunciation dictionary filtering and single-use Speech to Text tokens.
Python SDK
Section titled “Python SDK”- v2.59.0 - Added Music Finetunes and conversation reference resolution from the latest API schema.
OnPremInitiationDataalso adds typedpost_call_transcription_webhookandpost_call_audio_webhookconfigurations with optionalhmac_secretfor signed post-call webhooks.
Packages
Section titled “Packages”- @elevenlabs/client@1.15.1 - Improved Scribe Realtime error delivery and microphone cleanup during setup failures, client or server closure, and late audio frames.
- @elevenlabs/react@1.10.1, @elevenlabs/react-native@1.2.15, @elevenlabs/convai-widget-core@0.14.11 and @elevenlabs/convai-widget-embed@0.14.11 - Updated dependencies to include the
@elevenlabs/client@1.15.1Scribe Realtime fixes.
Android SDK
Section titled “Android SDK”- v0.11.1 - Prevented R8 and ProGuard from obfuscating outgoing WebSocket and WebRTC event fields such as
textandtype.
- @elevenlabs/cli@0.5.6 - Updated default agent templates to use
scribe_realtimeinstead of the removedelevenlabsASR provider. Minimal templates continue to use the server default.
View API changes
New Endpoints
Music
- List Music Finetunes -
GET /v1/music/finetunes- Supports cursor pagination, visibility and creator filters, and sorting by creation time or name
- Create Music Finetune -
POST /v1/music/finetunes- Requires
nameandprimary_genre - Accepts up to 50 audio files, tags, visibility and
model_id
- Requires
- Get Music Finetune -
GET /v1/music/finetunes/{finetune_id} - Update Music Finetune -
PATCH /v1/music/finetunes/{finetune_id}- Updates
name,tags,primary_genreorvisibility
- Updates
- Delete Music Finetune -
DELETE /v1/music/finetunes/{finetune_id}
ElevenAgents
GET /v1/convai/conversations/resolve- Requires
agent_id(string) andreference(string) query parameters - Returns
GetConversationResponseModel
- Requires
POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query- Requires
query(string) in the request body - Accepts optional
branch_id(string) query parameter - Returns
AgentKnowledgeBaseRagQueryResponseModel - Excluded from generated SDKs
- Requires
Updated Endpoints
ElevenAgents
- Text search conversation messages -
GET /v1/convai/conversations/messages/text-search- Added optional
exclude_statusesandtermination_reasonsarray query parameters
- Added optional
Speech to Text
- Convert speech to text -
POST /v1/speech-to-text- Added optional
token(string) query parameter for a single-use batch Scribe token
- Added optional
Text to Speech
- List pronunciation dictionaries -
GET /v1/pronunciation-dictionaries- Added optional
include_archived(boolean, defaulttrue) query parameter
- Added optional
Workspaces
- Update workspace webhook -
PATCH /v1/workspace/webhooks/{webhook_id}- Added optional
events(WorkspaceWebhookEventType[]) request field
- Added optional
- Get workspace usage -
POST /v1/workspace/analytics/query/usage-by-product-over-time- Added
surfaceandactorto the optionalgroup_byarray
- Added
- Update service account API key -
PATCH /v1/service-accounts/{service_account_user_id}/api-keys/{api_key_id}- Added
"clear"to the optionalcharacter_limitfield
- Added
Schema Changes
ElevenAgents
- ElevenAgents knowledge base response schemas add optional
content_format(html|markdown, defaulthtml) - Knowledge base file responses add optional
auto_sync_infoandrefresh_status(FileRefreshStatus) - Knowledge base folder responses add required
document_count(integer) - Agent TTS override schemas add optional
model_id(TTSConversationalModel) - Agent TTS
enable_phoneme_tagsnow defaults totrueinstead offalse - Backup LLM
cascade_timeout_secondsnow defaults to 4 instead of 8 seconds - Agent LLM configuration adds
gpt-5.6-sol,gpt-5.6-terraandgpt-5.6-luna;LLMReasoningEffortaddsmax - Custom guardrails add optional
evaluate_full_response_only(boolean, defaultfalse) - Telephony call configuration adds optional
twilio_call_recording_enabled(boolean, defaultfalse) - Object tool parameters add
dynamic_variable,constant_valueandis_omitted; constant overrides accept arbitrary array and object values - Widget text configuration adds optional file-upload and typing-indicator labels
- WhatsApp account schemas add optional
enable_typing_indicator(boolean) - Simulation and testing schemas add
AutoGenerationMetadataandSimulationLibrarySettings
Music
- Added Music Finetune request, response, pagination, visibility, creator, status and failure-reason schemas
- All Music generation request schemas expose
finetune_idto generated SDKs
Workspaces
- Workspace webhook request and response schemas add optional
events(WorkspaceWebhookEventType[]) - Alerting webhook notifier schemas use required
webhook_id(string) instead ofurl,methodandheaders
July 13, 2026
Section titled “July 13, 2026”ElevenAgents
Section titled “ElevenAgents”- Per-agent sentiment analysis: Platform settings add optional
sentiment_analysis(SentimentAnalysisSettings) for post-call sentiment scoring configuration per agent. - Auto-translate transcripts: Platform settings add optional
auto_translate_transcript_to_app_language(boolean) to translate conversation transcripts to the viewer's app language in history. - Nested agent transfers: Workflows add push, pop and replace operations for nested agent transfers, with
enable_nestingandreturn_when_nestedcontrols for returning to a parent workflow. - Backchannel detection: Transcript user-turn models add optional
ignored_as_backchannel(boolean) to mark utterances filtered as backchannels. - Auxiliary conversation audio: Get conversation responses add required
has_auxiliary_audio(boolean) alongside existing audio flags. - MCP environment scoping: MCP server and tool routes add optional
environmentquery parameter (defaults to production) on list tools, get tool, create tool config and update tool config endpoints. - Tool call sound override: Tool and MCP override schemas allow
tool_call_sound: "off"to silence per-tool call sounds while inheriting server defaults when unset. - Twilio SMS routing: Twilio phone-number import requests add optional
enable_sms(boolean, default on) to control inbound SMS routing during number setup. - User sentiment sorting: List users adds optional
sort_directionand supports sorting byaverage_sentiment_score. - Knowledge base external sync: External sync schemas rename
ExternalSyncTypetoExternalSyncProvider, add sync job trigger and type enums withKbExternalSyncJob, and folder responses can includeactive_sync_jobfor in-flight or terminal sync status. - TTS latency setting deprecation:
optimize_streaming_latencyon agent TTS settings is marked deprecated and documented as a no-op.
Workspaces
Section titled “Workspaces”- Create service accounts: Added Create service account (
POST /v1/service-accounts) with optionaldefault_sharing_groups(DefaultSharingGroupConfig) for programmatic service-account provisioning. - List workspace members: Added Get workspace members (
GET /v1/workspace/members) returningWorkspaceMemberResponseModelentries with user id, email, seat status, owner and locked flags. Service accounts are excluded. - Invite credit caps: Workspace invite payloads (single and bulk) add optional
usage_limitfor a monthly credit cap on invitees.
SDK Releases
Section titled “SDK Releases”JavaScript SDK
Section titled “JavaScript SDK”- v2.57.0 - Regenerated from the latest OpenAPI schema with
run_subagentsystem tool types, per-agent sentiment analysis settings, nested agent transfer workflow models, knowledge base external sync types, and MCPenvironmentquery parameters. - v2.58.0 - Regenerated from the latest OpenAPI schema with service account creation, workspace member listing, invite
usage_limit, conversationhas_auxiliary_audio, and multi-context text-to-dialogue WebSocket message types.
Python SDK
Section titled “Python SDK”- v2.57.0 - Regenerated from the latest OpenAPI schema with
run_subagentsystem tool models, per-agent sentiment analysis settings, nested agent transfer workflow models, knowledge base external sync types, and MCPenvironmentquery parameters. - v2.58.0 - Regenerated from the latest OpenAPI schema with service account creation, workspace member listing, invite
usage_limit, conversationhas_auxiliary_audio, and multi-context text-to-dialogue WebSocket message types.
Packages
Section titled “Packages”- @elevenlabs/client@1.15.0 - Added
onPingcallback exposingpingevents and estimatedping_msfor connection latency monitoring. - @elevenlabs/react@1.10.0 - Exposed the
onPingcallback from@elevenlabs/client@1.15.0in React hooks. - @elevenlabs/types@0.17.1, @elevenlabs/convai-widget-core@0.14.10 and @elevenlabs/convai-widget-embed@0.14.10 - Dependency alignment to
@elevenlabs/client@1.15.0.
View API changes
New Endpoints
Workspaces
- Create service account -
POST /v1/service-accounts - Get workspace members -
GET /v1/workspace/members
Updated Endpoints
ElevenAgents
- Get conversation -
GET /v1/convai/conversations/{conversation_id}- Added required
has_auxiliary_audio(boolean) to response
- Added required
- List users -
GET /v1/convai/users- Added optional
sort_directionquery parameter - Added
average_sentiment_scoreas a sort option
- Added optional
- Get tool -
GET /v1/convai/tools/{tool_id}- Added optional
environmentquery parameter
- Added optional
- List MCP server tools -
GET /v1/convai/mcp-servers/{mcp_server_id}/tools- Added optional
environmentquery parameter
- Added optional
- Create MCP tool config -
POST /v1/convai/mcp-servers/{mcp_server_id}/tool-configs- Added optional
environmentquery parameter
- Added optional
- Update MCP tool config -
PATCH /v1/convai/mcp-servers/{mcp_server_id}/tool-configs/{tool_name}- Added optional
environmentquery parameter
- Added optional
Workspaces
- Invite user -
POST /v1/workspace/invites/add- Added optional
usage_limitfor monthly invitee credit cap
- Added optional
- Invite multiple users -
POST /v1/workspace/invites/add/bulk- Added optional
usage_limitfor monthly invitee credit cap
- Added optional
Schema Changes
ElevenAgents
- System tools
- Added
run_subagent(RunSubagentToolConfig) with requiredagentsarray
- Added
- Platform settings
- Added optional
sentiment_analysis(SentimentAnalysisSettings) - Added optional
auto_translate_transcript_to_app_language(boolean)
- Added optional
- Workflows
- Added nested
AgentTransfermodeling withAgentTransferOppush, pop and replace - Added
enable_nestingandreturn_when_nestedworkflow flags
- Added nested
- Transcripts
- Added optional
ignored_as_backchannel(boolean) on user-turn models
- Added optional
- Tools and MCP
- Added
tool_call_sound: "off"override support on tool config models - Deprecated
optimize_streaming_latencyon TTS agent settings (no-op)
- Added
- Telephony
- Added optional
enable_sms(boolean) on Twilio phone-number import requests
- Added optional
- Knowledge base
- Renamed
ExternalSyncTypetoExternalSyncProvider - Added
KbExternalSyncJob, sync job trigger and type enums - Added optional
active_sync_jobon folder responses
- Renamed
- Sentiment
- Expanded
SentimentAggregatewith recent-window counts and average scores
- Expanded
Workspaces
- Service accounts
- Added
WorkspaceCreateServiceAccountResponseModelfor create responses - Added optional
default_sharing_groupson create requests
- Added
- Members
- Added
WorkspaceMemberResponseModelfor list responses
- Added
- Invites
- Added optional
usage_limiton single and bulk invite request bodies
- Added optional
July 6, 2026
Section titled “July 6, 2026”- Stream music with details: Added Stream music with details (
POST /v1/music/detailed/stream) for SSE streaming of composed audio plus detailed metadata, including composition plan, song metadata, base64 audio chunks and optional word timestamps viawith_timestamps.
ElevenAgents
Section titled “ElevenAgents”- Simulate conversation deprecation: Simulate conversation and Stream simulate conversation are deprecated in favor of Create test and Run tests on the agent.
- Tool interruption mode:
disable_interruptionsis deprecated across agent tool and MCP server schemas. Useinterruption_mode(ToolInterruptionMode:allow,disable_during_tool,disable_during_tool_and_turn) instead, with per-tool overrides viainterruption_modeon tool override models. - Numeric evaluation scoring: Evaluation criteria schemas add optional
scoring_mode(binary|numeric_uniform), optionalmax_score(integer) and optionalscore_instructions(string). Evaluation results add optional numericscore. Conversation analysis payloads add optionalcall_success_scoreandsuccess_score. - Conversation reasoning: Transcript and history models add optional
reasoning(ConversationReasoningModel) and transcript responses add optionalreasoned(boolean). Agent prompt and LLM schemas add optionalenable_reasoning_summary(boolean). - Conversation platform billing: Conversation-related models add optional
platform_charge,platform_priceandplatform_usagewith per-category breakdown viaPlatformCategoryandPlatformCategoryUsage. - Conversation cost metadata: Conversation history metadata adds required read-only
cost_fiat(number, USD). - Unredacted webhook events:
WebhookEventTypeaddsunredacted_transcriptandunredacted_audiofor webhook subscriptions that need unredacted payloads. - Workflow phone transfer UUI limit:
UUITransferConfig.datamaximum length increases from 256 to 8192 characters for RFC 7433 User-to-User Information on SIP REFER transfers.
Speech Engine
Section titled “Speech Engine”- Optional authentication bypass: JavaScript and Python SDK v2.56.0 add optional
disableAuth/disable_authon Speech Engine WebSocket clients. This is intended for integrations that protect the connection through other means, such as IP allowlisting or custom authentication headers, rather than API key authentication.
Workspaces
Section titled “Workspaces”- Professional voice slot tracking: Subscription-style models add optional
professional_voice_slots_used_in_workspacealongside clarified group-wideprofessional_voice_slots_usedfor consolidated billing visibility.
ElevenCreative Studio
Section titled “ElevenCreative Studio”- Caption styling: Caption style models add blur and border-radius fields. Enter and exit animation enums add
slam,scale_downandslide_in.
SDK Releases
Section titled “SDK Releases”JavaScript SDK
Section titled “JavaScript SDK”- v2.56.0 - Added optional
disableAuthon Speech Engine WebSocket clients. Regenerated from the latest OpenAPI schema with music detailed streaming, toolinterruption_mode, evaluation scoring modes, conversation reasoning and platform billing fields.
Python SDK
Section titled “Python SDK”- v2.56.0 - Added optional
disable_authon Speech Engine WebSocket clients. Regenerated from the latest OpenAPI schema with music detailed streaming, toolinterruption_mode, evaluation scoring modes, conversation reasoning and platform billing fields.
- @elevenlabs/cli@0.5.5 - Agent create and update requests are now sent as raw JSON to preserve configuration round-trip fidelity.
View API changes
New Endpoints
Music
- Stream music with details -
POST /v1/music/detailed/stream
Updated Endpoints
ElevenAgents
- Simulate conversation -
POST /v1/convai/agents/{agent_id}/simulate-conversation- Marked deprecated; use Create test and Run tests on the agent instead
- Stream simulate conversation -
POST /v1/convai/agents/{agent_id}/simulate-conversation/stream- Marked deprecated; use Create test and Run tests on the agent instead
Schema Changes
ElevenAgents
- Tools and MCP
- Deprecated
disable_interruptionsin favor ofinterruption_mode(allow,disable_during_tool,disable_during_tool_and_turn) - Added per-tool
interruption_modeoverrides on MCP and tool override models
- Deprecated
- Evaluation and analysis
- Added optional
scoring_mode,max_scoreandscore_instructionson evaluation criteria - Added optional numeric
scoreon evaluation results - Added optional
call_success_scoreandsuccess_scoreon conversation analysis payloads
- Added optional
- Transcripts and reasoning
- Added optional
reasoning(ConversationReasoningModel) on transcript and history models - Added optional
reasoned(boolean) on transcript responses - Added optional
enable_reasoning_summary(boolean) on agent prompt and LLM schemas
- Added optional
- Billing and metadata
- Added optional
platform_charge,platform_priceandplatform_usageon conversation models - Added required read-only
cost_fiat(USD) on conversation history metadata
- Added optional
- Webhooks
- Added
unredacted_transcriptandunredacted_audiotoWebhookEventType
- Added
- Workflows
- Increased
UUITransferConfig.datamax length from 256 to 8192 characters
- Increased
Workspaces
- Billing
- Added optional
professional_voice_slots_used_in_workspaceon subscription-style models
- Added optional
ElevenCreative Studio
- Captions
- Added blur and border-radius fields on caption style models
- Added
slam,scale_downandslide_inanimation types
June 29, 2026
Section titled “June 29, 2026”ElevenAgents
Section titled “ElevenAgents”- Branch merge and rebase previews: Added Preview merged configuration (
GET /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge-preview) and preview rebased configuration (GET /v1/convai/agents/{agent_id}/branches/{branch_id}/rebase-preview) to inspect merged or rebased agent configuration before committing. Both returnMergePreviewResponseModelwith the resulting config,overridden_fields, andsource_identical_to_target. - Branch usage metrics: List agent branches branch summary responses add optional
calls_7d(integer) with seven-day call volume per branch. - Auth connection status: Workspace auth connection response models replace OAuth-only
OAuthConnectionStatuswith sharedAuthConnectionStatus(active,refresh_failed,revoked,credential_invalid). Bearer, Basic, mTLS, custom header, OAuth, OAuth2 JWT, Slack, URL secret and WhatsApp auth responses add optionalstatus,status_detailandstatus_updated_atfields. - Tool response filtering: HTTP and agent tool configuration schemas add optional
response_filterto trim tool responses before they reach the LLM, withresponse_filter_modeandresponse_filterson related override models. - Workflow phone transfers: Workflow phone-number transfer nodes add optional
uui(UUITransferConfig) for RFC 7433 hex User-to-User Information on SIP REFER transfers. - Telephony agent assignment: Twilio, Exotel and SIP trunk phone-number import request schemas add optional
agent_id(string) to assign an agent during number setup. - Turn transcription on disabled interruptions: Turn configuration schemas add optional
transcribe_on_disabled_interruptions(boolean, defaultfalse) to control whether user speech is transcribed when interruptions are disabled. - Conversation sentiment: Conversation summary schemas add optional
sentiment_analysis. Conversation user models add optionalsentimentwith frustrated-conversation references.
Speech to Text
Section titled “Speech to Text”- Combined multichannel output: Convert speech to text adds optional
multichannel_output_style(separatedefault |combined) whenuse_multi_channelis enabled. Setcombinedto receive a single transcript with all channels merged and sorted by time instead of per-channel transcripts. Word-level responses includechannel_indexon each word when multichannel mode is active.
Text to Speech
Section titled “Text to Speech”language_codebehavior: TTS request schemas clarify that unsupportedlanguage_codevalues are ignored rather than rejected, and thatlanguage_codeis not supported onmultilingual_v2models.
Workspaces
Section titled “Workspaces”- Third-party API key disabling policy: Added Set workspace third-party disabling policy (
POST /v1/workspaces/api-keys/third-party-disabling) for workspace-wide control over whether API key holders can self-disable keys via the third-party disable endpoint. Workspace API key create, patch and response models add optionalthird_party_disable_allowed(boolean). - Bearer auth connection updates: Update workspace auth connection request union adds
UpdateBearerAuthRequestfor bearer token credential updates. - Workspace permissions: Permission enums add
conversation_privacy_manageandsynthid_detector. Workspace group models add optionalscim_group(string).
SDK Releases
Section titled “SDK Releases”JavaScript SDK
Section titled “JavaScript SDK”- v2.55.0 - Regenerated from the latest OpenAPI schema with branch merge and rebase preview clients, branch call-volume metrics, auth connection status fields, tool response filtering types, speech-to-text combined multichannel output, and workspace third-party API key disabling policy.
Python SDK
Section titled “Python SDK”- v2.55.0 - Regenerated from the latest OpenAPI schema with branch merge and rebase preview clients, branch call-volume metrics, auth connection status fields, tool response filtering models, speech-to-text combined multichannel output, and workspace third-party API key disabling policy.
Packages
Section titled “Packages”- @elevenlabs/client@1.13.0 -
sendFeedback(like, eventId?)accepts an optionalevent_idto rate a specific past message.canSendFeedbacknow reflects connection state so feedback can be sent for any message while the session is live. - @elevenlabs/client@1.14.0 -
sendFeedbackacceptsnullas the first argument to clear feedback on an event (score: null). - @elevenlabs/react@1.8.0 and @elevenlabs/react@1.9.0 - Exposed the per-message and clear-feedback
sendFeedbackchanges from@elevenlabs/client@1.13.0and@elevenlabs/client@1.14.0in React hooks. - @elevenlabs/react-native@1.2.11 and @elevenlabs/react-native@1.2.12 - Dependency alignment to
@elevenlabs/client@1.13.0–1.14.0and@elevenlabs/react@1.8.0–1.9.0. - @elevenlabs/types@0.16.0, @elevenlabs/convai-widget-core@0.14.6–0.14.8 and @elevenlabs/convai-widget-embed@0.14.6–0.14.8 - Dependency alignment to
@elevenlabs/client@1.13.0–1.14.0.
Android SDK
Section titled “Android SDK”- v0.10.0 - Exposed reconciled message transcript as
StateFlow. Deprecated text and agent callbacks in favor of event-id variants. - v0.11.0 - Added audio frame callback for per-frame audio inspection during conversations.
iOS SDK
Section titled “iOS SDK”- v3.2.2 - Fixed LiveKit room delegate method implementation for correct room event handling.
View API changes
New Endpoints
ElevenAgents
GET /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge-preview- Preview merged configuration before mergeGET /v1/convai/agents/{agent_id}/branches/{branch_id}/rebase-preview- Preview rebased configuration before rebase
Workspaces
POST /v1/workspaces/api-keys/third-party-disabling- Set workspace third-party API key disabling policy
Updated Endpoints
ElevenAgents
- List agent branches -
GET /v1/convai/agents/{agent_id}/branches- Branch summary responses add optional
calls_7d(integer)
- Branch summary responses add optional
- Preview merged configuration -
GET /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge-preview- Returns
MergePreviewResponseModelwith merged config,overridden_fieldsandsource_identical_to_target
- Returns
- Preview rebased configuration -
GET /v1/convai/agents/{agent_id}/branches/{branch_id}/rebase-preview- Returns
MergePreviewResponseModelwith rebased config preview
- Returns
Speech to Text
- Convert speech to text -
POST /v1/speech-to-text- Added optional
multichannel_output_style(separate|combined) whenuse_multi_channelis enabled - Word-level responses include
channel_indexper word in multichannel mode
- Added optional
Workspaces
- Set workspace third-party disabling policy -
POST /v1/workspaces/api-keys/third-party-disabling- Controls whether API key holders can self-disable keys via the third-party disable flow
- Update workspace auth connection -
PATCH /v1/workspace/auth-connections/{auth_connection_id}- Request union adds
UpdateBearerAuthRequest
- Request union adds
Schema Changes
ElevenAgents
- Auth connections
- Replaced
OAuthConnectionStatuswithAuthConnectionStatus(active,refresh_failed,revoked,credential_invalid) - Added optional
status,status_detailandstatus_updated_aton auth connection response models
- Replaced
- Tools and workflows
- Added optional
response_filteron HTTP and agent tool configs - Added optional
uui(UUITransferConfig) on transfer-related workflow models
- Added optional
- Turn configuration
- Added optional
transcribe_on_disabled_interruptions(boolean, defaultfalse)
- Added optional
- Telephony imports
- Added optional
agent_idon Twilio, Exotel and SIP trunk import request schemas
- Added optional
- Conversation models
- Added optional
sentiment_analysison conversation summary types - Added optional
sentimenton conversation user models
- Added optional
Text to Speech
- Clarified
language_codeis ignored when unsupported and not supported onmultilingual_v2
Workspaces
- API keys
- Added optional
third_party_disable_allowed(boolean) on create, patch and response models
- Added optional
- Permissions
- Added
conversation_privacy_manageandsynthid_detector
- Added
- Groups
- Added optional
scim_group(string) on workspace group models
- Added optional
June 22, 2026
Section titled “June 22, 2026”ElevenAgents
Section titled “ElevenAgents”- Branch rebase: Added
POST /v1/convai/agents/{agent_id}/branches/{branch_id}/rebaseto rebase a branch onto the latest main while preserving branch-specific changes. Agent version parent models add optionalrebased_from_version_id(string) to track the source version after a rebase. - Conversation product filtering: List conversations and Text search conversation messages add optional
conversation_product_typequery parameter (agents|speech_engine) to filter results by product. Conversation models introduceConversationProductfor this distinction. - Conversation termination filtering: List conversations adds optional
termination_reasonsquery parameter (array of strings) to filter conversations by how they ended. - Per-agent topic discovery: Create agent and Update agent platform settings add optional
topic_discovery(TopicDiscoverySettings) for per-agent topic discovery configuration. - Background sound configuration: Agent platform and conversation configuration models add optional
background_sound(BackgroundSoundConfig) for ambient audio during conversations. - Turn interruption ignore terms: Turn configuration schemas add optional
interruption_ignore_terms(array of strings) to suppress turn detection on specific phrases. - Soft timeout filler randomization: Soft timeout configuration adds optional
randomize_fillers(boolean) to shuffle filler messages across soft timeouts. Soft timeout message and LLM prompt override fields now support dynamic variables. - Transcript user identifiers: Transcript message models add optional
user_identifier(string) on user-authored messages. - Simulation success conditions: Agent simulation test schemas add optional
success_conditions(array, up to 30 items). The legacysuccess_conditionfield is deprecated in favor of the array form. - Agent test repeat limit: Run tests on the agent raises the maximum
repeat_countfrom 20 to 50. - Tool schema dynamic allowed values: ElevenAgents tool JSON schema properties add optional
allowed_values_dynamic_variable(string) for server-verified LLM value picks sourced from dynamic variables. - Widget signed URL docs: Get widget updates
conversation_signaturedocumentation to reference/v1/convai/conversation/get_signed_url.
- Higher-quality output formats: Generate music, Generate music detailed and Stream music add
mp3_48000_240andmp3_48000_320to supportedoutput_formatvalues. Whenoutput_formatisauto, v2 models now default tomp3_48000_192instead ofmp3_48000_128. - Section duration flag clarification:
respect_sections_durationsapplies only withcomposition_planonmusic_v1. Onmusic_v2, section durations are always enforced and this flag is ignored. - Composition plan schema split: Music request
composition_planuses aoneOfunion ofMusicPromptandCompositionPlan. The former is used formusic_v1composition plans and the latter formusic_v2.
Dubbing
Section titled “Dubbing”- Project list filters: List dubs adds optional
dubbing_statuses,dubbing_models,target_language_codesandcreation_sourcesarray query parameters for filtered listing. Theorder_byparameter now acceptsnamein addition tocreated_at.
Workspaces
Section titled “Workspaces”- Lock and disable reasons: Workspace and API key models add
LockReasonand optionaldisable_reasonfields. Workspace group settings add optionalscim_frozen(boolean) for SCIM-managed freeze state.
ElevenCreative Studio
Section titled “ElevenCreative Studio”- Caption animations: Studio caption enter and exit animation enums add
pop,slide_upandslide_down.
SDK Releases
Section titled “SDK Releases”JavaScript SDK
Section titled “JavaScript SDK”- v2.54.0 - Regenerated from the latest OpenAPI schema with branch rebase client support, conversation list and text-search
conversation_product_typeandtermination_reasonsfilters, dubbing list multi-value filters, music-specificoutput_formattypes, topic discovery settings, and removal of coaching-related exported types. - v2.53.1 - Restored optional values in
DynamicVariablesConfigrecords that were incorrectly narrowed in v2.53.0.
Python SDK
Section titled “Python SDK”- v2.54.0 - Regenerated from the latest OpenAPI schema with branch rebase client support, conversation list and text-search filters, dubbing list multi-value filters, music output format updates, topic discovery settings, and removal of coaching-related exported types.
ElevenLabsandAsyncElevenLabsnow acceptheadersandfollow_redirectspassthrough to the base client.
Packages
Section titled “Packages”- @elevenlabs/client@1.12.0 - Added
overrides.asr.keywordssupport on the browser client so per-conversation ASR keyword biasing can be sent viaconversation_initiation_client_data. - @elevenlabs/react@1.7.0 - Exposed
includeLanguageDetectionfor realtime Scribe sessions, including ReactuseScribesupport for requesting and reading detected language metadata. - @elevenlabs/react-native@1.2.9, @elevenlabs/types@0.15.0, @elevenlabs/convai-widget-core@0.14.4 and @elevenlabs/convai-widget-embed@0.14.4 - Dependency alignment to
@elevenlabs/client@1.12.0and@elevenlabs/types@0.15.0. - @elevenlabs/client@1.12.1 - Exposed the file upload helper from the internal Unity entrypoint.
- @elevenlabs/react@1.7.1, @elevenlabs/react-native@1.2.10, @elevenlabs/convai-widget-core@0.14.5 and @elevenlabs/convai-widget-embed@0.14.5 - Dependency alignment to
@elevenlabs/client@1.12.1.
MCP Server
Section titled “MCP Server”- v0.10.0 - Added Music v2 model and endpoints, MCP tool annotations for all 24 tools, Python 3.14 support, Singapore data residency, EU/IN residency shorthand aliases, graceful shutdown handling for client disconnections, and fixes for voice preview creation and output directory path resolution.
View API changes
New Endpoints
ElevenAgents
POST /v1/convai/agents/{agent_id}/branches/{branch_id}/rebase- Rebases a branch onto the latest main while preserving branch-specific changes
Updated Endpoints
ElevenAgents
- List conversations -
GET /v1/convai/conversations- Added optional
conversation_product_typequery parameter (agents|speech_engine) - Added optional
termination_reasonsquery parameter (array of strings)
- Added optional
- Text search conversation messages -
GET /v1/convai/conversations/messages/text-search- Added optional
conversation_product_typequery parameter (agents|speech_engine)
- Added optional
- Get widget -
GET /v1/convai/agents/{agent_id}/widget- Updated
conversation_signaturedocumentation to reference/v1/convai/conversation/get_signed_url
- Updated
- Run tests on the agent -
POST /v1/convai/agents/{agent_id}/run-tests- Raised maximum
repeat_countfrom 20 to 50
- Raised maximum
Dubbing
- List dubs -
GET /v1/dubbing- Added optional
dubbing_statuses,dubbing_models,target_language_codesandcreation_sourcesquery parameters order_bynow acceptsnamein addition tocreated_at
- Added optional
Music
- Generate music, Generate music detailed and Stream music
- Added
mp3_48000_240andmp3_48000_320to supportedoutput_formatvalues autooutput format selectsmp3_48000_192for v2 models (previouslymp3_48000_128)
- Added
Schema Changes
ElevenAgents
- Agent branches and versions
- Added optional
rebased_from_version_idon agent version parent models
- Added optional
- Platform and conversation configuration
- Added optional
topic_discovery(TopicDiscoverySettings) on platform settings request and response models - Added optional
background_sound(BackgroundSoundConfig)
- Added optional
- Turn and timeout configuration
- Added optional
interruption_ignore_terms(array of strings) on turn config schemas - Added optional
randomize_fillers(boolean) on soft timeout config
- Added optional
- Transcripts and simulation
- Added optional
user_identifier(string) on transcript user messages - Added optional
success_conditions(array, max 30); deprecatedsuccess_condition
- Added optional
- Tool JSON schema properties
- Added optional
allowed_values_dynamic_variable(string)
- Added optional
Music
- Composition plans
composition_planrequest field usesoneOf(MusicPrompt|CompositionPlan)- Clarified
respect_sections_durationsbehavior formusic_v1vsmusic_v2
Workspaces
- Added
LockReasonenum and optionaldisable_reasonfields - Added optional
scim_frozen(boolean) on workspace group settings
ElevenCreative Studio
- Caption animation enums add
pop,slide_upandslide_down
Removed Schemas
ElevenAgents
- Removed coaching-related settings schemas (
CoachedAgentSettings,CoachingAgentSettings,NoCoachingSettings)
June 15, 2026
Section titled “June 15, 2026”Introducing Music v2
Section titled “Introducing Music v2”Music v2 is now available via the ElevenLabs API. Set model_id to music_v2 on Generate music, Stream music, Generate music detailed and Upload music to use the new model. Music v2 introduces chunk-based composition plans built from GenerationChunk and AudioRefChunk segments, giving you finer control over structure, pacing and arrangement than the prompt-based music_v1 flow.
Use music_v2 composition plans on generation and upload requests, or generate a plan first via the composition-plan endpoint. Request and response bodies accept either v1 or v2 plan shapes, so you can migrate endpoint by endpoint. MusicPrompt remains available for music_v1 only.
Quickstart
Generate your first track with the Music API in minutes.
Composition plans
Build chunk-based composition plans for structured, multi-section tracks.
API reference
Compose, stream and upload music with music_v2 over the REST API.
- Upload timestamps: Upload music accepts optional
with_timestamps; responses may includewords_timestamps.
ElevenAgents
Section titled “ElevenAgents”- Run conversation evaluation: Added Run conversation evaluation endpoint (
POST /v1/convai/conversations/{conversation_id}/analysis/evaluations/run) to rerun a single evaluation criterion against a completed conversation usingRunConversationEvaluationsRequest. - Workflow entry behavior: Workflow override-agent nodes add optional
entry_behavior(generate_immediately,wait_for_user,auto) to control whether the sub-agent speaks first or waits for user input. - End procedure system tool: Added
end_proceduresystem tool configuration with matching error statuses. Thestart_proceduretool addsalready_activeto its error statuses. - Transfer TTS overrides:
AgentTransfer, workflow standalone agent nodes and successfultransfer_to_agenttool results add optionalpreserve_client_tts_overrides(boolean) to keep client-side TTS overrides after a transfer. - Interaction budget enum:
InteractionBudgetremovesasyncand adds5_minutes,10_minutesand1_hour. Update any configs or SDK enums that still referenceasync. - Custom guardrail model selection: Custom guardrail configuration adds optional
modelwith Gemini, Claude and GPT variants. Guardrail config also adds optionalhistory_message_count(integer). - Phone number list filters: List phone numbers adds optional
provider,agent_idandbranch_idquery parameters to filter imported numbers. - WhatsApp account filtering: List WhatsApp accounts adds optional
agent_idquery parameter to filter accounts by assigned agent. - Topic time range filters: Get agent conversation topics adds optional
from_unix_secsandto_unix_secsquery parameters to bound topic discovery results. - SIP codec configuration: Outbound SIP trunk request and response models add optional
enabled_codecs(MediaCodecenum). - Memory tool types: Added
LoadableMemoryEntryandLoadMemoryEntryToolErrorStatusschemas for memory-tool error handling. - Agent test batch limits: Agent test attach, run and resubmit request schemas raise maximum attached tests from 1000 to 5000.
- Phoneme tag support: Agent TTS settings add optional
enable_phoneme_tags(boolean) for opt-in V3 SSML phoneme handling. - Array schema omit overrides: Array JSON schema properties add optional
is_omitted(mutually exclusive with other value sources).ConstantSchemaOverridecan use array constant values. - Transfer error context: Transfer-to-number error payloads can include optional
agent_message(string).
Workspaces
Section titled “Workspaces”- Service account API key updates: Update service account API key no longer requires a request body. Edit fields support partial updates via
no_updateand nullablename, includingpermissionsandcharacter_limit. - Usage timezone bucketing: Workspace usage-by-product-over-time requests add optional
time_zone(IANA timezone string) with clarifiedinterval_secondsbucket rules. - History source filter: History list and detail
sourcefilters addFlows.
ElevenCreative Studio
Section titled “ElevenCreative Studio”- Project voice references: Project models, chapter TTS nodes, voice lists and voice statistics shift to
project_voice_ref_idas the canonical voice field. Formervoice_idfields remain on responses as deprecated, read-only mirrors for compatibility.
Speech to Text
Section titled “Speech to Text”- Speaker library diarization: Convert speech to text adds optional
use_speaker_library(boolean, defaultfalse) for batch transcription diarization.
Voices
Section titled “Voices”- Shared voice sorting: List shared voices
sortquery parameter gains an explicit enum,created_datedefault and updated description.
SDK Releases
Section titled “SDK Releases”JavaScript SDK
Section titled “JavaScript SDK”- v2.53.0 - Regenerated from the latest OpenAPI schema with conversation evaluation rerun support, music v2 composition-plan unions, workflow
entry_behavior, phone number and WhatsApp list filters, topic time-range parameters, alerting schema updates, studioproject_voice_ref_idfields, and expanded agent test batch limits.
Python SDK
Section titled “Python SDK”- v2.53.0 - Regenerated from the latest OpenAPI schema with conversation evaluation rerun support, music v2 composition plans, workflow entry behavior and end-procedure tools, telephony filter parameters, alerting and service-account partial-update models, and studio voice reference fields.
Packages
Section titled “Packages”- @elevenlabs/client@1.11.0 - Added
@elevenlabs/client/internal/unitysub-path export for the Unity SDK WebGL bridge, exposingMediaDeviceInput,MediaDeviceOutput, connection attach helpers and WebRTC adapter types. - @elevenlabs/client@1.11.1, @elevenlabs/react@1.6.7, @elevenlabs/react-native@1.2.7, @elevenlabs/convai-widget-core@0.14.2 and @elevenlabs/convai-widget-embed@0.14.2 - Dependency alignment to
@elevenlabs/client@1.11.1and@elevenlabs/types@0.14.1. - @elevenlabs/types@0.14.1 - Added
"license": "MIT"topackage.jsonfor license-checker compatibility.
iOS SDK
Section titled “iOS SDK”- v3.2.1 - Added Singapore data residency support and enabled
singlePeerConnectionfor WebRTC sessions.
View API changes
New Endpoints
ElevenAgents
- Run conversation evaluation -
POST /v1/convai/conversations/{conversation_id}/analysis/evaluations/run- Request body uses
RunConversationEvaluationsRequestto rerun a single evaluation criterion
- Request body uses
Updated Endpoints
ElevenAgents
- List phone numbers -
GET /v1/convai/phone-numbers- Added optional
provider,agent_idandbranch_idquery parameters
- Added optional
- Get agent conversation topics -
GET /v1/convai/agents/{agent_id}/topics- Added optional
from_unix_secsandto_unix_secsquery parameters
- Added optional
- List WhatsApp accounts -
GET /v1/convai/whatsapp-accounts- Added optional
agent_idquery parameter
- Added optional
Music
- Generate music, Generate music detailed, Stream music and Upload music
- Added
music_v2to supportedmodel_idvalues - Upload adds optional
with_timestamps; responses may includewords_timestamps
- Added
Speech to Text
- Convert speech to text -
POST /v1/speech-to-text- Added optional
use_speaker_libraryquery parameter (boolean, defaultfalse)
- Added optional
Voices
- List shared voices -
GET /v1/shared-voicessortquery parameter now uses an explicit enum withcreated_datedefault
Schema Changes
ElevenAgents
- Workflow override-agent nodes
- Added optional
entry_behaviorenum (generate_immediately,wait_for_user,auto)
- Added optional
- System tools
- Added
end_proceduretool config and error statuses
- Added
- Transfer and interaction schemas
- Added optional
preserve_client_tts_overrideson transfers and transfer tool results InteractionBudgetremovesasync; adds5_minutes,10_minutes,1_hour
- Added optional
- Guardrails and TTS
- Custom guardrails add optional
modelandhistory_message_count - Agent TTS settings add optional
enable_phoneme_tags
- Custom guardrails add optional
- Telephony
- SIP trunk models add optional
enabled_codecs(MediaCodecenum)
- SIP trunk models add optional
- Memory and code tools
- Added
LoadableMemoryEntryandLoadMemoryEntryToolErrorStatus
- Added
- Agent testing
- Raised attached test limits from 1000 to 5000 on run and resubmit requests
- Tool JSON schema properties
- Array properties add optional
is_omitted
- Array properties add optional
Workspaces
- Service accounts
- API key PATCH supports partial updates with
no_updatesentinels
- API key PATCH supports partial updates with
- Usage and history
- Usage-by-product-over-time adds optional
time_zone - History
sourcefilters addFlows
- Usage-by-product-over-time adds optional
Music
- Composition plans
- Added chunk-based
CompositionPlan,GenerationChunkandAudioRefChunkformusic_v2 - Request and response bodies accept
anyOfv1 or v2 plan shapes
- Added chunk-based
ElevenCreative Studio
- Project voice models
- Added
project_voice_ref_idas canonical voice reference - Deprecated read-only
voice_idmirrors retained on responses
- Added
June 8, 2026
Section titled “June 8, 2026”Text to Speech
Section titled “Text to Speech”- v1 model removal: The
eleven_monolingual_v1andeleven_multilingual_v1models are deprecated and will be removed on July 9, 2026. Migrate toeleven_multilingual_v2or another current model before removal. See deprecated models for replacement suggestions.
Speech to Text
Section titled “Speech to Text”- Scribe v1 removal: The
scribe_v1model is deprecated and will be removed on July 9, 2026. Migrate toscribe_v2orscribe_v2_realtimebefore removal. See deprecated models for replacement suggestions.
ElevenAgents
Section titled “ElevenAgents”- Turn model configuration:
TurnConfigandTurnConfigWorkflowOverrideadd optionalturn_model(turn_v2orturn_v3, defaultturn_v3) to select the turn detection model version per agent or workflow node. - Soft timeout filler messages:
SoftTimeoutConfigandSoftTimeoutConfigWorkflowOverrideadd optionaladditional_soft_timeout_messages(array of strings, up to 7) andmax_soft_timeouts_per_generation(integer, 1–8, default1). The primarymessageapplies to the first timeout; subsequent timeouts use the additional messages or a built-in filler. - ASR provider default: The default
ASRConversationalConfig.providervalue changes fromelevenlabstoscribe_realtime. Theelevenlabsvalue remains in the enum but is deprecated. - Conversation product field: Get conversation details response adds optional
conversation_product(string, defaultagent) to identify the product that handled the conversation. - Knowledge base external sync: Knowledge base file and folder response models add optional
external_sync_info(Google Drive sync metadata viaExternalFileSyncInfo/ExternalFolderSyncInfo) and optionalis_frozen(boolean) to indicate whether synced content can be edited. - Tool schema omit overrides: ConvAI tool JSON schema properties add optional
is_omitted(boolean) andOmitSchemaOverridewithsource: omit, allowing fields to be explicitly omitted from tool payloads. - Procedure guardrails: Procedure version schemas add optional
guardrails.
Workspaces
Section titled “Workspaces”- URL secret auth connections: Workspace auth connection create, list and response unions add
url_secret(UrlSecretAuthResponse) as a supported auth connection type for tools that fetch secrets from a URL. - Agent QA Evaluations webhooks:
WebhookUsageTypeaddsAgent QA Evaluationsas a webhook usage category for agent quality-assurance event delivery.
Text to Dialogue
Section titled “Text to Dialogue”- Zero retention mode: Convert text to dialogue, Stream text to dialogue, Convert text to dialogue with timestamps and Stream text to dialogue with timestamps add optional
enable_loggingquery parameter (boolean, defaulttrue). Setenable_logging=falseto use zero retention mode with no history or request stitching. Zero retention mode is available to enterprise customers only.
ElevenCreative Studio
Section titled “ElevenCreative Studio”- Safesearch adult metadata: Get project
publishing_readresponses add optionalsafesearch_adult(nullable boolean) onDirectPublishingReadResponseModelfor direct publishing content classification.
SDK Releases
Section titled “SDK Releases”JavaScript SDK
Section titled “JavaScript SDK”- v2.52.0 - Regenerated from the latest OpenAPI schema with
turn_modeland soft timeout filler fields on turn configs, knowledge base external sync types,OmitSchemaOverridefor tool schemas,UrlSecretAuthResponse,conversation_producton conversation responses, text-to-dialogueenable_loggingsupport, and updatedAsrProviderdefaults. - v2.51.0 - Added workspace API key revoke client,
ConversationSentimentAnalysisandSystemEvaluationCriteriatypes,CustomLlmAuthConnectionfor HTTP tool auth, procedure tool config types,ResourceAccessInfoAccessSource, and conversation list/search filters forworkflow_node_entered_idandtopic_ids.
Python SDK
Section titled “Python SDK”- v2.52.0 - Regenerated from the latest OpenAPI schema with turn model and soft timeout config updates, knowledge base external sync models, tool schema omit overrides, URL secret auth connections, conversation
conversation_product, text-to-dialogueenable_loggingsupport, and updated ASR provider defaults. - v2.51.0 - Regenerated from the latest OpenAPI schema with workspace API key revoke, conversation sentiment and system evaluation types, procedure tool configuration models, and updated conversation filtering parameters.
Packages
Section titled “Packages”- @elevenlabs/convai-widget-core@0.13.0 and @elevenlabs/convai-widget-embed@0.13.0 - Added call and message entry points to the widget launcher. Multimodal agents show both; voice-only agents show call; text-only agents show message.
- @elevenlabs/convai-widget-core@0.13.1 and @elevenlabs/convai-widget-embed@0.13.1 - Fixed compact and full trigger control alignment.
View API changes
Updated Endpoints
ElevenAgents
- Get conversation details -
GET /v1/convai/conversations/{conversation_id}- Response adds optional
conversation_product(string, defaultagent)
- Response adds optional
- Get knowledge base document -
GET /v1/convai/knowledge-base/{documentation_id}- Response adds optional
external_sync_infoandis_frozenon file models
- Response adds optional
Text to Dialogue
- Convert text to dialogue -
POST /v1/text-to-dialogue- Added optional
enable_loggingquery parameter (boolean, defaulttrue)
- Added optional
- Stream text to dialogue -
POST /v1/text-to-dialogue/stream- Added optional
enable_loggingquery parameter (boolean, defaulttrue)
- Added optional
- Convert text to dialogue with timestamps -
POST /v1/text-to-dialogue/with-timestamps- Added optional
enable_loggingquery parameter (boolean, defaulttrue)
- Added optional
- Stream text to dialogue with timestamps -
POST /v1/text-to-dialogue/stream/with-timestamps- Added optional
enable_loggingquery parameter (boolean, defaulttrue)
- Added optional
Schema Changes
ElevenAgents
TurnConfigandTurnConfigWorkflowOverride- Added optional
turn_modelenum (turn_v2,turn_v3, defaultturn_v3)
- Added optional
SoftTimeoutConfigandSoftTimeoutConfigWorkflowOverride- Added optional
additional_soft_timeout_messages(array of strings, max 7) - Added optional
max_soft_timeouts_per_generation(integer, 1–8, default1)
- Added optional
ASRConversationalConfig- Default
providerchanged fromelevenlabstoscribe_realtime elevenlabsprovider value deprecated
- Default
- Procedure version schemas
- Added optional
guardrails
- Added optional
- Knowledge base file and folder response models
- Added optional
external_sync_infoandis_frozen
- Added optional
- Tool JSON schema properties
- Added optional
is_omittedandOmitSchemaOverride(source: omit)
- Added optional
Workspaces
- Auth connection unions
- Added
url_secret(UrlSecretAuthResponse)
- Added
WebhookUsageTypeenum- Added
Agent QA Evaluations
- Added
ElevenCreative Studio
DirectPublishingReadResponseModel- Added optional
safesearch_adult(nullable boolean)
- Added optional
June 1, 2026
Section titled “June 1, 2026”ElevenAgents
Section titled “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 withagent_id,agent_phone_number_id,to_number, optionalconversation_initiation_client_dataand optionaltelephony_call_config. Exotel phone number create, list, get and update schemas are available, andexotelis added toTelephonyProvider, conversation initiation source and transfer result enums. - Workflow-aware agent transfers:
AgentTransfernow allows a nullableagent_idso transfers can stay on the current agent, adds optionalnode_idto start at a specific node in the destination workflow, and only requirescondition. Successfultransfer_to_agenttool results can include nullableto_node, aligning transfers with workflow-node targets. - Agent test repeat runs: Run tests on the agent accepts optional
repeat_count(integer, 1–20, default1) to run each test multiple times. Whenrepeat_countis greater than 1, responses includebucketing_statusandresult_groupsfor grouped summaries. Unit test create, update and summary schemas add optionalconversation_initiation_sourceso tests can simulate a specific channel. - Conversation filtering: List conversations adds optional
workflow_node_entered_id(string) to filter conversations that entered a given workflow node. Text search conversation messages adds optionaltopic_ids(array of strings) to filter by topic IDs assigned during topic discovery. - Agent versioning query parameters deprecated:
enable_versioningon create agent andenable_versioning_if_not_enabledon update agent are marked deprecated. All agents are versioned and these parameters are ignored. - Procedure compiler mode: Removed
appendfromProcedureCompilerMode.
Workspaces
Section titled “Workspaces”- Revoke API key: Added revoke API key endpoint (
DELETE /v1/workspaces/api-keys/revoke) with requiredapi_key_namequery parameter to revoke a workspace API key by name. This endpoint is destructive and requires additional account permissions, even though the documentation is public. Contact your ElevenLabs representative to enable it for your account. - Resource access disclosure: Resource access response models add optional
access_source(creator,explicit,workspace_default,workspace_admin) so clients can disclose why a user has access to a shared resource.
Speech to Text
Section titled “Speech to Text”- Larger upload limit: Convert speech to text now accepts audio and video files up to 5.0GB, increased from 3.0GB.
Dubbing
Section titled “Dubbing”- hCaptcha support: Dub a video or audio file request body adds optional
hcaptcha_token(string) for bot protection on dubbing project creation. - Zip render format:
RenderTypeaddszipalongside existing output formats such asmp4,aac,mp3,wav,aaf,tracks_zipandclips_zip.
SDK Releases
Section titled “SDK Releases”Packages
Section titled “Packages”- @elevenlabs/client@1.9.0 - Added configurable microphone input chunk duration via
inputChunkDurationMs(default 25ms). - @elevenlabs/react@1.6.4 - Exposed
inputChunkDurationMsfor microphone input chunk duration and updated the client dependency to@elevenlabs/client@1.9.0. - @elevenlabs/react-native@1.2.4 - Updated dependencies to
@elevenlabs/client@1.9.0and@elevenlabs/react@1.6.4. - @elevenlabs/convai-widget-core@0.12.9 and @elevenlabs/convai-widget-embed@0.12.9 - Updated widget dependencies to
@elevenlabs/client@1.9.0. - Flutter SDK v0.6.1 - Hardened LiveKit session teardown against uncaught stream errors.
View API changes
New Endpoints
ElevenAgents
- Exotel outbound call -
POST /v1/convai/exotel/outbound-call- Request body requires
agent_id,agent_phone_number_idandto_number - Optional
conversation_initiation_client_dataandtelephony_call_config
- Request body requires
Workspaces
- Revoke API key -
DELETE /v1/workspaces/api-keys/revoke- Required query parameter
api_key_name(string) - Requires additional account permissions. Contact your ElevenLabs representative to enable access.
- Required query parameter
Updated Endpoints
ElevenAgents
- List conversations -
GET /v1/convai/conversations- Added optional
workflow_node_entered_idquery parameter (string)
- Added optional
- Text search conversation messages -
GET /v1/convai/conversations/messages/text-search- Added optional
topic_idsquery parameter (array of strings)
- Added optional
- Create agent -
POST /v1/convai/agents/create- Deprecated optional
enable_versioningquery parameter (boolean, ignored)
- Deprecated optional
- Update agent -
PATCH /v1/convai/agents/{agent_id}- Deprecated optional
enable_versioning_if_not_enabledquery parameter (boolean, ignored)
- Deprecated optional
- Run tests on the agent -
POST /v1/convai/agents/{agent_id}/run-tests- Added optional
repeat_count(integer, 1–20, default1) - Response adds
bucketing_statusandresult_groupswhen repeat runs are grouped
- Added optional
Speech to Text
- Convert speech to text -
POST /v1/speech-to-text- Increased maximum upload size from 3.0GB to 5.0GB
Dubbing
- Dub a video or audio file -
POST /v1/dubbing- Added optional
hcaptcha_token(string)
- Added optional
Schema Changes
ElevenAgents
AgentTransferagent_idis now nullable and optional- Added optional
node_id(string) - Only
conditionis required
ProcedureCompilerMode- Removed
append; onlyskillsremains
- Removed
TelephonyProviderenum- Added
exotel
- Added
- Unit test schemas
- Added optional
conversation_initiation_sourceon create, update and summary models
- Added optional
Workspaces
- Resource access models
- Added optional
access_sourceenum (creator,explicit,workspace_default,workspace_admin)
- Added optional
Dubbing
RenderTypeenum- Added
zip
- Added
Showing the 20 most recent of 97 entries. Append /llms.txt to the changelog URL for the complete index.