Registro delle modifiche

Nuovi endpoint

ElevenAgents

• Crea una proposta di merge - POST /v1/convai/agents/{agent_id}/merge-proposals - Crea una proposta con i campi obbligatori source_branch_id, target_branch_id e title, oltre a una descrizione facoltativa, ID revisori e ID ticket di triage.
• Elenca proposte di merge - GET /v1/convai/agents/{agent_id}/merge-proposals - Elenca le proposte con filtri per stato, branch di origine, branch di destinazione e testo, oltre alla paginazione tramite cursore.
• Ottieni una proposta di merge - GET /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id} - Recupera una proposta e i dettagli relativi a revisione, commenti ed esito.
• Aggiorna una proposta di merge - PATCH /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id} - Aggiorna titolo, descrizione o revisori richiesti, oppure chiudila senza eseguire il merge.
• Esamina una proposta di merge - POST /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}/reviews - Invia una decisione approved o changes_requested con un commento facoltativo.
• Commenta una proposta di merge - POST /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}/comments - Aggiungi un commento Markdown fino a 4.096 caratteri.
• Unisci una proposta di merge - POST /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}/merge - Unisci il branch di origine e controlla facoltativamente la risoluzione forzata dei conflitti e l’archiviazione del branch di origine.
• Elenca deployment degli agenti - GET /v1/convai/agents/{agent_id}/deployments - Elenca le suddivisioni del traffico correnti e cronologiche dei branch con paginazione basata sulle pagine.
• Annulla un’invocazione di test - POST /v1/convai/test-invocations/{test_invocation_id}/cancel - Annulla un’invocazione di test in esecuzione.

Speech Engine

• Duplica uno Speech Engine - POST /v1/speech-engine/{speech_engine_id}/duplicate - Duplica uno Speech Engine e assegna facoltativamente alla copia un nuovo name.

Endpoint aggiornati

ElevenAgents

• Crea agente, Ottieni agente e Aggiorna agente
  • Aggiunti gpt-6.1-sol e claude-sonnet-5-5 all’enum LLM.
  • Aggiunti eleven_v4 e eleven_v4_turbo alle opzioni del modello TTS conversazionale. Il valore predefinito è passato da eleven_flash_v2 a eleven_v4_turbo.
  • I trasferimenti degli agenti e i nodi degli agenti workflow autonomi aggiungono preserve_voice_settings facoltativo (booleano, valore predefinito false) per mantenere la voce di base, il modello TTS e le impostazioni vocali dopo un trasferimento.
  • Le configurazioni dello strumento per saltare il turno aggiungono wait_timeout_secs facoltativo (numero, valore predefinito -1). Il valore -1 mantiene l’agente in silenzio finché il chiamante non parla.
  • Le configurazioni webhook post-chiamata aggiungono exclude_transcript facoltativo (booleano, valore predefinito false) per omettere le trascrizioni turno per turno dai webhook di trascrizione JSON.
  • Le configurazioni di redazione della cronologia delle conversazioni aggiungono excluded_data_collection_ids facoltativo (array di stringhe, massimo 50) per mantenere i valori estratti selezionati mentre vengono oscurate le relative motivazioni.
  • response_timeout_secs dello strumento client ora accetta -1 per attendere indefinitamente quando expects_response è abilitato.
• Elenca ticket
  • Aggiunto priorities facoltativo (array) con valori low, medium, high e urgent.
  • Aggiunto sort_by con valori created_at e priority; il valore predefinito è created_at.
  • Le risposte dei ticket ora richiedono title, priority nullable e un array priority_changes. Le richieste di creazione e aggiornamento dei ticket possono impostare priority e lo stato del ticket aggiunge cancelled.
• Elenca strumenti - Aggiunto used_by_agent_id facoltativo e nullable (stringa) per restituire gli strumenti a cui fa riferimento il branch principale di un agente.
• Esporta risultati delle chiamate batch - Aggiunto limit facoltativo e nullable (intero, minimo 1) per esportare solo i primi destinatari come anteprima di colonna.
• Elenca invocazioni di test e Ottieni invocazione di test
  • I riepiloghi delle invocazioni di test aggiungono cancelled_count obbligatorio (intero) e cancelled facoltativo (booleano, valore predefinito false).
  • Lo stato dell’esecuzione di test aggiunge cancelled.
• Ottieni dettagli della conversazione - Le voci della trascrizione aggiungono platform_event facoltativo e nullable con valori user_turn_timeout e skip_turn_wait_elapsed.
• Ottieni metadati della versione dell’agente - Aggiunto merged_authors facoltativo e nullable, un array che descrive le persone che hanno pubblicato modifiche unite nel branch principale.
• Ottieni job di crawling - Rimosso il campo di risposta deprecato max_depth.

Nuovi endpoint

Flows

• Elenca template - GET /v1/flows/templates - Elenca i template pubblicati e le relative versioni eseguibili.
• Ottieni template - GET /v1/flows/templates/{template_id} - Recupera un template e le relative versioni eseguibili.
• Crea esecuzione di un template - POST /v1/flows/templates/{template_id}/runs - Avvia l’esecuzione di un template con valori di input, una versione facoltativa e un webhook facoltativo.
• Elenca esecuzioni di template - GET /v1/flows/templates/{template_id}/runs - Elenca le esecuzioni di template con paginazione tramite cursore e filtro di versione facoltativo.
• Ottieni esecuzione di un template - GET /v1/flows/templates/{template_id}/runs/{run_id} - Recupera l’esecuzione di un template e lo stato del relativo output.

Endpoint aggiornati

Speech to Text

• Converti parlato in testo - POST /v1/speech-to-text
  • Aggiunto transcript_edit facoltativo e nullable (stringa), che accetta un’istruzione di modifica in linguaggio naturale fino a 2.000 caratteri.
  • Le risposte aggiungono edited_transcript facoltativo e nullable. Una modifica riuscita contiene i campi obbligatori kind: "transcript" e text. Una modifica non riuscita contiene i campi obbligatori kind: "error", error_type: "edit_failed" e message.
• Speech to Text in tempo reale accetta transcript_edit (stringa) ed emette eventi edited_transcript con i campi obbligatori text e edited_text.

ElevenAgents

• Crea agente, Ottieni agente e Aggiorna agente
  • Aggiunti gpt-6-sol, gpt-6-luna, glm-52, deepseek-v41-flash, claude-opus-5 e claude-opus-5-5 all’enum LLM.
  • I monitor di avviso aggiungono enabled facoltativo e nullable (booleano) per controllare se un monitor può inviare notifiche.
• Elenca conversazioni e Ricerca testuale
  • data_collection_params e dynamic_variable_params aggiungono gli operatori neq e in. I valori di in usano un delimitatore pipe.
  • evaluation_params accetta success, failure o unknown come valore del risultato.
• Ricerca intelligente - GET /v1/convai/conversations/messages/smart-search
  • Aggiunto branch_id facoltativo e nullable (stringa).
• Elenca invocazioni di test - GET /v1/convai/test-invocations
  • Aggiunto branch_id facoltativo e nullable (stringa).
  • I riepiloghi delle invocazioni di test aggiungono credits_used facoltativo e nullable (intero) e total_price (numero).
• Ottieni invocazione di test - GET /v1/convai/test-invocations/{test_invocation_id}
  • Le singole esecuzioni di test aggiungono credits_used facoltativo e nullable (intero) e charging (ConversationChargingCommonModel).
• Simula conversazione e Simula stream di conversazione
  • Modificato il valore predefinito facoltativo di new_turns_limit da 10,000 a 100 e impostato il valore massimo a 100.
• Crea job di crawling e Ottieni job di crawling
  • Aggiunto auto_discover facoltativo (booleano, valore predefinito false) per seguire i link e aggiungere le pagine appena individuate durante la sincronizzazione automatica. Richiede enable_auto_sync: true.
• Aggiorna documento della knowledge base - POST /v1/convai/knowledge-base/{documentation_id}/refresh
  • AutoSyncInfo aggiunge auto_discover facoltativo (booleano, valore predefinito false) per indicare se gli aggiornamenti eseguono il crawling e aggiungono le pagine appena individuate.
• Elenca strumenti del server MCP - GET /v1/convai/mcp-servers/{mcp_server_id}/tools
  • Le risposte aggiungono tool_approval_statuses facoltativo (array). Ogni elemento contiene tool_id obbligatorio (stringa) e state (up_to_date, needs_review o not_approved), con campi facoltativi relativi alla policy di approvazione e alla definizione approvata.

Text to Dialogue

• Converti testo in dialogo, Trasmetti testo in dialogo, Converti con timestamp e Trasmetti con timestamp
  • Aggiunto use_pvc_as_ivc facoltativo (booleano, valore predefinito false) per usare la versione Instant Voice Clone di una Professional Voice Clone.
  • Aggiunti previous_text e future_text facoltativi e nullable (stringhe, massimo 100 caratteri) e previous_request_ids e next_request_ids (array di stringhe, massimo 3 ID) per la continuità della generazione.
  • L’oggetto settings facoltativo aggiunge similarity nullable (numero, 0–1, valore predefinito 0.75).

Text to Speech

• Converti testo in parlato, Trasmetti testo in parlato, Converti con timestamp e Trasmetti con timestamp
  • Il campo use_pvc_as_ivc esistente non è più deprecato.

Flows

• Crea generazione di immagini, Crea generazione di video e Crea esecuzione di un template
  • Le destinazioni webhook ora richiedono un discriminatore type esplicito (all o ids). I valori predefiniti precedenti sono stati rimossi.

Voice Design

• Crea voce dall’anteprima, Crea anteprime vocali, Progetta una voce e Remixa una voce
  • Aggiunta una risposta 409 quando è già in corso una generazione per l’anteprima. Riprova la richiesta dopo aver ricevuto questa risposta.

Workspace

• Crea chiave API dell’account di servizio - POST /v1/service-accounts/{service_account_user_id}/api-keys
  • Aggiunti tts_concurrency_limit, music_concurrency_limit e dubbing_concurrency_limit facoltativi e nullable (interi) per le chiavi API degli account di servizio Enterprise.
• Aggiorna chiave API dell’account di servizio - PATCH /v1/service-accounts/{service_account_user_id}/api-keys/{api_key_id}
  • Aggiunti tts_concurrency_limit, music_concurrency_limit e dubbing_concurrency_limit facoltativi. Ogni campo accetta un intero, clear, no_update o null e il valore predefinito è no_update.

Modelli

• Elenca modelli - GET /v1/models
  • Deprecati i campi obbligatori max_characters_request_free_user e max_characters_request_subscribed_user. Questi campi non vengono applicati; usa invece maximum_text_length_per_request.

Nuovi endpoint

ElevenAgents

• Elenca pagina dei numeri di telefono - GET /v1/convai/v2/phone-numbers
  • Aggiunti i parametri di paginazione page_size facoltativo (intero, 1–1.000, predefinito 100) e cursor (stringa nullable).
  • Aggiunti i filtri facoltativi search, label, phone_number, provider, supports_outbound, agent_id, branch_id, sort_by e sort_direction. sort_by accetta label o phone_number; sort_direction è predefinito su asc.
  • La risposta contiene phone_numbers obbligatorio (array), next_cursor facoltativo e nullable (stringa) e has_more (booleano, predefinito false).

Endpoint aggiornati

ElevenAgents

• Crea agente, Ottieni agente e Aggiorna agente
  • La configurazione del prompt aggiunge enable_parallel_tool_calls (booleano, predefinito true). Gli override del workflow accettano un booleano nullable.
  • L’enum LLM aggiunge gpt-6-astra, inclusi gli override per l’avvio della conversazione.
  • I notificatori dell’integrazione di avvisi ora usano integration_type per selezionare pagerduty o slack. I notificatori Slack richiedono connection_id e channel_id (stringhe); channel_id accetta da 1 a 64 caratteri.
• Elenca conversazioni e Risolvi riferimento conversazione
  • data_collection_params non accetta più l’operatore missing. Usa un valore vuoto per trovare le conversazioni in cui il campo non è stato raccolto.
  • Un valore vuoto in dynamic_variable_params trova le conversazioni in cui la variabile non è stata impostata.
• Crea Speech Engine, Ottieni Speech Engine e Aggiorna Speech Engine
  • Aggiunto cascade_timeout_seconds (numero, 2–15). Le richieste di creazione sono predefinite su 4, quelle di aggiornamento accettano un valore nullable e le risposte richiedono il campo.

Immagini e video

• Crea generazione di immagini - POST /v1/flows/image
  • Aggiunte varianti della richiesta per gpt-image-2.5-flare e gpt-image-2.5-sunburst.
  • Entrambe le varianti richiedono prompt e model_id, accettano fino a 10 images e aggiungono resolution (1K, 2K o 4K, predefinito 1K).
  • quality accetta low, medium, high, xhigh o max ed è predefinito su high. aspect_ratio accetta auto e 14 rapporti fissi ed è predefinito su 16:9.

Doppiaggio

• Crea progetto di doppiaggio - POST /v1/dubbing/project
  • keyterms multipart accetta campi ripetuti o un singolo array JSON.
  • webhook_ids multipart accetta campi ripetuti, un singolo array JSON o una stringa separata da virgole.
• Ottieni risorsa del workspace, Condividi risorsa del workspace e Annulla condivisione risorsa del workspace
  • WorkspaceResourceType aggiunge dubbing_project.

Knowledge base

• Crea job di crawling - POST /v1/convai/knowledge-base/crawl
  • Deprecato max_depth (intero, predefinito 3). Il campo ora non ha effetto e non presenta più vincoli minimi o massimi.
  • I metadati del job di crawling non richiedono più max_depth.

Utente

• Ottieni utente e Ottieni abbonamento
  • Gli enum delle valute aggiungono gbp.

Modifiche allo schema

Text to Speech

• I messaggi WebSocket audio e final multi-contesto ora definiscono is_final_audio_for_turn come emesso dopo che tutti i byte nel buffer del turno sono stati forniti.

Nuovi endpoint

ElevenAgents

• Carica audio di attesa dell’agente - POST /v1/convai/agents/{agent_id}/hold-audio
  • Accetta hold_audio_file obbligatorio (binario) come dati del form multipart. Il file deve essere MP3 o WAV, fino a 40 MB e 180 secondi.
  • Restituisce agent_id obbligatorio (stringa) e hold_audio (AgentHoldAudioConfig). L’oggetto hold-audio richiede audio_path, audio_url, original_filename (stringhe), duration_secs (numero) e size_bytes (intero).
• Elimina audio di attesa dell’agente - DELETE /v1/convai/agents/{agent_id}/hold-audio
  • Rimuove la clip personalizzata, così i chiamanti in coda sentono il tono di attesa predefinito.
  • Restituisce agent_id obbligatorio (stringa).

Endpoint aggiornati

ElevenAgents

• Crea agente, Ottieni agente e Aggiorna agente
  • Aggiunto platform_settings.queueing_config (AgentQueueingConfig) facoltativo con enabled (booleano, predefinito false) e wait_timeout_seconds (intero, 1–1.800, predefinito 180).
  • Le risposte di configurazione della coda includono hold_audio (AgentHoldAudioConfig) nullable di sola lettura. Le risposte dell’agente includono anche default_hold_audio_url facoltativo (stringa).
• Ottieni conversazione - GET /v1/convai/conversations/{conversation_id}
  • I metadati aggiungono queue_wait_secs facoltativo e nullable (numero). Il tempo in coda è escluso da call_duration_secs e dal tempo fatturato.
• Crea ramo dell’agente - POST /v1/convai/agents/{agent_id}/branches
  • Aggiunto include_draft facoltativo (booleano, predefinito false). Quando è true, un ramo creato dalla punta del ramo include il set di procedure in bozza del chiamante.
• Elenca procedure e gli endpoint per creare, ottenere e gestire le bozze delle procedure
  • Gli elementi dell’elenco aggiungono referenced_tool_ids, referenced_kb_ids, referenced_procedure_ids e referenced_dynamic_variables facoltativi (array di stringhe).
  • Le risposte dell’agente e di anteprima del merge aggiungono procedures facoltativo, una mappa con chiave ID della procedura.
• Elenca invocation di test - GET /v1/convai/test-invocations
  • Aggiunto search facoltativo e nullable (stringa) per filtrare test e cartelle per nome.
• Esegui test sull’agente e Ottieni invocation di test
  • Le risposte di invocation della suite di test e di esecuzione dei test unitari aggiungono version_id facoltativo e nullable (stringa) e ran_against_draft facoltativo (booleano, predefinito false).
  • I riepiloghi delle invocation aggiungono anche runs_diverged_from_version facoltativo (booleano, predefinito false).
• POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query
  • Il body della richiesta aggiunge gli override specifici della query max_documents_length facoltativo e nullable (intero, 1–50.000) e max_retrieved_rag_chunks_count (intero, 1–20).
• Ottieni account WhatsApp - GET /v1/convai/whatsapp-accounts/{phone_number_id}
  • Aggiunto account_type facoltativo (WhatsAppAccountType, predefinito cloud_api). I valori sono cloud_api e coexistence.
• Calcola l’utilizzo LLM previsto - POST /v1/convai/agent/{agent_id}/llm-usage/calculate
  • LLMUsageCalculatorLLMResponseModel aggiunge price_per_message obbligatorio (numero).

Musica

• MusicModelID aggiunge music_v2_5 per POST /v1/music/video-to-music, POST /v1/music/plan, Componi musica, POST /v1/music/detailed, POST /v1/music/detailed/stream, POST /v1/music/stream, POST /v1/music/upload e POST /v1/music/finetunes.
• GenerationChunk.text aumenta maxLength da 6.000 a 6.132 caratteri per POST /v1/music/plan, POST /v1/music, POST /v1/music/detailed, POST /v1/music/detailed/stream, POST /v1/music/stream e POST /v1/music/upload. I nomi delle sezioni possono contenere da 1 a 100 caratteri e i chunk possono contenere fino a 30 righe con 200 caratteri per riga.

Modifiche allo schema

ElevenAgents

• Gli eventi del server in tempo reale aggiungono queue_status. Il relativo queue_status_event.status obbligatorio accetta waiting, admitted o timed_out; timed_out precede il codice di chiusura WebSocket 4300. L’audio di attesa continua ad arrivare come normali eventi audio.
• L’enum LLM aggiunge gemini-3.8-flash, inclusi gli override per l’avvio della conversazione.
• Le union dei risultati degli strumenti di sistema delle conversazioni aggiungono start_procedure_success, start_procedure_error, end_procedure_success e end_procedure_error.
• FeaturesUsageCommonModel aggiunge gli stati delle funzionalità facoltativi freeform_procedure e structured_procedure.

Nuovi endpoint

ElevenAgents

• Elenca ticket del workspace - GET /v1/convai/triage-tickets
  • Elenca i ticket di triage delle conversazioni per tutti gli agenti a cui il chiamante può accedere, ordinati prima per data di creazione più recente.
  • Aggiunti i parametri query facoltativi page_size (numero intero, 1–100, valore predefinito 100), status (AgentConversationTicketStatus), assignee_user_id (stringa o unassigned) e cursor (stringa).
  • Restituisce GetAgentConversationTicketsPageResponseModel.

Endpoint aggiornati

ElevenAgents

• Elenca conversazioni - GET /v1/convai/conversations
  • Aggiunto dynamic_variable_params facoltativo e annullabile (array di stringhe ripetibile). Ogni valore usa name:op:value, dove op è eq, gt, gte, lt o lte.
• Ricerca testuale nei messaggi delle conversazioni - GET /v1/convai/conversations/messages/text-search
  • Aggiunto dynamic_variable_params facoltativo e annullabile (array di stringhe ripetibile) con la stessa sintassi.
• Chiamata Twilio in uscita, Chiamata in uscita tramite trunk SIP, Chiamata Exotel in uscita e Invia chiamate batch
  • telephony_call_config ora usa schemi di input e output separati.
  • Aggiunto twilio_machine_detection facoltativo e annullabile (TwilioMachineDetectionConfig). Il relativo mode accetta enable o detect_message_end e il valore predefinito è enable. L’impostazione viene ignorata per i provider non Twilio e le chiamate in entrata.
• Importa numero di telefono - POST /v1/convai/phone-numbers
  • Aggiunto account_auth_token facoltativo e annullabile (stringa) per le importazioni di chiavi API Twilio, al fine di convalidare le firme dei webhook in entrata.

Modifiche agli schemi

ElevenAgents

• WebhookEventType aggiunge answering_machine_detection.
• AgentBranchSummary aggiunge draft_created_at facoltativo e annullabile (numero intero) e draft_is_behind_tip facoltativo (booleano, valore predefinito false).
• AgentKnowledgeBaseRagChunkResponseModel aggiunge source_url obbligatorio e annullabile (stringa).
• AgentSummaryResponseModel e SpeechEngineSummaryResponse aggiungono voice_id obbligatorio (stringa).
• AnalysisProperty aggiunge name facoltativo e annullabile (stringa) e allowed_values (AllowedValues). Anche LiteralJsonSchemaProperty aggiunge allowed_values. Entrambi deprecano allowed_values_dynamic_variable.
• DataCollectionResultCommonModel aggiunge name facoltativo e annullabile (stringa).
• WorkspaceApiKeyResponseModel aggiunge platform_limits facoltativo e annullabile (PlatformLimits).
• Lo strumento MCP Icon aggiunge theme facoltativo e annullabile (light o dark).
• SMBToolConfig aggiunge le varianti di parametri send_custom_email, create_service_quote_request e create_product_quote_request.
• Gli schemi dei parametri query dei webhook e la configurazione delle chiamate telefoniche ora usano modelli di input e output separati.
• Gli eventi WebSocket agent_response aggiungono attachments facoltativo (array). Ogni elemento richiede url e name (stringhe) e accetta mime_type facoltativo (stringa).

ElevenCreative

• ReferenceVideo.studio_clip ora usa StudioClipLocator invece di StudioClipReference. I campi e il formato wire restano invariati.

Endpoint aggiornati

ElevenAgents

• Elenca agenti - GET /v1/convai/agents
  • Aggiunto tags facoltativo e annullabile (array di stringhe). Ripeti il parametro query per trovare qualsiasi tag fornito.
• Crea agente, Recupera agente e Aggiorna agente
  • Aggiunto conversation_config.conversation.dtmf_input_settings facoltativo e annullabile (DTMFInputConfig). Supporta dtmf_input_timeout (numero, 0,5–10 secondi, valore predefinito 2), hash_terminator (booleano, valore predefinito true) e redact_input (booleano, valore predefinito false).
  • Aggiunto sip_refer_play_dialtone facoltativo (booleano, valore predefinito true) alla configurazione del trasferimento del numero di telefono. Impostalo su false per mantenere silenziosa la tratta di chiamata originale mentre viene completato un trasferimento SIP REFER.
  • Gli strumenti di sistema per le procedure di avvio e fine ora accettano ProcedureVersionRef o ProcedureDraftRef. I riferimenti alle bozze richiedono procedure_id (stringa) e impostano version_id su null.
• Recupera conversazione - GET /v1/convai/conversations/{conversation_id}
  • Aggiunto file_inputs (array di ConversationHistoryTranscriptFileInputResponseModel) alle voci della trascrizione. Ogni elemento richiede file_id, original_filename, mime_type e file_url (stringhe).
  • Aggiunto campaign facoltativo e annullabile (BatchCallingCampaignInformation) ai metadati delle chiamate batch. L’oggetto richiede campaign_id e campaign_lead_id (stringhe).
  • Aggiunto dtmf a ChatSourceMedium.
• I tipi di problemi nei ticket di triage delle conversazioni aggiungono incorrect_information, documentation_gap, platform_bug e wrong_action.

Musica

• Genera musica dettagliata (POST /v1/music/detailed) e Trasmetti musica con dettagli (POST /v1/music/detailed/stream)
  • Aggiunto with_waveform_visual facoltativo (booleano, valore predefinito false).
  • Le risposte dettagliate aggiungono waveform_visual annullabile (array di numeri interi), campionato quattro volte al secondo da -1000 a 1000.
• Carica musica - POST /v1/music/upload
  • Aggiunti with_waveform_visual facoltativo (booleano, valore predefinito false) e waveform_visual annullabile (array di numeri interi) nella risposta.

ElevenCreative

• Crea progetto Studio e Crea podcast
  • quality_preset ora accetta null ed è stato rimosso il valore predefinito standard dello schema.

Doppiaggio

• Elenca progetti di Doppiaggio - GET /v1/dubbing/project
  • page_size rimane un numero intero facoltativo con valore predefinito 20, ma i valori ora sono limitati a 1–100 invece di essere rifiutati.
  • Il filtro status ora documenta queued, preparing, ready e failed.
  • Passa next_cursor della risposta precedente in cursor; omettilo per la prima pagina.
• Elenca lingue di destinazione - GET /v1/dubbing/project/{project_id}/language
  • page_size rimane un numero intero facoltativo con valore predefinito 20, ma i valori ora sono limitati a 1–100 invece di essere rifiutati.
  • Il filtro status supporta queued, processing, completed, stale e failed.
  • Passa next_cursor della risposta precedente in cursor; omettilo per la prima pagina.

Modifiche agli schemi

Workspace

• PendingSubscriptionSwitchResponseModel.next_tier aggiunge grant.

Nuovi endpoint

ElevenAgents

• Aggiunti nove endpoint per i ticket di triage delle conversazioni:
  • Crea ticket di conversazione - POST /v1/convai/triage-tickets. La richiesta richiede conversation_id (stringa) e accetta qa_comment (stringa nullable, 1–10.000 caratteri) e fino a 200 commenti sui turni.
  • Elenca ticket - GET /v1/convai/agents/{agent_id}/triage-tickets, con paginazione tramite cursore.
  • Crea ticket manuale - POST /v1/convai/agents/{agent_id}/triage-tickets. La richiesta richiede qa_comment (stringa, 1–10.000 caratteri).
  • Elenca utenti assegnabili - GET /v1/convai/agents/{agent_id}/triage-tickets/assignable-users. La risposta elenca i membri del workspace che non sono account di servizio e indica se ciascun membro ha accesso all’agente.
  • Ottieni ticket - GET /v1/convai/triage-tickets/{agentqa_ticket_id}.
  • Aggiorna ticket - PATCH /v1/convai/triage-tickets/{agentqa_ticket_id}. La richiesta accetta status facoltativo e assignee_user_id nullable.
  • Elimina ticket - DELETE /v1/convai/triage-tickets/{agentqa_ticket_id}.
  • Aggiungi commento - POST /v1/convai/triage-tickets/{agentqa_ticket_id}/comments. La richiesta richiede comment (stringa, 1–10.000 caratteri).
  • Aggiungi commento al turno - POST /v1/convai/triage-tickets/{agentqa_ticket_id}/turn-comments. La richiesta richiede turn_index con indice a base zero (intero) e comment (stringa, 1–10.000 caratteri).

Endpoint aggiornati

ElevenAgents

• Ottieni URL firmato - GET /v1/convai/conversation/get-signed-url
  • Aggiunto debug_events_request facoltativo (booleano, valore predefinito false). Gli eventi di debug richiedono l’accesso editor all’agente.
• Ottieni token WebRTC - GET /v1/convai/conversation/token
  • Aggiunto debug_events_request facoltativo (booleano, valore predefinito false). Il percorso legacy GET /v1/convai/conversation/get_signed_url accetta lo stesso parametro.
• Elenca conversazioni - GET /v1/convai/conversations
  • Aggiunto triggered_procedure_ids facoltativo (array di stringhe nullable, massimo 50) per trovare le conversazioni in cui è stata eseguita una qualsiasi procedura specificata.
  • Aggiunto include_invalid_tool_calls facoltativo (booleano, valore predefinito false) per includere le chiamate di strumenti che non sono state eseguite.
  • Aggiunto sort_direction facoltativo (asc o desc, valore predefinito desc) per l’ora di inizio della chiamata.
• Ricerca testuale nei messaggi delle conversazioni - GET /v1/convai/conversations/messages/text-search
  • Aggiunto triggered_procedure_ids facoltativo (array di stringhe nullable, massimo 50).
  • Aggiunto include_invalid_tool_calls facoltativo (booleano, valore predefinito false).
• Ottieni argomenti delle conversazioni dell’agente - GET /v1/convai/agents/{agent_id}/topics
  • Aggiunto include_evaluation_criteria facoltativo (booleano, valore predefinito true).
  • Aggiunto frustration a sort_by.
  • Le risposte degli argomenti aggiungono success_rate nullable (numero), mentre la risposta complessiva aggiunge aggregated_run_count (intero, valore predefinito 0).
  • from_unix_secs viene arrotondato per difetto all’inizio del relativo giorno UTC. Un intervallo delimitato aggrega le esecuzioni di rilevamento giornaliere completate; omettendo entrambi i limiti viene restituita l’esecuzione più recente.
• Elenca procedure (GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures) e Ottieni procedura (GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id})
  • Aggiunto agent_version_id facoltativo nullable (stringa) per recuperare procedure da una versione specifica dell’agente.
• Crea test e Aggiorna test
  • Aggiunto environment facoltativo nullable (stringa) agli schemi di test unitari di risposta, simulazione e chiamata di strumento. Il valore seleziona URL, header e connessioni di autenticazione specifici dell’ambiente; il valore predefinito è production.
• Crea documento da URL, Crea job di crawling e Crea cartella
  • Aggiunto minimum_frequency_days facoltativo nullable (intero, 1–180) per la sincronizzazione automatica. Il valore predefinito è 7 e ha la precedenza una frequenza più rigorosa della cartella principale.

Musica

• Elenca Finetune musicali - GET /v1/music/finetunes
  • Aumentato il valore massimo di page_size da 100 a 150. Il valore predefinito rimane 50.

Modifiche allo schema

ElevenAgents

• Le richieste di aggiornamento degli agenti aggiungono procedures facoltativo nullable (object<string, ProcedureVersionRef>). Ogni valore richiede procedure_id e version_id (stringhe). Un oggetto vuoto rimuove tutte le procedure.
• La configurazione di avvio della conversazione aggiunge enable_procedure_ids_from_client (booleano, valore predefinito false). I dati di avvio aggiungono procedure_ids facoltativo nullable (array di stringhe); un array vuoto disabilita tutte le procedure per l’agente iniziale.
• ClientEvent aggiunge context_usage.
• Gli override del soft timeout aggiungono additional_soft_timeout_messages facoltativo nullable (array di stringhe).
• I valori costanti nei modelli di override dell’analisi e dello schema ora accettano null.
• I valori predefiniti della configurazione del widget per mic_muting_enabled e transcript_enabled sono cambiati da false a true. Impostali esplicitamente su false per mantenere il comportamento precedente.

Workspace

• Le risposte di Ottieni utente hanno rimosso xi_api_key da UserResponseModel.
• ResourceMetadataResponseModel.role_to_group_ids ora accetta ID di ruolo personalizzati come chiavi, anziché limitare le chiavi a admin, editor, commenter e viewer.
• Le risposte di pubblicazione diretta aggiungono restricted_to_user_email_domains facoltativo nullable (array di stringhe).
• Le risposte al cambio di abbonamento in attesa aggiungono go a next_tier.