feat: Add xAI and missing voice providers to Call Control API

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 1029
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/telnyx/telnyx-5a95d4e4875d6ba2ffaf51a7cedff6709f6a344add0226694c8c9b0d1712ac37.yml
-openapi_spec_hash: 7d5daafe08dc9dba0c9f2f50f23f0e6b
-config_hash: 77bd21b3699ffa20c210990f62eb8879
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/telnyx/telnyx-dfc8acb48b0cf82f37fb76b8cd2786eb3a19778ac09f0fa1789d17e0fff8724a.yml
+openapi_spec_hash: d225e8cf339310f78e672aec3ac51a24
+config_hash: db5d4ab5ad87516c9c3d8fdb77eaba78

api.md

@@ -590,6 +590,10 @@ from telnyx.types.ai import (
     AssistantsList,
     AudioVisualizerConfig,
     EnabledFeatures,
+    ExternalLlm,
+    ExternalLlmReq,
+    FallbackConfig,
+    FallbackConfigReq,
     HangupTool,
     HangupToolParams,
     ImportMetadata,
@@ -599,6 +603,8 @@ from telnyx.types.ai import (
     MessagingSettings,
     Observability,
     ObservabilityReq,
+    PostConversationSettings,
+    PostConversationSettingsReq,
     PrivacySettings,
     RetrievalTool,
     TelephonySettings,

src/telnyx/resources/ai/assistants/assistants.py

@@ -80,15 +80,18 @@
 from ....types.ai.assistant_tool_param import AssistantToolParam
 from ....types.ai.voice_settings_param import VoiceSettingsParam
 from ....types.ai.widget_settings_param import WidgetSettingsParam
+from ....types.ai.external_llm_req_param import ExternalLlmReqParam
 from ....types.ai.insight_settings_param import InsightSettingsParam
 from ....types.ai.privacy_settings_param import PrivacySettingsParam
 from ....types.ai.assistant_chat_response import AssistantChatResponse
 from ....types.ai.observability_req_param import ObservabilityReqParam
 from ....types.ai.messaging_settings_param import MessagingSettingsParam
 from ....types.ai.telephony_settings_param import TelephonySettingsParam
 from ....types.ai.assistant_delete_response import AssistantDeleteResponse
+from ....types.ai.fallback_config_req_param import FallbackConfigReqParam
 from ....types.ai.assistant_send_sms_response import AssistantSendSMSResponse
 from ....types.ai.transcription_settings_param import TranscriptionSettingsParam
+from ....types.ai.post_conversation_settings_req_param import PostConversationSettingsReqParam
 
 __all__ = ["AssistantsResource", "AsyncAssistantsResource"]
 
@@ -155,8 +158,8 @@ def create(
         dynamic_variables_webhook_timeout_ms: int | Omit = omit,
         dynamic_variables_webhook_url: str | Omit = omit,
         enabled_features: List[EnabledFeatures] | Omit = omit,
-        external_llm: assistant_create_params.ExternalLlm | Omit = omit,
-        fallback_config: assistant_create_params.FallbackConfig | Omit = omit,
+        external_llm: ExternalLlmReqParam | Omit = omit,
+        fallback_config: FallbackConfigReqParam | Omit = omit,
         greeting: str | Omit = omit,
         insight_settings: InsightSettingsParam | Omit = omit,
         integrations: Iterable[assistant_create_params.Integration] | Omit = omit,
@@ -166,7 +169,7 @@ def create(
         messaging_settings: MessagingSettingsParam | Omit = omit,
         model: str | Omit = omit,
         observability_settings: ObservabilityReqParam | Omit = omit,
-        post_conversation_settings: assistant_create_params.PostConversationSettings | Omit = omit,
+        post_conversation_settings: PostConversationSettingsReqParam | Omit = omit,
         privacy_settings: PrivacySettingsParam | Omit = omit,
         tags: SequenceNotStr[str] | Omit = omit,
         telephony_settings: TelephonySettingsParam | Omit = omit,
@@ -365,8 +368,8 @@ def update(
         dynamic_variables_webhook_timeout_ms: int | Omit = omit,
         dynamic_variables_webhook_url: str | Omit = omit,
         enabled_features: List[EnabledFeatures] | Omit = omit,
-        external_llm: assistant_update_params.ExternalLlm | Omit = omit,
-        fallback_config: assistant_update_params.FallbackConfig | Omit = omit,
+        external_llm: ExternalLlmReqParam | Omit = omit,
+        fallback_config: FallbackConfigReqParam | Omit = omit,
         greeting: str | Omit = omit,
         insight_settings: InsightSettingsParam | Omit = omit,
         instructions: str | Omit = omit,
@@ -378,7 +381,7 @@ def update(
         model: str | Omit = omit,
         name: str | Omit = omit,
         observability_settings: ObservabilityReqParam | Omit = omit,
-        post_conversation_settings: assistant_update_params.PostConversationSettings | Omit = omit,
+        post_conversation_settings: PostConversationSettingsReqParam | Omit = omit,
         privacy_settings: PrivacySettingsParam | Omit = omit,
         promote_to_main: bool | Omit = omit,
         tags: SequenceNotStr[str] | Omit = omit,
@@ -880,8 +883,8 @@ async def create(
         dynamic_variables_webhook_timeout_ms: int | Omit = omit,
         dynamic_variables_webhook_url: str | Omit = omit,
         enabled_features: List[EnabledFeatures] | Omit = omit,
-        external_llm: assistant_create_params.ExternalLlm | Omit = omit,
-        fallback_config: assistant_create_params.FallbackConfig | Omit = omit,
+        external_llm: ExternalLlmReqParam | Omit = omit,
+        fallback_config: FallbackConfigReqParam | Omit = omit,
         greeting: str | Omit = omit,
         insight_settings: InsightSettingsParam | Omit = omit,
         integrations: Iterable[assistant_create_params.Integration] | Omit = omit,
@@ -891,7 +894,7 @@ async def create(
         messaging_settings: MessagingSettingsParam | Omit = omit,
         model: str | Omit = omit,
         observability_settings: ObservabilityReqParam | Omit = omit,
-        post_conversation_settings: assistant_create_params.PostConversationSettings | Omit = omit,
+        post_conversation_settings: PostConversationSettingsReqParam | Omit = omit,
         privacy_settings: PrivacySettingsParam | Omit = omit,
         tags: SequenceNotStr[str] | Omit = omit,
         telephony_settings: TelephonySettingsParam | Omit = omit,
@@ -1090,8 +1093,8 @@ async def update(
         dynamic_variables_webhook_timeout_ms: int | Omit = omit,
         dynamic_variables_webhook_url: str | Omit = omit,
         enabled_features: List[EnabledFeatures] | Omit = omit,
-        external_llm: assistant_update_params.ExternalLlm | Omit = omit,
-        fallback_config: assistant_update_params.FallbackConfig | Omit = omit,
+        external_llm: ExternalLlmReqParam | Omit = omit,
+        fallback_config: FallbackConfigReqParam | Omit = omit,
         greeting: str | Omit = omit,
         insight_settings: InsightSettingsParam | Omit = omit,
         instructions: str | Omit = omit,
@@ -1103,7 +1106,7 @@ async def update(
         model: str | Omit = omit,
         name: str | Omit = omit,
         observability_settings: ObservabilityReqParam | Omit = omit,
-        post_conversation_settings: assistant_update_params.PostConversationSettings | Omit = omit,
+        post_conversation_settings: PostConversationSettingsReqParam | Omit = omit,
         privacy_settings: PrivacySettingsParam | Omit = omit,
         promote_to_main: bool | Omit = omit,
         tags: SequenceNotStr[str] | Omit = omit,

src/telnyx/resources/ai/assistants/versions.py

@@ -24,12 +24,15 @@
 from ....types.ai.assistant_tool_param import AssistantToolParam
 from ....types.ai.voice_settings_param import VoiceSettingsParam
 from ....types.ai.widget_settings_param import WidgetSettingsParam
+from ....types.ai.external_llm_req_param import ExternalLlmReqParam
 from ....types.ai.insight_settings_param import InsightSettingsParam
 from ....types.ai.privacy_settings_param import PrivacySettingsParam
 from ....types.ai.observability_req_param import ObservabilityReqParam
 from ....types.ai.messaging_settings_param import MessagingSettingsParam
 from ....types.ai.telephony_settings_param import TelephonySettingsParam
+from ....types.ai.fallback_config_req_param import FallbackConfigReqParam
 from ....types.ai.transcription_settings_param import TranscriptionSettingsParam
+from ....types.ai.post_conversation_settings_req_param import PostConversationSettingsReqParam
 
 __all__ = ["VersionsResource", "AsyncVersionsResource"]
 
@@ -111,8 +114,8 @@ def update(
         dynamic_variables_webhook_timeout_ms: int | Omit = omit,
         dynamic_variables_webhook_url: str | Omit = omit,
         enabled_features: List[EnabledFeatures] | Omit = omit,
-        external_llm: version_update_params.ExternalLlm | Omit = omit,
-        fallback_config: version_update_params.FallbackConfig | Omit = omit,
+        external_llm: ExternalLlmReqParam | Omit = omit,
+        fallback_config: FallbackConfigReqParam | Omit = omit,
         greeting: str | Omit = omit,
         insight_settings: InsightSettingsParam | Omit = omit,
         instructions: str | Omit = omit,
@@ -124,7 +127,7 @@ def update(
         model: str | Omit = omit,
         name: str | Omit = omit,
         observability_settings: ObservabilityReqParam | Omit = omit,
-        post_conversation_settings: version_update_params.PostConversationSettings | Omit = omit,
+        post_conversation_settings: PostConversationSettingsReqParam | Omit = omit,
         privacy_settings: PrivacySettingsParam | Omit = omit,
         tags: SequenceNotStr[str] | Omit = omit,
         telephony_settings: TelephonySettingsParam | Omit = omit,
@@ -472,8 +475,8 @@ async def update(
         dynamic_variables_webhook_timeout_ms: int | Omit = omit,
         dynamic_variables_webhook_url: str | Omit = omit,
         enabled_features: List[EnabledFeatures] | Omit = omit,
-        external_llm: version_update_params.ExternalLlm | Omit = omit,
-        fallback_config: version_update_params.FallbackConfig | Omit = omit,
+        external_llm: ExternalLlmReqParam | Omit = omit,
+        fallback_config: FallbackConfigReqParam | Omit = omit,
         greeting: str | Omit = omit,
         insight_settings: InsightSettingsParam | Omit = omit,
         instructions: str | Omit = omit,
@@ -485,7 +488,7 @@ async def update(
         model: str | Omit = omit,
         name: str | Omit = omit,
         observability_settings: ObservabilityReqParam | Omit = omit,
-        post_conversation_settings: version_update_params.PostConversationSettings | Omit = omit,
+        post_conversation_settings: PostConversationSettingsReqParam | Omit = omit,
         privacy_settings: PrivacySettingsParam | Omit = omit,
         tags: SequenceNotStr[str] | Omit = omit,
         telephony_settings: TelephonySettingsParam | Omit = omit,

src/telnyx/resources/calls/actions.py

@@ -869,6 +869,8 @@ def gather_using_ai(
               - **Telnyx:** Use `Telnyx.<model_id>.<voice_id>`
               - **Inworld:** Use `Inworld.<ModelId>.<VoiceId>` (e.g., `Inworld.Mini.Loretta`,
                 `Inworld.Max.Oliver`). Supported models: `Mini`, `Max`.
+              - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
+                `ara`, `rex`, `sal`, `leo`.
 
           voice_settings: The settings associated with the voice selected
 
@@ -1144,6 +1146,8 @@ def gather_using_speak(
                 `voice_settings` to configure precision, sample_rate, and format.
               - **Inworld:** Use `Inworld.<ModelId>.<VoiceId>` (e.g., `Inworld.Mini.Loretta`,
                 `Inworld.Max.Oliver`). Supported models: `Mini`, `Max`.
+              - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
+                `ara`, `rex`, `sal`, `leo`.
 
               For service_level basic, you may define the gender of the speaker (male or
               female).
@@ -1865,6 +1869,8 @@ def speak(
                 `voice_settings` to configure precision, sample_rate, and format.
               - **Inworld:** Use `Inworld.<ModelId>.<VoiceId>` (e.g., `Inworld.Mini.Loretta`,
                 `Inworld.Max.Oliver`). Supported models: `Mini`, `Max`.
+              - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
+                `ara`, `rex`, `sal`, `leo`.
 
               For service_level basic, you may define the gender of the speaker (male or
               female).
@@ -2014,6 +2020,8 @@ def start_ai_assistant(
               - **Telnyx:** Use `Telnyx.<model_id>.<voice_id>`
               - **Inworld:** Use `Inworld.<ModelId>.<VoiceId>` (e.g., `Inworld.Mini.Loretta`,
                 `Inworld.Max.Oliver`). Supported models: `Mini`, `Max`.
+              - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
+                `ara`, `rex`, `sal`, `leo`.
 
           voice_settings: The settings associated with the voice selected
 
@@ -4495,6 +4503,8 @@ async def gather_using_ai(
               - **Telnyx:** Use `Telnyx.<model_id>.<voice_id>`
               - **Inworld:** Use `Inworld.<ModelId>.<VoiceId>` (e.g., `Inworld.Mini.Loretta`,
                 `Inworld.Max.Oliver`). Supported models: `Mini`, `Max`.
+              - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
+                `ara`, `rex`, `sal`, `leo`.
 
           voice_settings: The settings associated with the voice selected
 
@@ -4770,6 +4780,8 @@ async def gather_using_speak(
                 `voice_settings` to configure precision, sample_rate, and format.
               - **Inworld:** Use `Inworld.<ModelId>.<VoiceId>` (e.g., `Inworld.Mini.Loretta`,
                 `Inworld.Max.Oliver`). Supported models: `Mini`, `Max`.
+              - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
+                `ara`, `rex`, `sal`, `leo`.
 
               For service_level basic, you may define the gender of the speaker (male or
               female).
@@ -5491,6 +5503,8 @@ async def speak(
                 `voice_settings` to configure precision, sample_rate, and format.
               - **Inworld:** Use `Inworld.<ModelId>.<VoiceId>` (e.g., `Inworld.Mini.Loretta`,
                 `Inworld.Max.Oliver`). Supported models: `Mini`, `Max`.
+              - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
+                `ara`, `rex`, `sal`, `leo`.
 
               For service_level basic, you may define the gender of the speaker (male or
               female).
@@ -5640,6 +5654,8 @@ async def start_ai_assistant(
               - **Telnyx:** Use `Telnyx.<model_id>.<voice_id>`
               - **Inworld:** Use `Inworld.<ModelId>.<VoiceId>` (e.g., `Inworld.Mini.Loretta`,
                 `Inworld.Max.Oliver`). Supported models: `Mini`, `Max`.
+              - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
+                `ara`, `rex`, `sal`, `leo`.
 
           voice_settings: The settings associated with the voice selected
 

src/telnyx/resources/conferences/actions.py

@@ -1053,6 +1053,8 @@ def speak(
                 `voice_settings` to configure precision, sample_rate, and format.
               - **Inworld:** Use `Inworld.<ModelId>.<VoiceId>` (e.g., `Inworld.Mini.Loretta`,
                 `Inworld.Max.Oliver`). Supported models: `Mini`, `Max`.
+              - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
+                `ara`, `rex`, `sal`, `leo`.
 
               For service_level basic, you may define the gender of the speaker (male or
               female).
@@ -2248,6 +2250,8 @@ async def speak(
                 `voice_settings` to configure precision, sample_rate, and format.
               - **Inworld:** Use `Inworld.<ModelId>.<VoiceId>` (e.g., `Inworld.Mini.Loretta`,
                 `Inworld.Max.Oliver`). Supported models: `Mini`, `Max`.
+              - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
+                `ara`, `rex`, `sal`, `leo`.
 
               For service_level basic, you may define the gender of the speaker (male or
               female).

src/telnyx/types/ai/__init__.py

@@ -5,13 +5,15 @@
 from .bucket_ids import BucketIDs as BucketIDs
 from .hangup_tool import HangupTool as HangupTool
 from .conversation import Conversation as Conversation
+from .external_llm import ExternalLlm as ExternalLlm
 from .mission_data import MissionData as MissionData
 from .observability import Observability as Observability
 from .assistant_tool import AssistantTool as AssistantTool
 from .retrieval_tool import RetrievalTool as RetrievalTool
 from .voice_settings import VoiceSettings as VoiceSettings
 from .assistant_param import AssistantParam as AssistantParam
 from .assistants_list import AssistantsList as AssistantsList
+from .fallback_config import FallbackConfig as FallbackConfig
 from .import_metadata import ImportMetadata as ImportMetadata
 from .widget_settings import WidgetSettings as WidgetSettings
 from .bucket_ids_param import BucketIDsParam as BucketIDsParam
@@ -46,6 +48,7 @@
 from .widget_settings_param import WidgetSettingsParam as WidgetSettingsParam
 from .background_task_status import BackgroundTaskStatus as BackgroundTaskStatus
 from .cluster_compute_params import ClusterComputeParams as ClusterComputeParams
+from .external_llm_req_param import ExternalLlmReqParam as ExternalLlmReqParam
 from .insight_settings_param import InsightSettingsParam as InsightSettingsParam
 from .mcp_server_list_params import McpServerListParams as McpServerListParams
 from .privacy_settings_param import PrivacySettingsParam as PrivacySettingsParam
@@ -75,6 +78,7 @@
 from .assistant_send_sms_params import AssistantSendSMSParams as AssistantSendSMSParams
 from .audio_transcribe_response import AudioTranscribeResponse as AudioTranscribeResponse
 from .cluster_retrieve_response import ClusterRetrieveResponse as ClusterRetrieveResponse
+from .fallback_config_req_param import FallbackConfigReqParam as FallbackConfigReqParam
 from .integration_list_response import IntegrationListResponse as IntegrationListResponse
 from .mission_retrieve_response import MissionRetrieveResponse as MissionRetrieveResponse
 from .cluster_fetch_graph_params import ClusterFetchGraphParams as ClusterFetchGraphParams
@@ -84,6 +88,7 @@
 from .mcp_server_create_response import McpServerCreateResponse as McpServerCreateResponse
 from .mcp_server_update_response import McpServerUpdateResponse as McpServerUpdateResponse
 from .mission_list_events_params import MissionListEventsParams as MissionListEventsParams
+from .post_conversation_settings import PostConversationSettings as PostConversationSettings
 from .assistant_send_sms_response import AssistantSendSMSResponse as AssistantSendSMSResponse
 from .embedding_retrieve_response import EmbeddingRetrieveResponse as EmbeddingRetrieveResponse
 from .assistant_get_texml_response import AssistantGetTexmlResponse as AssistantGetTexmlResponse
@@ -102,6 +107,7 @@
 from .embedding_similarity_search_params import EmbeddingSimilaritySearchParams as EmbeddingSimilaritySearchParams
 from .transcription_settings_config_param import TranscriptionSettingsConfigParam as TranscriptionSettingsConfigParam
 from .embedding_similarity_search_response import EmbeddingSimilaritySearchResponse as EmbeddingSimilaritySearchResponse
+from .post_conversation_settings_req_param import PostConversationSettingsReqParam as PostConversationSettingsReqParam
 from .inference_embedding_webhook_tool_params import (
     InferenceEmbeddingWebhookToolParams as InferenceEmbeddingWebhookToolParams,
 )