> 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. ### ElevenAgents - **Users page is now generally available**: The [list users](/docs/api-reference/users/list) page, which groups conversations by a user identifier, is now available to all workspaces. This allows you to view all users who have interacted with your agents, their conversation history, and contact details in a unified view. - **SIP inbound headers as dynamic variables**: Custom SIP `X-` headers from inbound SIP trunking calls are now automatically exposed as dynamic variables in ElevenAgents conversations. Any custom SIP header (e.g., `X-Contact-ID`, `X-Campaign-ID`) passed by the caller is available in the agent prompt using `{{sip_contact_id}}`, `{{sip_campaign_id}}`, etc. These variables are also visible in the conversation history under the Phone Call tab. Reserved headers such as `X-Call-ID` and `X-Caller-ID` continue to map to `system__call_sid` and `system__caller_id` and are not overridden. - **Conversation filtering by tool outcome**: The [list conversations](/docs/api-reference/conversations/list) and [text search conversations](/docs/api-reference/conversations/messages/text-search) endpoints now accept `tool_names_successful` and `tool_names_errored` query parameters (array of strings) to filter conversations by which tools succeeded or returned errors during the call. - **User listing improvements**: The [list users](/docs/api-reference/users/list) endpoint now supports a `sort_by` query parameter accepting `last_contact_unix_secs` (default) or `conversation_count`, and a `branch_id` query parameter to filter users by agent branch. - **Force delete tools**: The [delete tool](/docs/api-reference/tools/delete) endpoint now accepts a `force` query parameter (boolean, default `false`). When set to `true`, the tool is deleted even if it is used by agents, and it is automatically removed from all dependent agents and branches. - **Conversation embedding retention**: The [ElevenAgents settings](/docs/api-reference/workspace/get) response now includes `conversation_embedding_retention_days`, which controls how long conversation embeddings are retained (maximum 365 days). A `null` value uses the system default of 30 days. - **Content threshold guardrail**: Added the `ContentThresholdGuardrail` schema, which provides a configurable threshold-based guardrail with an `is_enabled` flag and a `threshold` value for content moderation. ### Workspaces - **Get all workspace groups**: New [GET /v1/workspace/groups](/docs/api-reference/workspace/groups/list) endpoint returns all groups in the workspace, including each group's name, ID, members, permissions, usage limit, and character count. - **Seat type in bulk workspace invites**: The [invite multiple users](/docs/api-reference/workspace/invites/create-batch) endpoint now accepts an optional `seat_type` field to specify the seat type (e.g., `workspace_member`, `workspace_admin`) for all invited users in a bulk operation. - **Mobile SSO reliability improvements**: Fixed a regression where SSO login on mobile would get stuck on "Authenticating..." after a user logged out and attempted to sign in again. Also fixed workspace switching for mobile SSO users who sign in via SAML or OIDC providers. ### Music - **Section duration control**: The [generate music detailed](/docs/api-reference/music/compose-detailed) endpoint now supports `respect_sections_durations` (boolean), which controls whether the model adheres to the duration specified for each section in the composition plan. ### ElevenCreative Studio - **Chapter visual content indicator**: Chapter response models now include a `has_visual_content` boolean field indicating whether the chapter contains visual content. - **Text shadow and outline styles**: ElevenCreative Studio text styling now supports `text_shadow` and `text_outline` options via the new `StudioTextStyleShadowModel` and `StudioTextStyleOutlineModel` schemas, enabling richer visual text customization within ElevenCreative Studio projects. - **Media generation clip task type**: The `PendingClipTask.type` enum now includes the `media_generation` value, expanding clip task categorization to cover media generation workflows. ### SDK Releases #### Python SDK - [v2.39.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.39.0) - Added support for the `multimodal_message` WebSocket event type in ElevenAgents real-time conversations. - [v2.39.1](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.39.1) - Fern regeneration to match the latest API schema. #### JavaScript SDK - [v2.39.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.39.0) - Fern regeneration to match the latest API schema. #### iOS SDK - [v3.1.0](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.1.0) - Several improvements to the ElevenAgents Swift SDK: - Server errors are now surfaced through the `onError` callback, making error handling more consistent. - Added event-based agent state management for cleaner state observation. - Software muting is now supported alongside speech detection, enabling more granular audio control. - Improved codebase to use Swift Concurrency throughout. - Fixed a crash that occurred during startup on iOS release builds. - Updated branding to reflect the ElevenAgents rebrand. #### Packages - [@elevenlabs/client@0.15.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/client@0.15.1) - Added audio resampling for output audio when the required sample rate cannot be acquired from the system, improving compatibility across devices. - [@elevenlabs/react@0.14.2](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react@0.14.2) - Updated to depend on `@elevenlabs/client@0.15.1`. - [@elevenlabs/convai-widget-core@0.10.3](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-core@0.10.3) - Updated to depend on `@elevenlabs/client@0.15.1`. ### API ## New Endpoints - [Get all workspace groups](/docs/api-reference/workspace/groups/list) - `GET /v1/workspace/groups` - Returns all groups in the workspace with their members, permissions, and usage limits. ## Updated Endpoints ### ElevenAgents - [List conversations](/docs/api-reference/conversations/list) - Added `tool_names_successful` query parameter (array of strings, optional) to filter conversations where specified tools had successful calls - Added `tool_names_errored` query parameter (array of strings, optional) to filter conversations where specified tools returned errors - [Text search conversations](/docs/api-reference/conversations/messages/text-search) - Added `tool_names_successful` query parameter (array of strings, optional) - Added `tool_names_errored` query parameter (array of strings, optional) - [List users](/docs/api-reference/users/list) - Added `sort_by` query parameter (string, optional) accepting `last_contact_unix_secs` (default) or `conversation_count` - Added `branch_id` query parameter (string, optional) to filter users by agent branch - [Delete tool](/docs/api-reference/tools/delete) - Added `force` query parameter (boolean, optional, default `false`) to delete a tool regardless of agent dependencies, automatically removing it from all dependent agents and branches - [Get ElevenAgents settings](/docs/api-reference/workspace/get), [Update ElevenAgents settings](/docs/api-reference/workspace/update) - Added `conversation_embedding_retention_days` field (integer, optional, max 365) to configure how long conversation embeddings are retained ### Workspaces - [Invite multiple users](/docs/api-reference/workspace/invites/create-batch) - Added `seat_type` field (string, optional) to specify the seat type for all invited users ### Music - [Generate music detailed](/docs/api-reference/music/compose-detailed) - Added `respect_sections_durations` field (boolean, optional) to control whether the model adheres to per-section durations in the composition plan ### ElevenCreative Studio - [Get chapter](/docs/api-reference/studio/get-chapter), [Add chapter](/docs/api-reference/studio/add-chapter), [Update chapter](/docs/api-reference/studio/update-chapter) - Added `has_visual_content` field (boolean) to chapter response models ## Schema Changes ### New Schemas - `ContentThresholdGuardrail` - Threshold-based content guardrail with `is_enabled` (boolean) and `threshold` (number, default `0.3`) fields - `AgentPromptChangeToolConfig` - System tool configuration for dynamic agent prompt changes - `StudioTextStyleShadowModel` - Text shadow styling for ElevenCreative Studio - `StudioTextStyleOutlineModel` - Text outline styling for ElevenCreative Studio - `UsersSortBy` - Enum for user listing sort options: `last_contact_unix_secs`, `conversation_count` - `VideoAnalysis`, `VideoAnalysisResult`, `VideoKeyMoment`, `VideoSegment`, `VideoSubject`, `VideoTranscription`, `VideoTranscriptionWord` - Video analysis result schemas for clip processing ### Modified Schemas - `ConversationHistorySIPTrunkingPhoneCallModel` - Added `sip_header_dynamic_variables` field for inbound SIP custom X-headers - `PendingClipTask` - Added `media_generation` to the `type` enum > ElevenLabs provides APIs and SDKs for text to speech, voice cloning, speech to text, sound effects, voice isolator, voice changer, and conversational AI agents. Build voice-enabled applications with lifelike audio generation.