# July 20, 2026

### Music

- **Music Finetunes API**: Added API support for managing [Music Finetunes](/guides/elevencreative-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](/guides/changelog-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](/guides/changelog-api-reference-text-to-dialogue-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](/guides/changelog-api-reference-pronunciation-dictionaries-list) adds optional `include_archived` (boolean, default `true`).

### Workspaces

- **Webhook event subscriptions**: [Update workspace webhook](/guides/changelog-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](/guides/changelog-api-reference-analytics-workspace-usage) adds `surface` and `actor` to the `group_by` values.
- **Clear service account limits**: [Update service account API key](/guides/changelog-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](/guides/changelog-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](/guides/changelog-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](/guides/changelog-api-reference-music-finetunes-get) - `GET /v1/music/finetunes/{finetune_id}`
- [Update Music Finetune](/guides/changelog-api-reference-music-finetunes-update) - `PATCH /v1/music/finetunes/{finetune_id}`
  - Updates `name`, `tags`, `primary_genre` or `visibility`
- [Delete Music Finetune](/guides/changelog-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](/guides/changelog-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](/guides/changelog-api-reference-text-to-dialogue-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](/guides/changelog-api-reference-pronunciation-dictionaries-list) - `GET /v1/pronunciation-dictionaries`
  - Added optional `include_archived` (boolean, default `true`) query parameter

### Workspaces

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

## Related pages

- [Administration](./administration-index.md)
- [API reference](./api-reference-index.md)
- [Changelog](./changelog-index.md)
- [ElevenAgents](./elevenagents-index.md)
- [ElevenAPI](./elevenapi-index.md)
- [ElevenCreative](./elevencreative-index.md)
- [ElevenLabs Documentation Docs](../index.md)
- [General Troubleshooting FAQ](./troubleshooting-index.md)
- [General Website FAQ](./website-index.md)
- [Help Center](./help-center-2-index.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.