release: 4.134.0 (#293)

stainless-app[bot] · web-flow · commit 49d57e9033ff · 2026-05-15T09:05:57.000Z
* feat: Update Conversation Relay start parameters

* release: 4.134.0

---------

Co-authored-by: stainless-app[bot] &lt;142633134+stainless-app[bot]@users.noreply.github.com&gt;
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "4.133.0"
+  ".": "4.134.0"
 }
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 1041
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/telnyx/telnyx-ff159b9e54ca29c5478c9bc8440982b1696c406a8bbd9f5c2c878f02813f0893.yml
-openapi_spec_hash: 1de37e76890671561f15039353ca8142
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/telnyx/telnyx-84a5516e4e8dfd1f41476bef7aa5c9d18c4ed62574d3d0cc14c12b7ea894e455.yml
+openapi_spec_hash: 8388036da41d48e5e261d909785c6e6d
 config_hash: 6b6686945572dbb277d4884e51cb07e7
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,13 @@
 # Changelog
 
+## 4.134.0 (2026-05-15)
+
+Full Changelog: [v4.133.0...v4.134.0](https://github.com/team-telnyx/telnyx-python/compare/v4.133.0...v4.134.0)
+
+### Features
+
+* Update Conversation Relay start parameters ([2121536](https://github.com/team-telnyx/telnyx-python/commit/21215362636bf962851b75e80ff38d594812aa2e))
+
 ## 4.133.0 (2026-05-14)
 
 Full Changelog: [v4.132.0...v4.133.0](https://github.com/team-telnyx/telnyx-python/compare/v4.132.0...v4.133.0)
diff --git a/pyproject.toml b/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "telnyx"
-version = "4.133.0"
+version = "4.134.0"
 description = "The official Python library for the telnyx API"
 dynamic = ["readme"]
 license = "MIT"
diff --git a/src/telnyx/_version.py b/src/telnyx/_version.py
@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "telnyx"
-__version__ = "4.133.0"  # x-release-please-version
+__version__ = "4.134.0"  # x-release-please-version
diff --git a/src/telnyx/resources/calls/actions.py b/src/telnyx/resources/calls/actions.py
@@ -2067,21 +2067,19 @@ def start_conversation_relay(
         self,
         call_control_id: str,
         *,
-        conversation_relay_url: str,
         assistant: action_start_conversation_relay_params.Assistant | Omit = omit,
         client_state: str | Omit = omit,
         command_id: str | Omit = omit,
         conversation_relay_dtmf_detection: bool | Omit = omit,
+        conversation_relay_settings: action_start_conversation_relay_params.ConversationRelaySettings | Omit = omit,
+        conversation_relay_url: str | Omit = omit,
         greeting: str | Omit = omit,
         interruption_settings: action_start_conversation_relay_params.InterruptionSettings | Omit = omit,
         language: str | Omit = omit,
         languages: Iterable[action_start_conversation_relay_params.Language] | Omit = omit,
-        participants: Iterable[action_start_conversation_relay_params.Participant] | Omit = omit,
-        send_message_history_updates: bool | Omit = omit,
         transcription: action_start_conversation_relay_params.Transcription | Omit = omit,
         transcription_language: str | Omit = omit,
         tts_language: str | Omit = omit,
-        user_response_timeout_ms: int | Omit = omit,
         voice: str | Omit = omit,
         voice_settings: action_start_conversation_relay_params.VoiceSettings | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -2106,9 +2104,6 @@ def start_conversation_relay(
           `customer_disconnect`.
 
         Args:
-          conversation_relay_url: WebSocket URL for your Conversation Relay server. Must start with `ws://` or
-              `wss://`.
-
           assistant: Custom parameters for the Conversation Relay session. Pass key-value data as
               `assistant.dynamic_variables` to make it available to the relay session.
 
@@ -2120,6 +2115,16 @@ def start_conversation_relay(
 
           conversation_relay_dtmf_detection: Enable DTMF detection for the relay session.
 
+          conversation_relay_settings: Conversation Relay connection settings. This object is used by TeXML Call
+              Scripting's `<ConversationRelay>` verb. The `interruptible` and
+              `interruptible_greeting` fields are shorthand for
+              `interruption_settings.interruptible` and
+              `interruption_settings.interruptible_greeting`; use top-level
+              `interruption_settings` for the full interruption settings shape.
+
+          conversation_relay_url: WebSocket URL for your Conversation Relay server. Must start with `ws://` or
+              `wss://`.
+
           greeting: Text played when the relay session starts.
 
           interruption_settings: Settings for handling caller interruptions during Conversation Relay speech.
@@ -2131,19 +2136,13 @@ def start_conversation_relay(
           languages: Language-specific TTS and transcription settings. Use this when the relay
               session needs per-language provider, voice, or speech model configuration.
 
-          participants: Participants to add to the conversation.
-
-          send_message_history_updates: When true, sends message history update webhooks.
-
           transcription: Speech-to-text settings for Conversation Relay.
 
           transcription_language: Language to use for speech recognition. Overrides `language` for transcription
               when provided.
 
           tts_language: Language to use for text-to-speech. Overrides `language` for TTS when provided.
 
-          user_response_timeout_ms: Time in milliseconds to wait for caller input before timing out.
-
           voice: The voice to be used by the voice assistant. Currently we support ElevenLabs,
               Telnyx and AWS voices.
 
@@ -2187,21 +2186,19 @@ def start_conversation_relay(
             path_template("/calls/{call_control_id}/actions/conversation_relay_start", call_control_id=call_control_id),
             body=maybe_transform(
                 {
-                    "conversation_relay_url": conversation_relay_url,
                     "assistant": assistant,
                     "client_state": client_state,
                     "command_id": command_id,
                     "conversation_relay_dtmf_detection": conversation_relay_dtmf_detection,
+                    "conversation_relay_settings": conversation_relay_settings,
+                    "conversation_relay_url": conversation_relay_url,
                     "greeting": greeting,
                     "interruption_settings": interruption_settings,
                     "language": language,
                     "languages": languages,
-                    "participants": participants,
-                    "send_message_history_updates": send_message_history_updates,
                     "transcription": transcription,
                     "transcription_language": transcription_language,
                     "tts_language": tts_language,
-                    "user_response_timeout_ms": user_response_timeout_ms,
                     "voice": voice,
                     "voice_settings": voice_settings,
                 },
@@ -5909,21 +5906,19 @@ async def start_conversation_relay(
         self,
         call_control_id: str,
         *,
-        conversation_relay_url: str,
         assistant: action_start_conversation_relay_params.Assistant | Omit = omit,
         client_state: str | Omit = omit,
         command_id: str | Omit = omit,
         conversation_relay_dtmf_detection: bool | Omit = omit,
+        conversation_relay_settings: action_start_conversation_relay_params.ConversationRelaySettings | Omit = omit,
+        conversation_relay_url: str | Omit = omit,
         greeting: str | Omit = omit,
         interruption_settings: action_start_conversation_relay_params.InterruptionSettings | Omit = omit,
         language: str | Omit = omit,
         languages: Iterable[action_start_conversation_relay_params.Language] | Omit = omit,
-        participants: Iterable[action_start_conversation_relay_params.Participant] | Omit = omit,
-        send_message_history_updates: bool | Omit = omit,
         transcription: action_start_conversation_relay_params.Transcription | Omit = omit,
         transcription_language: str | Omit = omit,
         tts_language: str | Omit = omit,
-        user_response_timeout_ms: int | Omit = omit,
         voice: str | Omit = omit,
         voice_settings: action_start_conversation_relay_params.VoiceSettings | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -5948,9 +5943,6 @@ async def start_conversation_relay(
           `customer_disconnect`.
 
         Args:
-          conversation_relay_url: WebSocket URL for your Conversation Relay server. Must start with `ws://` or
-              `wss://`.
-
           assistant: Custom parameters for the Conversation Relay session. Pass key-value data as
               `assistant.dynamic_variables` to make it available to the relay session.
 
@@ -5962,6 +5954,16 @@ async def start_conversation_relay(
 
           conversation_relay_dtmf_detection: Enable DTMF detection for the relay session.
 
+          conversation_relay_settings: Conversation Relay connection settings. This object is used by TeXML Call
+              Scripting's `<ConversationRelay>` verb. The `interruptible` and
+              `interruptible_greeting` fields are shorthand for
+              `interruption_settings.interruptible` and
+              `interruption_settings.interruptible_greeting`; use top-level
+              `interruption_settings` for the full interruption settings shape.
+
+          conversation_relay_url: WebSocket URL for your Conversation Relay server. Must start with `ws://` or
+              `wss://`.
+
           greeting: Text played when the relay session starts.
 
           interruption_settings: Settings for handling caller interruptions during Conversation Relay speech.
@@ -5973,19 +5975,13 @@ async def start_conversation_relay(
           languages: Language-specific TTS and transcription settings. Use this when the relay
               session needs per-language provider, voice, or speech model configuration.
 
-          participants: Participants to add to the conversation.
-
-          send_message_history_updates: When true, sends message history update webhooks.
-
           transcription: Speech-to-text settings for Conversation Relay.
 
           transcription_language: Language to use for speech recognition. Overrides `language` for transcription
               when provided.
 
           tts_language: Language to use for text-to-speech. Overrides `language` for TTS when provided.
 
-          user_response_timeout_ms: Time in milliseconds to wait for caller input before timing out.
-
           voice: The voice to be used by the voice assistant. Currently we support ElevenLabs,
               Telnyx and AWS voices.
 
@@ -6029,21 +6025,19 @@ async def start_conversation_relay(
             path_template("/calls/{call_control_id}/actions/conversation_relay_start", call_control_id=call_control_id),
             body=await async_maybe_transform(
                 {
-                    "conversation_relay_url": conversation_relay_url,
                     "assistant": assistant,
                     "client_state": client_state,
                     "command_id": command_id,
                     "conversation_relay_dtmf_detection": conversation_relay_dtmf_detection,
+                    "conversation_relay_settings": conversation_relay_settings,
+                    "conversation_relay_url": conversation_relay_url,
                     "greeting": greeting,
                     "interruption_settings": interruption_settings,
                     "language": language,
                     "languages": languages,
-                    "participants": participants,
-                    "send_message_history_updates": send_message_history_updates,
                     "transcription": transcription,
                     "transcription_language": transcription_language,
                     "tts_language": tts_language,
-                    "user_response_timeout_ms": user_response_timeout_ms,
                     "voice": voice,
                     "voice_settings": voice_settings,
                 },
diff --git a/src/telnyx/types/calls/action_start_conversation_relay_params.py b/src/telnyx/types/calls/action_start_conversation_relay_params.py
@@ -16,21 +16,16 @@
 __all__ = [
     "ActionStartConversationRelayParams",
     "Assistant",
+    "ConversationRelaySettings",
+    "ConversationRelaySettingsLanguage",
     "InterruptionSettings",
     "Language",
-    "Participant",
     "Transcription",
     "VoiceSettings",
 ]
 
 
 class ActionStartConversationRelayParams(TypedDict, total=False):
-    conversation_relay_url: Required[str]
-    """WebSocket URL for your Conversation Relay server.
-
-    Must start with `ws://` or `wss://`.
-    """
-
     assistant: Assistant
     """Custom parameters for the Conversation Relay session.
 
@@ -54,6 +49,22 @@ class ActionStartConversationRelayParams(TypedDict, total=False):
     conversation_relay_dtmf_detection: bool
     """Enable DTMF detection for the relay session."""
 
+    conversation_relay_settings: ConversationRelaySettings
+    """Conversation Relay connection settings.
+
+    This object is used by TeXML Call Scripting's `<ConversationRelay>` verb. The
+    `interruptible` and `interruptible_greeting` fields are shorthand for
+    `interruption_settings.interruptible` and
+    `interruption_settings.interruptible_greeting`; use top-level
+    `interruption_settings` for the full interruption settings shape.
+    """
+
+    conversation_relay_url: str
+    """WebSocket URL for your Conversation Relay server.
+
+    Must start with `ws://` or `wss://`.
+    """
+
     greeting: str
     """Text played when the relay session starts."""
 
@@ -74,12 +85,6 @@ class ActionStartConversationRelayParams(TypedDict, total=False):
     model configuration.
     """
 
-    participants: Iterable[Participant]
-    """Participants to add to the conversation."""
-
-    send_message_history_updates: bool
-    """When true, sends message history update webhooks."""
-
     transcription: Transcription
     """Speech-to-text settings for Conversation Relay."""
 
@@ -92,9 +97,6 @@ class ActionStartConversationRelayParams(TypedDict, total=False):
     tts_language: str
     """Language to use for text-to-speech. Overrides `language` for TTS when provided."""
 
-    user_response_timeout_ms: int
-    """Time in milliseconds to wait for caller input before timing out."""
-
     voice: str
     """The voice to be used by the voice assistant.
 
@@ -139,6 +141,58 @@ class Assistant(TypedDict, total=False, extra_items=object):  # type: ignore[cal
     """Custom key-value parameters forwarded to the Conversation Relay session."""
 
 
+class ConversationRelaySettingsLanguage(TypedDict, total=False):
+    """Language-specific speech and transcription settings for Conversation Relay."""
+
+    code: str
+    """BCP 47 language code."""
+
+    speech_model: str
+    """Speech recognition model for this language."""
+
+    transcription_provider: str
+    """Speech-to-text provider for this language."""
+
+    tts_provider: str
+    """Text-to-speech provider for this language."""
+
+    voice: str
+    """Voice identifier for this language."""
+
+
+class ConversationRelaySettings(TypedDict, total=False):
+    """Conversation Relay connection settings.
+
+    This object is used by TeXML Call Scripting's `<ConversationRelay>` verb. The `interruptible` and `interruptible_greeting` fields are shorthand for `interruption_settings.interruptible` and `interruption_settings.interruptible_greeting`; use top-level `interruption_settings` for the full interruption settings shape.
+    """
+
+    url: Required[str]
+    """WebSocket URL for your Conversation Relay server.
+
+    Must start with `ws://` or `wss://`.
+    """
+
+    dtmf_detection: bool
+    """Whether to enable DTMF detection during the relay session."""
+
+    interruptible: Literal["none", "any", "speech", "dtmf"]
+    """Controls when caller input can interrupt assistant speech.
+
+    `any` allows speech or DTMF interruptions; `none` disables interruptions;
+    `speech` allows speech only; `dtmf` allows DTMF only.
+    """
+
+    interruptible_greeting: Literal["none", "any", "speech", "dtmf"]
+    """Controls when caller input can interrupt assistant speech.
+
+    `any` allows speech or DTMF interruptions; `none` disables interruptions;
+    `speech` allows speech only; `dtmf` allows DTMF only.
+    """
+
+    languages: Iterable[ConversationRelaySettingsLanguage]
+    """Language-specific TTS and transcription settings."""
+
+
 class InterruptionSettings(TypedDict, total=False):
     """Settings for handling caller interruptions during Conversation Relay speech."""
 
@@ -190,20 +244,6 @@ class Language(TypedDict, total=False):
     """Voice identifier for this language."""
 
 
-class Participant(TypedDict, total=False):
-    id: Required[str]
-    """The call_control_id of the participant to add to the conversation."""
-
-    role: Required[Literal["user"]]
-    """The role of the participant in the conversation."""
-
-    name: str
-    """Display name for the participant."""
-
-    on_hangup: Literal["continue_conversation", "end_conversation"]
-    """Determines what happens to the conversation when this participant hangs up."""
-
-
 class Transcription(TypedDict, total=False):
     """Speech-to-text settings for Conversation Relay."""
 
diff --git a/tests/api_resources/calls/test_actions.py b/tests/api_resources/calls/test_actions.py

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,3 @@`
`1`	`1`	`{`
`2`		`- ".": "4.133.0"`
	`2`	`+ ".": "4.134.0"`
`3`	`3`	`}`