> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

### Music

- **Music Finetunes API**: Added API support for managing [Music Finetunes](/docs/eleven-creative/products/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

- **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](/docs/api-reference/conversations/messages/text-search) 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

- **Single-use batch authentication**: [Convert speech to text](/docs/api-reference/speech-to-text/convert) 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

- **Archived pronunciation dictionaries**: [List pronunciation dictionaries](/docs/api-reference/pronunciation-dictionaries/list) adds optional `include_archived` (boolean, default `true`).

### Workspaces

- **Webhook event subscriptions**: [Update workspace webhook](/docs/api-reference/webhooks/update) 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](/docs/api-reference/analytics/workspace/usage) adds `surface` and `actor` to the `group_by` values.
- **Clear service account limits**: [Update service account API key](/docs/api-reference/service-accounts/api-keys/update) 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

#### JavaScript SDK

- [v2.59.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/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

- [v2.59.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/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

- [@elevenlabs/client@1.15.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.15.1) - Improved Scribe Realtime error delivery and microphone cleanup during setup failures, client or server closure, and late audio frames.
- [@elevenlabs/react@1.10.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.10.1), [@elevenlabs/react-native@1.2.15](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.15), [@elevenlabs/convai-widget-core@0.14.11](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.11) and [@elevenlabs/convai-widget-embed@0.14.11](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.11) - Updated dependencies to include the `@elevenlabs/client@1.15.1` Scribe Realtime fixes.

#### Android SDK

- [v0.11.1](https://github.com/elevenlabs/elevenlabs-android/releases/tag/v0.11.1) - Prevented R8 and ProGuard from obfuscating outgoing WebSocket and WebRTC event fields such as `text` and `type`.

#### CLI

- [@elevenlabs/cli@0.5.6](https://github.com/elevenlabs/cli/releases/tag/%40elevenlabs%2Fcli%400.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

<Accordion title="View API changes">

## New Endpoints

### Music

- [List Music Finetunes](/docs/api-reference/music/finetunes/list) - `GET /v1/music/finetunes`
  - Supports cursor pagination, visibility and creator filters, and sorting by creation time or name
- [Create Music Finetune](/docs/api-reference/music/finetunes/create) - `POST /v1/music/finetunes`
  - Requires `name` and `primary_genre`
  - Accepts up to 50 audio files, tags, visibility and `model_id`
- [Get Music Finetune](/docs/api-reference/music/finetunes/get) - `GET /v1/music/finetunes/{finetune_id}`
- [Update Music Finetune](/docs/api-reference/music/finetunes/update) - `PATCH /v1/music/finetunes/{finetune_id}`
  - Updates `name`, `tags`, `primary_genre` or `visibility`
- [Delete Music Finetune](/docs/api-reference/music/finetunes/delete) - `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

- [Text search conversation messages](/docs/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
  - Added optional `exclude_statuses` and `termination_reasons` array query parameters

### Speech to Text

- [Convert speech to text](/docs/api-reference/speech-to-text/convert) - `POST /v1/speech-to-text`
  - Added optional `token` (string) query parameter for a single-use batch Scribe token

### Text to Speech

- [List pronunciation dictionaries](/docs/api-reference/pronunciation-dictionaries/list) - `GET /v1/pronunciation-dictionaries`
  - Added optional `include_archived` (boolean, default `true`) query parameter

### Workspaces

- [Update workspace webhook](/docs/api-reference/webhooks/update) - `PATCH /v1/workspace/webhooks/{webhook_id}`
  - Added optional `events` (`WorkspaceWebhookEventType[]`) request field
- [Get workspace usage](/docs/api-reference/analytics/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](/docs/api-reference/service-accounts/api-keys/update) - `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`

</Accordion>