# January 26, 2026

### Agents Platform

- **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](/guides/changelog-api-reference-agents-branches-list) and [Deployments](https://elevenlabs.io/docs/api-reference/agents/deployments/create) 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](/guides/changelog-api-reference-conversations-get) 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.

### Knowledge Base

- **Folder management**: Added support for organizing knowledge base documents into folders. New endpoints include [Create folder](/guides/changelog-api-reference-knowledge-base-create-folder) for creating folders, [Move document](https://elevenlabs.io/docs/api-reference/knowledge-base/move-document) for moving single documents, and [Bulk move](https://elevenlabs.io/docs/api-reference/knowledge-base/bulk-move) for moving multiple documents at once.

### Tools

- **Enhanced tools listing**: The [Get tools](https://elevenlabs.io/docs/api-reference/tools/list) 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.

### Music

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

### ElevenCreative Studio

- **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.

### Workspaces

- **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.

### SDK Releases

#### Python SDK

- [v2.32.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/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

#### JavaScript SDK

- [v2.33.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/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

### API

:::accordion{title="View API changes"}
## New Endpoints

- [List agent branches](/guides/changelog-api-reference-agents-branches-list) - `GET /v1/convai/agents/{agent_id}/branches` - List all branches for an agent
- [Create agent branch](https://elevenlabs.io/docs/api-reference/agents/branches/create) - `POST /v1/convai/agents/{agent_id}/branches` - Create a new branch for an agent
- [Get agent branch](https://elevenlabs.io/docs/api-reference/agents/branches/get) - `GET /v1/convai/agents/{agent_id}/branches/{branch_id}` - Get a specific branch
- [Update agent branch](https://elevenlabs.io/docs/api-reference/agents/branches/update) - `PATCH /v1/convai/agents/{agent_id}/branches/{branch_id}` - Update branch configuration
- [Merge agent branch](https://elevenlabs.io/docs/api-reference/agents/branches/merge) - `POST /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge` - Merge a branch into a target branch
- [Create deployment](https://elevenlabs.io/docs/api-reference/agents/deployments/create) - `POST /v1/convai/agents/{agent_id}/deployments` - Create or update agent deployments
- [Create draft](https://elevenlabs.io/docs/api-reference/agents/drafts/create) - `POST /v1/convai/agents/{agent_id}/drafts` - Create an agent draft
- [Delete draft](https://elevenlabs.io/docs/api-reference/agents/drafts/delete) - `DELETE /v1/convai/agents/{agent_id}/drafts` - Delete an agent draft
- [Create folder](/guides/changelog-api-reference-knowledge-base-create-folder) - `POST /v1/convai/knowledge-base/folder` - Create a folder for grouping documents
- [Move document](https://elevenlabs.io/docs/api-reference/knowledge-base/move-document) - `POST /v1/convai/knowledge-base/{document_id}/move` - Move a document to a folder
- [Bulk move](https://elevenlabs.io/docs/api-reference/knowledge-base/bulk-move) - `POST /v1/convai/knowledge-base/bulk-move` - Move multiple documents to a folder

## Updated Endpoints

### Agents Platform

- [Get tools](https://elevenlabs.io/docs/api-reference/tools/list)
  - 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](https://elevenlabs.io/docs/api-reference/agents/create)
  - Request schema updated with branching support
- [Get conversation](/guides/changelog-api-reference-conversations-get)
  - Added `agent_name` (string, optional) to response model
- [Create agent draft](https://elevenlabs.io/docs/api-reference/agents/drafts/create)
  - Made `tags` field optional and removed from required fields

### Pronunciation Dictionaries

- [Add rules](https://elevenlabs.io/docs/api-reference/pronunciation-dictionaries/rules/add)
  - Updated description to clarify that rules with duplicate `string_to_replace` values will be replaced

### Workspaces

- [Add workspace invite](/guides/changelog-api-reference-workspace-invites-create), [Add workspace member](/guides/changelog-api-reference-workspace-invites-create)
  - Added `seat_type` (enum, optional) field
  - Deprecated `workspace_permission` and `workspace_role` fields in favor of `seat_type`

### ElevenCreative Studio

- [Create project](/guides/api-reference-studio-add-project)
  - Added `create_publishing_read` (boolean, optional) field
  - Added `dub_video` to project type enum
- [Get project](/guides/api-reference-studio-get-project), [Update project](/guides/api-reference-studio-edit-project)
  - Added `caption_style_template_overrides` (object, optional) for custom caption styling

## Schema Changes

### New Schemas

- `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

### Modified Schemas

- `ToolsResponseModel` - Added `next_cursor` and `has_more` fields for pagination
- `SongMetadata` - Added `bpm` (number) and `time_signature` (string) fields
- `GetConversationResponseModel` - Added `agent_name` field
- `PermissionType` - Added `workspace_analytics_full_read` enum value
- `ProjectCreationType` - Added `dub_video` enum value
- Multiple event models - Added `error_type` field for error categorization
:::

## Related pages

- [Administration](./administration-index.md)
- [API reference](./api-reference-index.md)
- [Changelog](./changelog-index.md)
- [ElevenAgents](./elevenagents-index.md)
- [ElevenAPI](./elevenapi-index.md)
- [ElevenCreative](./elevencreative-index.md)
- [ElevenLabs Documentation Docs](../index.md)
- [General Troubleshooting FAQ](./troubleshooting-index.md)
- [General Website FAQ](./website-index.md)
- [Help Center](./help-center-2-index.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.