January 26, 2026 | ElevenLabs Documentation

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

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

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

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

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

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

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

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

New Endpoints

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

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

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

Add workspace invite, Add workspace member
- Added seat_type (enum, optional) field
- Deprecated workspace_permission and workspace_role fields in favor of seat_type

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

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