ElevenAgents
-
agent_response_completeWebSocket event: A newagent_response_completeclient event fires exactly once when an agent’s response is fully delivered — after all LLM generation, tool call chains, and audio playback complete. The event lets clients reliably detect end of turn for batching messages, wake-word activation, or post-turn UI updates. The event is suppressed while async tool tasks are still running and is not emitted on agents configured withturn_timeoutorsoft_timeout. Added a newAGENT_RESPONSE_COMPLETEvalue to theClientEventenum and a correspondingAgentResponseCompleteClientEventresponse model. -
Pre-tool speech mode: Added a new
pre_tool_speechfield (PreToolSpeechModeenum, defaultauto) on MCP server configuration and per-tool overrides. Replaces the now-deprecatedforce_pre_tool_speechboolean. Values:autodecides whether the agent speaks before the tool call based on recent tool latency,forcealways asks the agent to speak, andoffopts out entirely. -
Tool dispatch respects execution mode: Workflow tool dispatch nodes now correctly respect each nested tool’s
execution_mode. If any tool in a dispatch node usesPOST_TOOL_SPEECH, the workflow waits for the current turn’s audio to be fully exposed before executing the dispatch. -
MCP response timeout: Added a
response_timeout_secsfield (integer, default30, min5, max120) on MCP server configuration and per-tool overrides, controlling the maximum time to wait for each MCP tool call to complete. -
Agent trust context: Added a
trust_contextfield on agent platform settings (AgentTrustContextenum:unknown|low|high, defaultunknown).lowis for agents serving untrusted external participants, where outputs should be vetted and tool access scoped;highis for agents serving the owner where full tool access is appropriate;unknowncovers agents created before this feature. -
Source attribution toggle: Added a
source_attributionboolean (defaultfalse) on conversation config. When enabled and knowledge base content is present, the LLM is instructed to report which sources it used. -
Test sharing mode filter: The list tests endpoint now accepts a
sharing_modequery parameter (all|shared_with_me, defaultall) to filter tests and folders to only those shared with the current user that they did not create. -
Tool icons and execution metadata: Added
icons(array ofIcon) andexecution(ToolExecution) fields to theToolschema.Iconincludessrc,mimeType, andsizesfor UI display, andToolExecution.taskSupport(forbidden|optional|required) declares how the tool participates in tasks. -
Procedure compiler default: The
ProcedureCompilerModedefault has changed fromdeterministictoappend, and thellmvalue has been removed. Existing agents that explicitly setdeterministicare unaffected. -
RAG and knowledge base attribution metadata: Added
used_static_kb_document_ids(array of strings) onConversationHistoryTranscriptCommonModelandConversationHistoryTranscriptResponseModel, andused_chunk_idsonRagRetrievalInfo, surfacing exactly which knowledge base documents and RAG chunks contributed to each transcript turn. -
Dynamic variable refactor:
dynamic_variablesanddynamic_variable_placeholdersnow reference unifiedDynamicVariableValueType-Input/DynamicVariableValueType-Outputschemas (replacing the priorDynamicVariableContainerValueType-*schemas), with broader support for nested and list values.DynamicVariableAssignmentgained apreserve_native_typefield to keep typed values rather than coercing to strings.
Audio Isolation
- History endpoints: Two new endpoints expose your audio isolation history.
- List audio isolation history (
GET /v1/audio-isolation/history) returns a paginated list of all your audio isolation generations. Supportspage_size,page, andsearchquery parameters. - Delete audio isolation history item (
DELETE /v1/audio-isolation/history/{history_item_id}) deletes a specific item and its associated media files.
- List audio isolation history (
Speech to Text
- Realtime keyterms and verbatim mode: The Scribe realtime WebSocket now accepts a
keytermsparameter (array of strings, max 50 entries of up to 20 characters each) to bias the model toward specific terms, and ano_verbatimboolean to remove filler words, false starts, and disfluencies from transcripts. Both parameters are echoed back in thesession_startedevent. Available across the JavaScript SDK, Python SDK, and the@elevenlabs/clientbrowser/Node client SDK.
SDK Releases
Python SDK
- v2.45.0 - Fern regeneration for the April 27, 2026 API schema, including audio isolation history endpoints, tool executions, MCP
pre_tool_speechandresponse_timeout_secs, and theagent_response_completeclient event. Also includes a fix to the notebook install hint in the README. - v2.44.0 - Fern regeneration for the April 21, 2026 API schema, picking up the
trust_contextfield,pre_tool_speechmode, asset transcription support, and MCP response timeout configuration.
JavaScript SDK
- v2.45.0 - Added
keyterms(string array, max 50 keyterms of up to 20 chars each) andnoVerbatim(boolean) options on the Scribe realtime client.keytermsare sent as repeated query parameters on the WebSocket URL to bias transcription, andnoVerbatimremoves filler words and disfluencies. Both fields are also added to the typedConfiginterface for thesession_startedecho. Also includes the April 27, 2026 Fern regeneration (#376). - v2.44.0 - Fern regeneration for the April 21, 2026 API schema, picking up the
trust_contextfield,pre_tool_speechmode, and MCP response timeout configuration.
Swift SDK
- v3.1.4 - Fixed an issue where the local microphone kept publishing after an agent disconnected (silence timeout or
end_calltool).onAgentDisconnectednow disconnects the LiveKit room and tears down conversation state, withonDisconnectfiring an.agentreason.ConnectionManaging.onAgentDisconnectedis nowasync. Removed the unusedConversationConnectionManagerwrapper.
Packages
- @elevenlabs/client@1.3.1 - Fixed the agent tool-call sound being interpreted as user speech and interrupting the agent during tool execution.
- @elevenlabs/client@1.3.0 - Added support for the upload conversation file endpoint, letting clients attach files to an in-progress conversation directly from the client SDK.
- @elevenlabs/react@1.2.1, @elevenlabs/react@1.2.0 - Updated to
@elevenlabs/client@1.3.1/@elevenlabs/client@1.3.0, picking up the tool-call sound fix and conversation file upload support. - @elevenlabs/react-native@1.1.3, @elevenlabs/react-native@1.1.2 - Updated to the latest
@elevenlabs/clientfor the same fixes. - @elevenlabs/convai-widget-core@0.11.6, @elevenlabs/convai-widget-embed@0.11.6 - Updated to
@elevenlabs/client@1.3.1for the tool-call sound fix. - @elevenlabs/convai-widget-core@0.11.5, @elevenlabs/convai-widget-embed@0.11.5 - Updated to
@elevenlabs/client@1.3.0for conversation file upload support.
API
View API changes
New Endpoints
- List audio isolation history -
GET /v1/audio-isolation/history - Delete audio isolation history item -
DELETE /v1/audio-isolation/history/{history_item_id} - Get tool executions -
GET /v1/convai/tools/{tool_id}/executionsreturns paginated tool executions for a specific tool with optionalcursor,page_size,is_error,agent_id,branch_id,start_time, andend_timefilters
Updated Endpoints
ElevenAgents
-
Create agent, Get agent, Update agent
- Added
trust_contextfield (AgentTrustContextenum:unknown|low|high, defaultunknown) onAgentPlatformSettingsRequestModel - Added
source_attributionfield (boolean, defaultfalse) onConversationConfig
- Added
-
Update MCP server configuration, Create MCP server
- Added
pre_tool_speechfield (PreToolSpeechModeenum:auto|force|off, defaultauto) - Added
response_timeout_secsfield (integer, default30, min5, max120)
- Added
-
Create configuration override, Update configuration override
- Added
pre_tool_speechfield (PreToolSpeechModeenum, nullable, optional) - Added
response_timeout_secsfield (integer, nullable, optional) - Added
response_mocksfield onMCPToolConfigOverride-Input/MCPToolConfigOverride-Output - Marked
force_pre_tool_speechas deprecated; usepre_tool_speechinstead
- Added
-
- Added optional
sharing_modequery parameter (TestSharingModeenum:all|shared_with_me, defaultall)
- Added optional
-
Simulate conversation, Stream simulate conversation
- Refactored
dynamic_variablesanddynamic_variable_placeholderspayloads to reference unifiedDynamicVariableValueType-Input/DynamicVariableValueType-Outputschemas with broader nested and list value support
- Refactored
-
Toolschema- Added
iconsfield (array ofIcon, nullable) for UI display - Added
executionfield (ToolExecution, nullable) includingtaskSupport(forbidden|optional|required)
- Added
-
ClientEventenum- Added
agent_response_completevalue with newAgentResponseCompleteClientEventresponse model
- Added
-
ProcedureCompilerModeenum- Default changed from
deterministictoappend - Removed
llmvalue
- Default changed from
-
ConversationHistoryTranscriptCommonModel,ConversationHistoryTranscriptResponseModel- Added
used_static_kb_document_idsfield (array of strings)
- Added
-
RagRetrievalInfo- Added
used_chunk_idsfield (array of strings)
- Added
-
DynamicVariableAssignment- Added
preserve_native_typefield (boolean) for keeping typed values instead of coercing to strings
- Added
-
Workflow nodes
- Added
auto_advance_after_first_responsefield on relevant workflow node schemas
- Added
-
Tool configuration documentation
- Added
response_body_schemafield for documenting expected response shape
- Added
Workspaces
-
GetUserSubscriptionResponseModel- Added
max_credit_limit_extensionfield
- Added
-
Get workspace usage by product over time
- Tightened request validation:
start_timeandend_timeminimums raised to2020-01-01, with descriptions added on both fields. The endpoint summary was renamed toGet Workspace Usage.
- Tightened request validation:
Other
- New shared
Currencyenum with valueseur,inr,usd, replacing inline currency strings in several schemas. - New
AssetTranscriptionandAssetTranscriptionDataschemas extend asset models with transcription support. - New
PendingBlocksMetadataModelandPendingExternalAudiosMetadataModelprovide richer metadata on pending tasks. - New
InVPCvalue added to source-related enums. - Transcription
keytermsnow have explicit length restrictions in the spec. - New
MemoryEntrySearchResult,ConversationSource, andManualSourceschemas added.