Skip to main content
ElevenLabs Documentation Docs

Search documentation

Type to search this documentation.

On this pageOverview

July 20, 2026

Music

Section titled “Music”
  • Music Finetunes API: Added API support for managing Music Finetunes. Five endpoints let you create a Finetune from uploaded audio, list accessible Finetunes, retrieve training status, update metadata and visibility, or delete a Finetune. All music generation SDK methods now expose finetune_id.

ElevenAgents

Section titled “ElevenAgents”
  • Resolve external conversation references: Added GET /v1/convai/conversations/resolve to resolve a Slack message URL or Zendesk ticket URL to a conversation. Requests require agent_id and reference query parameters (strings).
  • Query agent knowledge bases: Added POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query for read-only RAG queries against an agent's knowledge base. The request requires query (string), accepts optional branch_id (string), and returns ranked chunks with document, chunk, text and vector-distance metadata. This endpoint is excluded from generated SDKs.
  • Knowledge base content formats: Knowledge base file, text and URL responses add optional content_format (html | markdown, default html).
  • Agent voice configuration: TTS override schemas add optional client-overridable model_id (TTSConversationalModel). The default for enable_phoneme_tags changes from false to true.
  • Faster backup LLM cascade: The default cascade_timeout_seconds changes from 8 to 4 seconds. The allowed range remains 2–15 seconds.
  • Tool parameter value sources: Object tool parameters can now use dynamic_variable, constant_value or is_omitted, matching existing scalar and array controls. Constant schema overrides now accept arbitrary arrays and objects.
  • Full-response guardrails: Custom guardrails add optional evaluate_full_response_only (boolean, default false) to evaluate the complete non-TTS response once. This option requires blocking mode.
  • Twilio call recording: Telephony call configuration adds optional twilio_call_recording_enabled (boolean, default false). Recordings are stored in the connected Twilio account and the setting is ignored by other providers.
  • Widget file-upload text: Widget text configuration adds optional labels and error messages for attaching and removing files, upload failures, unsupported types, oversized files, file-count limits and the typing indicator.
  • Knowledge base sync status: Knowledge base file responses add optional auto_sync_info and refresh_status (FileRefreshStatus). Folder responses add required document_count (integer), a recursive count of non-folder documents capped at 1000.
  • Conversation text search filters: Text search conversation messages adds optional exclude_statuses and termination_reasons array query parameters.
  • LLM options: Agent LLM configuration adds gpt-5.6-sol, gpt-5.6-terra and gpt-5.6-luna. LLMReasoningEffort adds max.
  • WhatsApp typing indicators: WhatsApp account request and response schemas add optional enable_typing_indicator (boolean).

Speech to Text

Section titled “Speech to Text”
  • Single-use batch authentication: Convert speech to text adds optional token (string) as an alternative to API key or bearer authentication. Create the single-use token with POST /v1/single-use-token/batch_scribe; it expires after 15 minutes.
  • Realtime client reliability: @elevenlabs/client now reports microphone setup and malformed server errors through RealtimeEvents.ERROR, releases microphone resources after setup failures and connection closure, and drops late microphone frames after socket teardown.

Text to Speech

Section titled “Text to Speech”

Workspaces

Section titled “Workspaces”
  • Webhook event subscriptions: Update workspace webhook requests add optional events (WorkspaceWebhookEventType[]) with voice_library_removal_notice, speech_to_text and agent_qa. Webhook responses can return the subscribed event list.
  • Usage analytics dimensions: Get workspace usage adds surface and actor to the group_by values.
  • Clear service account limits: Update service account API key accepts character_limit: "clear" to remove a monthly character limit, alongside "no_update" and integer values.
  • Alerting webhook references: Alerting webhook notifier schemas now identify a workspace webhook with required webhook_id (string) instead of embedding url, method and headers.

SDK Releases

Section titled “SDK Releases”

JavaScript SDK

Section titled “JavaScript SDK”
  • v2.59.0 - Added music.finetunes methods to list, create, get, update and delete Music Finetunes. Also added conversation reference resolution, archived pronunciation dictionary filtering and single-use Speech to Text tokens.

Python SDK

Section titled “Python SDK”
  • v2.59.0 - Added Music Finetunes and conversation reference resolution from the latest API schema. OnPremInitiationData also adds typed post_call_transcription_webhook and post_call_audio_webhook configurations with optional hmac_secret for signed post-call webhooks.

Packages

Section titled “Packages”

Android SDK

Section titled “Android SDK”
  • v0.11.1 - Prevented R8 and ProGuard from obfuscating outgoing WebSocket and WebRTC event fields such as text and type.

CLI

Section titled “CLI”
  • @elevenlabs/cli@0.5.6 - Updated default agent templates to use scribe_realtime instead of the removed elevenlabs ASR provider. Minimal templates continue to use the server default.

API

Section titled “API”
View API changes

New Endpoints

Music

  • List Music Finetunes - GET /v1/music/finetunes
    • Supports cursor pagination, visibility and creator filters, and sorting by creation time or name
  • Create Music Finetune - POST /v1/music/finetunes
    • Requires name and primary_genre
    • Accepts up to 50 audio files, tags, visibility and model_id
  • Get Music Finetune - GET /v1/music/finetunes/{finetune_id}
  • Update Music Finetune - PATCH /v1/music/finetunes/{finetune_id}
    • Updates name, tags, primary_genre or visibility
  • Delete Music Finetune - DELETE /v1/music/finetunes/{finetune_id}

ElevenAgents

  • GET /v1/convai/conversations/resolve
    • Requires agent_id (string) and reference (string) query parameters
    • Returns GetConversationResponseModel
  • POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query
    • Requires query (string) in the request body
    • Accepts optional branch_id (string) query parameter
    • Returns AgentKnowledgeBaseRagQueryResponseModel
    • Excluded from generated SDKs

Updated Endpoints

ElevenAgents

Speech to Text

  • Convert speech to text - POST /v1/speech-to-text
    • Added optional token (string) query parameter for a single-use batch Scribe token

Text to Speech

Workspaces

  • Update workspace webhook - PATCH /v1/workspace/webhooks/{webhook_id}
    • Added optional events (WorkspaceWebhookEventType[]) request field
  • Get workspace usage - POST /v1/workspace/analytics/query/usage-by-product-over-time
    • Added surface and actor to the optional group_by array
  • Update service account API key - PATCH /v1/service-accounts/{service_account_user_id}/api-keys/{api_key_id}
    • Added "clear" to the optional character_limit field

Schema Changes

ElevenAgents

  • ElevenAgents knowledge base response schemas add optional content_format (html | markdown, default html)
  • Knowledge base file responses add optional auto_sync_info and refresh_status (FileRefreshStatus)
  • Knowledge base folder responses add required document_count (integer)
  • Agent TTS override schemas add optional model_id (TTSConversationalModel)
  • Agent TTS enable_phoneme_tags now defaults to true instead of false
  • Backup LLM cascade_timeout_seconds now defaults to 4 instead of 8 seconds
  • Agent LLM configuration adds gpt-5.6-sol, gpt-5.6-terra and gpt-5.6-luna; LLMReasoningEffort adds max
  • Custom guardrails add optional evaluate_full_response_only (boolean, default false)
  • Telephony call configuration adds optional twilio_call_recording_enabled (boolean, default false)
  • Object tool parameters add dynamic_variable, constant_value and is_omitted; constant overrides accept arbitrary array and object values
  • Widget text configuration adds optional file-upload and typing-indicator labels
  • WhatsApp account schemas add optional enable_typing_indicator (boolean)
  • Simulation and testing schemas add AutoGenerationMetadata and SimulationLibrarySettings

Music

  • Added Music Finetune request, response, pagination, visibility, creator, status and failure-reason schemas
  • All Music generation request schemas expose finetune_id to generated SDKs

Workspaces

  • Workspace webhook request and response schemas add optional events (WorkspaceWebhookEventType[])
  • Alerting webhook notifier schemas use required webhook_id (string) instead of url, method and headers
Suggest an edit

Propose a replacement for this page. The site team reviews it before applying any changes.

Export
Documentation menu