# Source: https://elevenlabs.io/docs/changelog/2025/6/8.md

# Source: https://elevenlabs.io/docs/changelog/2025/9/8.md

# Source: https://elevenlabs.io/docs/changelog/2025/12/8.md

# December 8, 2025

### Agents Platform

- **Twilio call registration**: Added [new endpoint to register Twilio calls](/docs/agents-platform/phone-numbers/twilio-integration/register-call) and receive TwiML response for agent conversations.

### Music Generation

- **Word timestamps**: Added word-level timestamps to music generation with detailed responses. Enable with the `with_timestamps` parameter.
- **Fine-tuning support**: Added `finetune_id` parameter to music generation endpoints for using custom music fine-tunes.
- **C2PA content signing**: Added `sign_with_c2pa` option to music generation requests for content authenticity and provenance.

### Voices

- **Voice settings expansion**: Added `voice_stability`, `voice_similarity`, and `voice_style` parameters to voice endpoints for more granular control.
- **Pagination improvements**: Clarified pagination behavior for [Get all voices v2](/docs/api-reference/voices/search) endpoint with better documentation of `next_page_token`, `has_more`, and `total_count` fields.

### Studio

- **Voice settings override**: Added `voice_settings` parameter to project creation for per-project voice configuration.

### Webhook Tools

- **Custom request headers**: Added `request_headers` support to Webhook tool configuration for custom authentication and metadata.

### Billing

- **Schema improvements**: Introduced `BillingPeriod` and `CharacterRefreshPeriod` enums for better type safety in subscription models.

### Knowledge Base

- **RAG query rewriting**: Added `query_rewrite_prompt_override` to RAG configuration for customizing query rewriting behavior.

### SDK Releases

#### JavaScript SDK

- [v2.27.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.27.0) - Updated API schema with latest changes including Twilio registration endpoint and music word timestamps
- [v2.26.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.26.0) - Added `previous_text` event support to Scribe and updated event types

#### Python SDK

- [v2.26.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.26.0) - Fixed websocket disconnection code for user-triggered closures and updated API schema
- [v2.25.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.25.0) - Added on-premises agent configuration support, `previous_text` event support to Scribe, and improved CI reliability

#### Packages

- [@elevenlabs/react@0.12.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react@0.12.1) - Fixed bug with committed transcripts in React components
- [@elevenlabs/agents-cli@0.6.2](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/agents-cli@0.6.2) - Updated React version
- [@elevenlabs/convai-widget-embed@0.6.0-beta.5](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-embed@0.6.0-beta.5) - Improved scroll lock stability in agent widget
- [@elevenlabs/convai-widget-embed@0.5.4](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-embed@0.5.4) - Fixed auto-scroll behavior, added `audioSessionConfiguration` to ElevenLabsProvider, and added attributes for worklet scripts

#### Android SDK

- [v0.7.0](https://github.com/elevenlabs/elevenlabs-android/releases/tag/v0.7.0) - Added `sendToolResult` function for client tool support

#### iOS SDK

- [v3.0.0](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.0.0) - Major release with breaking changes including `onDisconnect` now receives disconnect reason, added `.thinking` agent state, updated LiveKit to 2.10.0+, removed AsyncAlgorithms dependency, and added Swift 5.9+ support (previously required Swift 6.0). Includes SDK hardening, improved error handling, alignment data fixes, and agent response metadata support

#### ElevenLabs CLI

- [@elevenlabs/cli@0.3.2](https://github.com/elevenlabs/cli/releases/tag/@elevenlabs/cli@0.3.2) - Updated React version
- [@elevenlabs/cli@0.3.1](https://github.com/elevenlabs/cli/releases/tag/@elevenlabs/cli@0.3.1) - Fixed SDK dependencies to support recent features

### API

<Accordion title="View API changes">

## New Endpoints

- [Register Twilio call](/docs/api-reference/twilio/register-call) - Register a Twilio call and return TwiML for agent conversations

## Updated Endpoints

### Agents Platform

- [Create agent](/docs/api-reference/agents/create)
  - Added `template` to `AgentDefinitionSource` enum
- [Get conversation](/docs/api-reference/conversations/get)
  - Added `direction` field to `WhatsAppConversationInfo`
  - Added support for API Integration Webhook tool calls and results in conversation transcripts

### Music Generation

- [Compose music with detailed response](/docs/api-reference/music/compose-detailed)
  - Added optional `with_timestamps` parameter (boolean) to enable word-level timestamps
  - Added `words_timestamps` field to response containing array of `WordTimestamp` objects
  - Added optional `finetune_id` parameter (string) for custom music fine-tuning
  - Added optional `sign_with_c2pa` parameter (boolean) for content authenticity signing
- [Compose music](/docs/api-reference/music/compose)
  - Added optional `finetune_id` parameter (string) for custom music fine-tuning
  - Added optional `sign_with_c2pa` parameter (boolean) for content authenticity signing
- [Stream music](/docs/api-reference/music/stream)
  - Added optional `finetune_id` parameter (string) for custom music fine-tuning
- [Stem separation](/docs/api-reference/music/separate-stems)
  - Added optional `sign_with_c2pa` parameter (boolean) for content authenticity signing

### Studio

- [Add project](/docs/api-reference/studio/add-project)
  - Added optional `voice_settings` parameter (array) for per-project voice configuration JSON

### Knowledge Base

- [Add to knowledge base](/docs/api-reference/knowledge-base/create-from-url)
  - Added `query_rewrite_prompt_override` to RAG configuration
- [Update knowledge base document](/docs/api-reference/knowledge-base/update)
  - Added `query_rewrite_prompt_override` to RAG configuration

### Webhook Tools

- Webhook tool configuration endpoints
  - Added `request_headers` field (object) to webhook tool API schema configuration for custom HTTP headers

### Voices

- [Get voice](/docs/api-reference/voices/get)
  - Added optional `voice_stability` parameter
  - Added optional `voice_similarity` parameter
  - Added optional `voice_style` parameter
- [Get all voices v2](/docs/api-reference/voices/search)
  - Updated `next_page_token` query parameter description to clarify pagination with `has_more` field
  - Updated `include_total_count` query parameter description to note snapshot nature and performance implications
  - Added descriptions for response fields: `voices`, `has_more`, `total_count`, `next_page_token`
  - Changed `next_page_token` parameter to allow null values
  - Changed `include_total_count` parameter to allow null values

### Dubbing

- [Dub a video or audio file](/docs/api-reference/dubbing/create)
  - Made `background` field nullable in dubbing mix input
  - Made `foreground` field nullable in dubbing mix input
- [Get dubbing project metadata](/docs/api-reference/dubbing/get)
  - Made `background` and `foreground` fields nullable in response (breaking change - removed nested properties `src`, `content_type`, `bucket_name`, `random_path_slug`, `duration_secs`, `is_audio`, `url`)

### Text to Speech

- All TTS endpoints
  - Added optional `voice_stability` parameter where voice settings are supported
  - Added optional `voice_similarity` parameter where voice settings are supported
  - Added optional `voice_style` parameter where voice settings are supported
  - Simplified `apply_text_normalization` description (removed plan-specific note)

### Lists and Sorting

- [Get agents](/docs/api-reference/agents/list)
  - Changed `sort_by` query parameter to allow null values and removed default value
- [Get knowledge base](/docs/api-reference/knowledge-base/list)
  - Changed `sort_by` query parameter to allow null values and removed default value

### Billing

- Subscription endpoints
  - Introduced `BillingPeriod` enum (replaced inline enum values)
  - Introduced `CharacterRefreshPeriod` enum (replaced inline enum values)
  - Updated subscription and tier change models to use enum references

</Accordion>