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