January 26, 2026 | ElevenLabs Documentation

Branch e deployment degli agenti: aggiunto un sistema completo di controllo delle versioni per gli agenti, che consente ai team di creare branch, iterare sulle configurazioni degli agenti in isolamento e unire le modifiche quando sono pronte. I nuovi endpoint includono POST /v1/convai/agents/{agent_id}/branches per creare branch, POST /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge per unirli e POST /v1/convai/agents/{agent_id}/deployments per creare deployment. È inoltre possibile creare ed eliminare bozze tramite i nuovi endpoint delle bozze. Per i dettagli, consulta la documentazione su Branch e Deployment.
Gestione degli account WhatsApp: aggiunti gli endpoint PATCH e DELETE per gli account WhatsApp Business, che ti consentono di aggiornare e rimuovere dagli agenti gli account WhatsApp connessi.
Nome dell’agente nella conversazione: l’endpoint Ottieni conversazione ora restituisce agent_name nella risposta, per identificare più facilmente l’agente che ha gestito una conversazione.
Monitoraggio del tipo di errore: aggiunto il campo error_type ai modelli degli eventi di conversazione per migliorare il debug e la categorizzazione degli errori.

Gestione delle cartelle: aggiunto il supporto per organizzare i documenti della knowledge base in cartelle. I nuovi endpoint includono Crea cartella per creare cartelle, Sposta documento per spostare singoli documenti e Spostamento in blocco per spostare più documenti contemporaneamente.

Elenco degli strumenti migliorato: l’endpoint Ottieni strumenti ora supporta il filtraggio e la paginazione con nuovi parametri query, tra cui search, page_size, types, sort_by, sort_direction e cursor. La risposta ora include i campi next_cursor e has_more per la paginazione.

Miglioramenti ai metadati dei brani: aggiunti i campi bpm e time_signature ai metadati dei brani per informazioni più dettagliate sull’analisi audio.

Modelli di stile per i sottotitoli: aggiunto il campo caption_style_template_overrides ai modelli di progetto, che consente di personalizzare lo stile dei sottotitoli per ogni modello.
Tipo di progetto di doppiaggio video: aggiunto dub_video all’enum del tipo di creazione del progetto.
Metadati di pubblicazione: aggiunto il timestamp last_updated_from_project_unix ai metadati di pubblicazione e del progetto.

Gestione del tipo di posto: introdotto il nuovo enum SeatType con i campi seat_type e workspace_seat_type, deprecando i precedenti campi workspace_permission e workspace_role.
Autorizzazione per l’analisi del workspace: aggiunto workspace_analytics_full_read all’enum PermissionType per un controllo granulare dell’accesso ai dati di analisi.

v2.32.0 - Aggiunti endpoint per branch, deployment e bozze degli agenti, gestione delle cartelle della knowledge base, elenco degli strumenti migliorato con filtraggio e paginazione e gestione del tipo di posto

v2.33.0 - Aggiunti endpoint per branch, deployment e bozze degli agenti, gestione delle cartelle della knowledge base, elenco degli strumenti migliorato con filtraggio e paginazione e gestione del tipo di posto

Nuovi endpoint

Elenca i branch dell’agente - GET /v1/convai/agents/{agent_id}/branches - Elenca tutti i branch di un agente
Crea branch dell’agente - POST /v1/convai/agents/{agent_id}/branches - Crea un nuovo branch per un agente
Ottieni branch dell’agente - GET /v1/convai/agents/{agent_id}/branches/{branch_id} - Ottieni un branch specifico
Aggiorna branch dell’agente - PATCH /v1/convai/agents/{agent_id}/branches/{branch_id} - Aggiorna la configurazione del branch
Unisci branch dell’agente - POST /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge - Unisci un branch in un branch di destinazione
Crea deployment - POST /v1/convai/agents/{agent_id}/deployments - Crea o aggiorna i deployment degli agenti
Crea bozza - POST /v1/convai/agents/{agent_id}/drafts - Crea una bozza dell’agente
Elimina bozza - DELETE /v1/convai/agents/{agent_id}/drafts - Elimina una bozza dell’agente
Crea cartella - POST /v1/convai/knowledge-base/folder - Crea una cartella per raggruppare i documenti
Sposta documento - POST /v1/convai/knowledge-base/{document_id}/move - Sposta un documento in una cartella
Spostamento in blocco - POST /v1/convai/knowledge-base/bulk-move - Sposta più documenti in una cartella

Ottieni strumenti
- Aggiunto il parametro query search (stringa, facoltativo) per filtrare gli strumenti in base al prefisso del nome
- Aggiunto il parametro query page_size (intero, facoltativo, massimo 100, valore predefinito 30)
- Aggiunto il parametro query show_only_owned_documents (booleano, facoltativo, valore predefinito false)
- Aggiunto il parametro query types (array, facoltativo) per filtrare in base al tipo di strumento
- Aggiunto il parametro query sort_by (enum, facoltativo) per ordinare i risultati
- Aggiunto il parametro query sort_direction (enum, facoltativo) per l’ordine di ordinamento
- Aggiunto il parametro query cursor (stringa, facoltativo) per la paginazione
- La risposta ora include i campi next_cursor (stringa) e has_more (booleano, obbligatorio)
Crea agente
- Schema della richiesta aggiornato con supporto per i branch
Ottieni conversazione
- Aggiunto agent_name (stringa, facoltativo) al modello di risposta
Crea bozza dell’agente
- Il campo tags ora è facoltativo ed è stato rimosso dai campi obbligatori

Aggiungi regole
- Descrizione aggiornata per chiarire che le regole con valori string_to_replace duplicati verranno sostituite

Aggiungi invito al workspace, Aggiungi membro al workspace
- Aggiunto il campo seat_type (enum, facoltativo)
- Deprecati i campi workspace_permission e workspace_role a favore di seat_type

Crea progetto
- Aggiunto il campo create_publishing_read (booleano, facoltativo)
- Aggiunto dub_video all’enum del tipo di progetto
Ottieni progetto, Aggiorna progetto
- Aggiunto caption_style_template_overrides (oggetto, facoltativo) per lo stile personalizzato dei sottotitoli

AgentBranch, AgentBranchInput, AgentBranchOutput - Configurazione dei branch per gli agenti
AgentDeployment, AgentDeploymentInput - Configurazione dei deployment per gli agenti
AgentVersion - Informazioni sulla versione dell’agente
BranchProtectionStatus - Impostazioni di protezione dei branch
SeatType - Enum per i tipi di posto del workspace
ToolSortBy - Enum per le opzioni di ordinamento degli strumenti
ToolTypeFilter - Enum per filtrare gli strumenti per tipo
CaptionStyleModel - Configurazione dello stile dei sottotitoli

ToolsResponseModel - Aggiunti i campi next_cursor e has_more per la paginazione
SongMetadata - Aggiunti i campi bpm (numero) e time_signature (stringa)
GetConversationResponseModel - Aggiunto il campo agent_name
PermissionType - Aggiunto il valore enum workspace_analytics_full_read
ProjectCreationType - Aggiunto il valore enum dub_video
Più modelli di eventi - Aggiunto il campo error_type per la categorizzazione degli errori