January 26, 2026 | ElevenLabs Documentation

Ramificación e implementaciones de agentes: Se ha añadido un sistema completo de control de versiones para agentes que permite a los equipos crear ramas, iterar en las configuraciones de los agentes de forma aislada y fusionar cambios cuando estén listos. Las nuevas rutas incluyen POST /v1/convai/agents/{agent_id}/branches para crear ramas, POST /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge para fusionarlas y POST /v1/convai/agents/{agent_id}/deployments para crear implementaciones. También se pueden crear y eliminar borradores mediante las nuevas rutas de borradores. Consulta la documentación de Ramas e Implementaciones para obtener más información.
Gestión de cuentas de WhatsApp: Se han añadido rutas PATCH y DELETE para cuentas de WhatsApp Business, que te permiten actualizar y eliminar cuentas de WhatsApp conectadas de los agentes.
Nombre del agente de la conversación: La ruta Obtener conversación ahora devuelve agent_name en la respuesta para identificar más fácilmente qué agente gestionó una conversación.
Seguimiento de tipos de error: Se ha añadido el campo error_type a los modelos de eventos de conversación para mejorar la depuración y categorización de errores.

Gestión de carpetas: Se ha añadido compatibilidad para organizar documentos de la base de conocimiento en carpetas. Las nuevas rutas incluyen Crear carpeta para crear carpetas, Mover documento para mover documentos individuales y Mover en bloque para mover varios documentos a la vez.

Listado de herramientas mejorado: La ruta Obtener herramientas ahora admite filtrado y paginación con nuevos parámetros de consulta, incluidos search, page_size, types, sort_by, sort_direction y cursor. La respuesta ahora incluye los campos next_cursor y has_more para la paginación.

Mejoras en los metadatos de canciones: Se han añadido los campos bpm y time_signature a los metadatos de canciones para ofrecer información más completa en el análisis de audio.

Plantillas de estilo de subtítulos: Se ha añadido el campo caption_style_template_overrides a los modelos de proyecto, lo que permite personalizar el estilo de los subtítulos por plantilla.
Tipo de proyecto de doblaje de vídeo: Se ha añadido dub_video al enum de tipos de creación de proyecto.
Metadatos de publicación: Se ha añadido la marca de tiempo last_updated_from_project_unix a los metadatos de publicación y de proyecto.

Gestión de tipos de plaza: Se ha introducido el nuevo enum SeatType con los campos seat_type y workspace_seat_type, quedando obsoletos los campos anteriores workspace_permission y workspace_role.
Permiso de analítica del espacio de trabajo: Se ha añadido workspace_analytics_full_read al enum PermissionType para un control de acceso granular a la analítica.

v2.32.0 - Se han añadido rutas de ramificación, implementaciones y borradores de agentes, gestión de carpetas de la base de conocimiento, un listado de herramientas mejorado con filtrado y paginación, y gestión de tipos de plaza

v2.33.0 - Se han añadido rutas de ramificación, implementaciones y borradores de agentes, gestión de carpetas de la base de conocimiento, un listado de herramientas mejorado con filtrado y paginación, y gestión de tipos de plaza

Nuevas rutas

Listar ramas de agentes - GET /v1/convai/agents/{agent_id}/branches - Lista todas las ramas de un agente
Crear rama de agente - POST /v1/convai/agents/{agent_id}/branches - Crea una nueva rama para un agente
Obtener rama de agente - GET /v1/convai/agents/{agent_id}/branches/{branch_id} - Obtén una rama específica
Actualizar rama de agente - PATCH /v1/convai/agents/{agent_id}/branches/{branch_id} - Actualiza la configuración de la rama
Fusionar rama de agente - POST /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge - Fusiona una rama en una rama de destino
Crear implementación - POST /v1/convai/agents/{agent_id}/deployments - Crea o actualiza implementaciones de agentes
Crear borrador - POST /v1/convai/agents/{agent_id}/drafts - Crea un borrador de agente
Eliminar borrador - DELETE /v1/convai/agents/{agent_id}/drafts - Elimina un borrador de agente
Crear carpeta - POST /v1/convai/knowledge-base/folder - Crea una carpeta para agrupar documentos
Mover documento - POST /v1/convai/knowledge-base/{document_id}/move - Mueve un documento a una carpeta
Mover en bloque - POST /v1/convai/knowledge-base/bulk-move - Mueve varios documentos a una carpeta

Obtener herramientas
- Se ha añadido el parámetro de consulta search (cadena, opcional) para filtrar herramientas por prefijo de nombre
- Se ha añadido el parámetro de consulta page_size (entero, opcional, máximo 100, valor predeterminado 30)
- Se ha añadido el parámetro de consulta show_only_owned_documents (booleano, opcional, valor predeterminado false)
- Se ha añadido el parámetro de consulta types (array, opcional) para filtrar por tipo de herramienta
- Se ha añadido el parámetro de consulta sort_by (enum, opcional) para ordenar resultados
- Se ha añadido el parámetro de consulta sort_direction (enum, opcional) para el orden de clasificación
- Se ha añadido el parámetro de consulta cursor (cadena, opcional) para la paginación
- La respuesta ahora incluye los campos next_cursor (cadena) y has_more (booleano, obligatorio)
Crear agente
- Se ha actualizado el esquema de solicitud con compatibilidad para ramificación
Obtener conversación
- Se ha añadido agent_name (cadena, opcional) al modelo de respuesta
Crear borrador de agente
- El campo tags ahora es opcional y se ha eliminado de los campos obligatorios

Añadir reglas
- Se ha actualizado la descripción para aclarar que se sustituirán las reglas con valores string_to_replace duplicados

Añadir invitación al espacio de trabajo, Añadir miembro al espacio de trabajo
- Se ha añadido el campo seat_type (enum, opcional)
- Los campos workspace_permission y workspace_role han quedado obsoletos en favor de seat_type

Crear proyecto
- Se ha añadido el campo create_publishing_read (booleano, opcional)
- Se ha añadido dub_video al enum de tipos de proyecto
Obtener proyecto, Actualizar proyecto
- Se ha añadido caption_style_template_overrides (objeto, opcional) para estilos de subtítulos personalizados

AgentBranch, AgentBranchInput, AgentBranchOutput - Configuración de ramas para agentes
AgentDeployment, AgentDeploymentInput - Configuración de implementaciones para agentes
AgentVersion - Información de la versión del agente
BranchProtectionStatus - Ajustes de protección de ramas
SeatType - Enum para tipos de plaza del espacio de trabajo
ToolSortBy - Enum para opciones de ordenación de herramientas
ToolTypeFilter - Enum para filtrar herramientas por tipo
CaptionStyleModel - Configuración de estilo de subtítulos

ToolsResponseModel - Se han añadido los campos next_cursor y has_more para la paginación
SongMetadata - Se han añadido los campos bpm (número) y time_signature (cadena)
GetConversationResponseModel - Se ha añadido el campo agent_name
PermissionType - Se ha añadido el valor enum workspace_analytics_full_read
ProjectCreationType - Se ha añadido el valor enum dub_video
Varios modelos de eventos - Se ha añadido el campo error_type para la categorización de errores