January 26, 2026 | ElevenLabs Documentation

Ramificações e implantações de agentes: Adicionado um sistema completo de controle de versões para agentes, permitindo que as equipes criem ramificações, iterem nas configurações dos agentes de forma isolada e mesclem as alterações quando estiverem prontas. Os novos endpoints incluem POST /v1/convai/agents/{agent_id}/branches para criar ramificações, POST /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge para mesclar e POST /v1/convai/agents/{agent_id}/deployments para criar implantações. Rascunhos também podem ser criados e excluídos pelos novos endpoints de rascunhos. Consulte a documentação de Ramificações e Implantações para mais detalhes.
Gerenciamento de contas do WhatsApp: Adicionados endpoints PATCH e DELETE para contas do WhatsApp Business, permitindo atualizar e remover dos agentes as contas conectadas do WhatsApp.
Nome do agente na conversa: O endpoint Obter conversa agora retorna agent_name na resposta para facilitar a identificação do agente que conduziu uma conversa.
Acompanhamento de tipos de erro: Adicionado o campo error_type aos modelos de eventos de conversa para melhorar a depuração e a categorização de erros.

Gerenciamento de pastas: Adicionado suporte para organizar documentos da base de conhecimento em pastas. Os novos endpoints incluem Criar pasta para criar pastas, Mover documento para mover documentos individuais e Mover em massa para mover vários documentos de uma vez.

Listagem de ferramentas aprimorada: O endpoint Obter ferramentas agora oferece suporte a filtragem e paginação com novos parâmetros de consulta, incluindo search, page_size, types, sort_by, sort_direction e cursor. A resposta agora inclui os campos next_cursor e has_more para paginação.

Melhorias nos metadados da música: Adicionados os campos bpm e time_signature aos metadados da música para fornecer informações mais completas de análise de áudio.

Modelos de estilo de legenda: Adicionado o campo caption_style_template_overrides aos modelos de projeto, permitindo personalizar o estilo das legendas por modelo.
Tipo de projeto de dublagem de vídeo: Adicionado dub_video ao enum de tipo de criação de projeto.
Metadados de publicação: Adicionado o carimbo de data e hora last_updated_from_project_unix aos metadados de publicação e de projeto.

Gerenciamento de tipos de assento: Introduzido o novo enum SeatType com os campos seat_type e workspace_seat_type, descontinuando os campos anteriores workspace_permission e workspace_role.
Permissão de análises do workspace: Adicionado workspace_analytics_full_read ao enum PermissionType para controle de acesso granular às análises.

v2.32.0 - Adicionados endpoints de ramificações, implantações e rascunhos de agentes, gerenciamento de pastas da base de conhecimento, listagem de ferramentas aprimorada com filtragem e paginação, e gerenciamento de tipos de assento

v2.33.0 - Adicionados endpoints de ramificações, implantações e rascunhos de agentes, gerenciamento de pastas da base de conhecimento, listagem de ferramentas aprimorada com filtragem e paginação, e gerenciamento de tipos de assento

Novos endpoints

Listar ramificações de agentes - GET /v1/convai/agents/{agent_id}/branches - Lista todas as ramificações de um agente
Criar ramificação de agente - POST /v1/convai/agents/{agent_id}/branches - Cria uma nova ramificação para um agente
Obter ramificação de agente - GET /v1/convai/agents/{agent_id}/branches/{branch_id} - Obtém uma ramificação específica
Atualizar ramificação de agente - PATCH /v1/convai/agents/{agent_id}/branches/{branch_id} - Atualiza a configuração da ramificação
Mesclar ramificação de agente - POST /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge - Mescla uma ramificação em uma ramificação de destino
Criar implantação - POST /v1/convai/agents/{agent_id}/deployments - Cria ou atualiza implantações de agentes
Criar rascunho - POST /v1/convai/agents/{agent_id}/drafts - Cria um rascunho de agente
Excluir rascunho - DELETE /v1/convai/agents/{agent_id}/drafts - Exclui um rascunho de agente
Criar pasta - POST /v1/convai/knowledge-base/folder - Cria uma pasta para agrupar documentos
Mover documento - POST /v1/convai/knowledge-base/{document_id}/move - Move um documento para uma pasta
Mover em massa - POST /v1/convai/knowledge-base/bulk-move - Move vários documentos para uma pasta

Obter ferramentas
- Adicionado o parâmetro de consulta search (string, opcional) para filtrar ferramentas pelo prefixo do nome
- Adicionado o parâmetro de consulta page_size (inteiro, opcional, máximo 100, padrão 30)
- Adicionado o parâmetro de consulta show_only_owned_documents (booleano, opcional, padrão false)
- Adicionado o parâmetro de consulta types (array, opcional) para filtrar por tipo de ferramenta
- Adicionado o parâmetro de consulta sort_by (enum, opcional) para ordenar os resultados
- Adicionado o parâmetro de consulta sort_direction (enum, opcional) para a ordem de classificação
- Adicionado o parâmetro de consulta cursor (string, opcional) para paginação
- A resposta agora inclui os campos next_cursor (string) e has_more (booleano, obrigatório)
Criar agente
- Esquema da solicitação atualizado com suporte a ramificações
Obter conversa
- Adicionado agent_name (string, opcional) ao modelo de resposta
Criar rascunho de agente
- O campo tags passou a ser opcional e foi removido dos campos obrigatórios

Adicionar regras
- Descrição atualizada para esclarecer que regras com valores string_to_replace duplicados serão substituídas

Adicionar convite ao workspace, Adicionar membro ao workspace
- Adicionado o campo seat_type (enum, opcional)
- Descontinuados os campos workspace_permission e workspace_role em favor de seat_type

Criar projeto
- Adicionado o campo create_publishing_read (booleano, opcional)
- Adicionado dub_video ao enum de tipo de projeto
Obter projeto, Atualizar projeto
- Adicionado caption_style_template_overrides (objeto, opcional) para estilo de legenda personalizado

AgentBranch, AgentBranchInput, AgentBranchOutput - Configuração de ramificações para agentes
AgentDeployment, AgentDeploymentInput - Configuração de implantações para agentes
AgentVersion - Informações sobre a versão do agente
BranchProtectionStatus - Configurações de proteção de ramificação
SeatType - Enum para tipos de assento no workspace
ToolSortBy - Enum para opções de ordenação de ferramentas
ToolTypeFilter - Enum para filtrar ferramentas por tipo
CaptionStyleModel - Configuração de estilo de legenda

ToolsResponseModel - Adicionados os campos next_cursor e has_more para paginação
SongMetadata - Adicionados os campos bpm (número) e time_signature (string)
GetConversationResponseModel - Adicionado o campo agent_name
PermissionType - Adicionado o valor de enum workspace_analytics_full_read
ProjectCreationType - Adicionado o valor de enum dub_video
Vários modelos de eventos - Adicionado o campo error_type para categorização de erros