> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

### 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](/docs/api-reference/agents/branches/list) and [Deployments](/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](/docs/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](/docs/api-reference/knowledge-base/create-folder) for creating folders, [Move document](/docs/api-reference/knowledge-base/move-document) for moving single documents, and [Bulk move](/docs/api-reference/knowledge-base/bulk-move) for moving multiple documents at once.

### Tools

- **Enhanced tools listing**: The [Get tools](/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](/docs/api-reference/agents/branches/list) - `GET /v1/convai/agents/{agent_id}/branches` - List all branches for an agent
- [Create agent branch](/docs/api-reference/agents/branches/create) - `POST /v1/convai/agents/{agent_id}/branches` - Create a new branch for an agent
- [Get agent branch](/docs/api-reference/agents/branches/get) - `GET /v1/convai/agents/{agent_id}/branches/{branch_id}` - Get a specific branch
- [Update agent branch](/docs/api-reference/agents/branches/update) - `PATCH /v1/convai/agents/{agent_id}/branches/{branch_id}` - Update branch configuration
- [Merge agent branch](/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](/docs/api-reference/agents/deployments/create) - `POST /v1/convai/agents/{agent_id}/deployments` - Create or update agent deployments
- [Create draft](/docs/api-reference/agents/drafts/create) - `POST /v1/convai/agents/{agent_id}/drafts` - Create an agent draft
- [Delete draft](/docs/api-reference/agents/drafts/delete) - `DELETE /v1/convai/agents/{agent_id}/drafts` - Delete an agent draft
- [Create folder](/docs/api-reference/knowledge-base/create-folder) - `POST /v1/convai/knowledge-base/folder` - Create a folder for grouping documents
- [Move document](/docs/api-reference/knowledge-base/move-document) - `POST /v1/convai/knowledge-base/{document_id}/move` - Move a document to a folder
- [Bulk move](/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](/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](/docs/api-reference/agents/create)
  - Request schema updated with branching support
- [Get conversation](/docs/api-reference/conversations/get)
  - Added `agent_name` (string, optional) to response model
- [Create agent draft](/docs/api-reference/agents/drafts/create)
  - Made `tags` field optional and removed from required fields

### Pronunciation Dictionaries

- [Add rules](/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](/docs/api-reference/workspace/invites/create), [Add workspace member](/docs/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](/docs/api-reference/studio/add-project)
  - Added `create_publishing_read` (boolean, optional) field
  - Added `dub_video` to project type enum
- [Get project](/docs/api-reference/studio/get-project), [Update project](/docs/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

</Accordion>