telnyx 5.169.0 → 5.171.0

data/rbi/telnyx/models/calls/soniox_voice_settings.rbi

@@ -0,0 +1,86 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    module Calls
+      class SonioxVoiceSettings < Telnyx::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(Telnyx::Calls::SonioxVoiceSettings, Telnyx::Internal::AnyHash)
+          end
+
+        # Voice settings provider type
+        sig { returns(Telnyx::Calls::SonioxVoiceSettings::Type::OrSymbol) }
+        attr_accessor :type
+
+        # Shortens the pauses between words.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :reduce_silence
+
+        sig { params(reduce_silence: T::Boolean).void }
+        attr_writer :reduce_silence
+
+        # Speaking rate. 1.0 is normal speed.
+        sig { returns(T.nilable(Float)) }
+        attr_reader :speed
+
+        sig { params(speed: Float).void }
+        attr_writer :speed
+
+        sig do
+          params(
+            type: Telnyx::Calls::SonioxVoiceSettings::Type::OrSymbol,
+            reduce_silence: T::Boolean,
+            speed: Float
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Voice settings provider type
+          type:,
+          # Shortens the pauses between words.
+          reduce_silence: nil,
+          # Speaking rate. 1.0 is normal speed.
+          speed: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              type: Telnyx::Calls::SonioxVoiceSettings::Type::OrSymbol,
+              reduce_silence: T::Boolean,
+              speed: Float
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # Voice settings provider type
+        module Type
+          extend Telnyx::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, Telnyx::Calls::SonioxVoiceSettings::Type)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          SONIOX =
+            T.let(
+              :soniox,
+              Telnyx::Calls::SonioxVoiceSettings::Type::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[Telnyx::Calls::SonioxVoiceSettings::Type::TaggedSymbol]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/models/calls/telnyx_voice_settings.rbi

@@ -13,9 +13,10 @@ module Telnyx
         sig { returns(Telnyx::Calls::TelnyxVoiceSettings::Type::OrSymbol) }
         attr_accessor :type
 
-        # The voice speed to be used for the voice. The voice speed must be between 0.1
-        # and 2.0. Default value is 1.0. Not supported for `Telnyx.Bayan.*` or
-        # `Telnyx.Sukhan.*` voices.
+        # The voice speed to be used for the voice. Telnyx `Ultra` voices accept values
+        # from 0.6 to 1.5; values outside that range are rejected by the synthesis engine.
+        # `Qwen3TTS` and `KokoroTTS` accept the field but do not apply it. Default value
+        # is 1.0. Not supported for `Telnyx.Bayan.*` or `Telnyx.Sukhan.*` voices.
         sig { returns(T.nilable(Float)) }
         attr_reader :voice_speed
 
@@ -31,9 +32,10 @@ module Telnyx
         def self.new(
           # Voice settings provider type
           type:,
-          # The voice speed to be used for the voice. The voice speed must be between 0.1
-          # and 2.0. Default value is 1.0. Not supported for `Telnyx.Bayan.*` or
-          # `Telnyx.Sukhan.*` voices.
+          # The voice speed to be used for the voice. Telnyx `Ultra` voices accept values
+          # from 0.6 to 1.5; values outside that range are rejected by the synthesis engine.
+          # `Qwen3TTS` and `KokoroTTS` accept the field but do not apply it. Default value
+          # is 1.0. Not supported for `Telnyx.Bayan.*` or `Telnyx.Sukhan.*` voices.
           voice_speed: nil
         )
         end

data/rbi/telnyx/models/conferences/action_speak_params.rbi

@@ -66,6 +66,12 @@ module Telnyx
         # - **Fish Audio:** Use `FishAudio.<ModelId>.<VoiceId>` (e.g.,
         #   `FishAudio.s2.1-pro.<reference_id>`). Supported models: `s2.1-pro`, `s2-pro`,
         #   `s1`. `VoiceId` is a Fish Voice-Library reference ID.
+        # - **Soniox:** Use `Soniox.<ModelId>.<VoiceId>` (e.g., `Soniox.tts-rt-v2.Emma`).
+        #   Supported model: `tts-rt-v2`. Browse the catalog via the
+        #   [Voices API](https://developers.telnyx.com/api-reference/text-to-speech-commands/list-available-voices).
+        #   Every voice speaks all supported languages; set `language` to the two-letter
+        #   ISO 639-1 code of the text, for example `it`. SSML is not supported. Use
+        #   `voice_settings` to configure `speed` (0.7 to 1.3) and `reduce_silence`.
         # - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
         #   `ara`, `rex`, `sal`, `leo`.
         # - **Humain:** Use `Humain.<VoiceId>` (e.g., `Humain.sara-ar`). Available voices:
@@ -156,7 +162,8 @@ module Telnyx
                 Telnyx::AzureVoiceSettings,
                 Telnyx::ResembleVoiceSettings,
                 Telnyx::InworldVoiceSettings,
-                Telnyx::XaiVoiceSettings
+                Telnyx::XaiVoiceSettings,
+                Telnyx::Calls::SonioxVoiceSettings
               )
             )
           )
@@ -174,7 +181,8 @@ module Telnyx
                 Telnyx::AzureVoiceSettings::OrHash,
                 Telnyx::ResembleVoiceSettings::OrHash,
                 Telnyx::InworldVoiceSettings::OrHash,
-                Telnyx::XaiVoiceSettings::OrHash
+                Telnyx::XaiVoiceSettings::OrHash,
+                Telnyx::Calls::SonioxVoiceSettings::OrHash
               )
           ).void
         end
@@ -201,7 +209,8 @@ module Telnyx
                 Telnyx::AzureVoiceSettings::OrHash,
                 Telnyx::ResembleVoiceSettings::OrHash,
                 Telnyx::InworldVoiceSettings::OrHash,
-                Telnyx::XaiVoiceSettings::OrHash
+                Telnyx::XaiVoiceSettings::OrHash,
+                Telnyx::Calls::SonioxVoiceSettings::OrHash
               ),
             request_options: Telnyx::RequestOptions::OrHash
           ).returns(T.attached_class)
@@ -254,6 +263,12 @@ module Telnyx
           # - **Fish Audio:** Use `FishAudio.<ModelId>.<VoiceId>` (e.g.,
           #   `FishAudio.s2.1-pro.<reference_id>`). Supported models: `s2.1-pro`, `s2-pro`,
           #   `s1`. `VoiceId` is a Fish Voice-Library reference ID.
+          # - **Soniox:** Use `Soniox.<ModelId>.<VoiceId>` (e.g., `Soniox.tts-rt-v2.Emma`).
+          #   Supported model: `tts-rt-v2`. Browse the catalog via the
+          #   [Voices API](https://developers.telnyx.com/api-reference/text-to-speech-commands/list-available-voices).
+          #   Every voice speaks all supported languages; set `language` to the two-letter
+          #   ISO 639-1 code of the text, for example `it`. SSML is not supported. Use
+          #   `voice_settings` to configure `speed` (0.7 to 1.3) and `reduce_silence`.
           # - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
           #   `ara`, `rex`, `sal`, `leo`.
           # - **Humain:** Use `Humain.<VoiceId>` (e.g., `Humain.sara-ar`). Available voices:
@@ -308,7 +323,8 @@ module Telnyx
                   Telnyx::AzureVoiceSettings,
                   Telnyx::ResembleVoiceSettings,
                   Telnyx::InworldVoiceSettings,
-                  Telnyx::XaiVoiceSettings
+                  Telnyx::XaiVoiceSettings,
+                  Telnyx::Calls::SonioxVoiceSettings
                 ),
               request_options: Telnyx::RequestOptions
             }
@@ -532,7 +548,8 @@ module Telnyx
                 Telnyx::AzureVoiceSettings,
                 Telnyx::ResembleVoiceSettings,
                 Telnyx::InworldVoiceSettings,
-                Telnyx::XaiVoiceSettings
+                Telnyx::XaiVoiceSettings,
+                Telnyx::Calls::SonioxVoiceSettings
               )
             end
 

data/rbi/telnyx/models/conversation_relay_embedded_config.rbi

@@ -143,12 +143,22 @@ module Telnyx
       # Engine-specific transcription settings for Conversation Relay. This accepts the
       # same provider-specific options used by the Call Transcription Start command,
       # such as `transcription_model`, without requiring the engine discriminator to be
-      # repeated inside this object.
-      sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
+      # repeated inside this object. With Deepgram Flux (`deepgram/flux`),
+      # `interim_results`, `eot_threshold` and `eager_eot_threshold` control the interim
+      # prompts and the `eagerEndOfTurn` and `turnResumed` frames sent to your WebSocket
+      # server.
+      sig do
+        returns(
+          T.nilable(Telnyx::Calls::ConversationRelayTranscriptionEngineConfig)
+        )
+      end
       attr_reader :transcription_engine_config
 
       sig do
-        params(transcription_engine_config: T::Hash[Symbol, T.anything]).void
+        params(
+          transcription_engine_config:
+            Telnyx::Calls::ConversationRelayTranscriptionEngineConfig::OrHash
+        ).void
       end
       attr_writer :transcription_engine_config
 
@@ -170,10 +180,10 @@ module Telnyx
       #   the `VoiceId` (e.g., `AWS.Polly.Joanna-Neural`). Check the
       #   [available voices](https://docs.aws.amazon.com/polly/latest/dg/available-voices.html)
       #   for compatibility.
-      # - **Azure:** Use `Azure.<VoiceId>. (e.g. Azure.en-CA-ClaraNeural,
-      #   Azure.en-CA-LiamNeural, Azure.en-US-BrianMultilingualNeural,
-      #   Azure.en-US-Ava:DragonHDLatestNeural. For a complete list of voices, go to
-      #   [Azure Voice Gallery](https://speech.microsoft.com/portal/voicegallery).)
+      # - **Azure:** Use `Azure.<VoiceId>` (e.g., `Azure.en-CA-ClaraNeural`,
+      #   `Azure.en-CA-LiamNeural`, `Azure.en-US-BrianMultilingualNeural`,
+      #   `Azure.en-US-Ava:DragonHDLatestNeural`). For a complete list of voices, go to
+      #   [Azure Voice Gallery](https://speech.microsoft.com/portal/voicegallery).
       # - **ElevenLabs:** Use `ElevenLabs.<ModelId>.<VoiceId>` (e.g.,
       #   `ElevenLabs.BaseModel.John`). The `ModelId` part is optional. To use
       #   ElevenLabs, you must provide your ElevenLabs API key as an integration secret
@@ -188,6 +198,12 @@ module Telnyx
       # - **Fish Audio:** Use `FishAudio.<ModelId>.<VoiceId>` (e.g.,
       #   `FishAudio.s2.1-pro.<reference_id>`). Supported models: `s2.1-pro`, `s2-pro`,
       #   `s1`. `VoiceId` is a Fish Voice-Library reference ID.
+      # - **Soniox:** Use `Soniox.<ModelId>.<VoiceId>` (e.g., `Soniox.tts-rt-v2.Emma`).
+      #   Supported model: `tts-rt-v2`. Browse the catalog via the
+      #   [Voices API](https://developers.telnyx.com/api-reference/text-to-speech-commands/list-available-voices).
+      #   Every voice speaks all supported languages; set `language` to the two-letter
+      #   ISO 639-1 code of the text, for example `it`. SSML is not supported. Use
+      #   `voice_settings` to configure `speed` (0.7 to 1.3) and `reduce_silence`.
       # - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
       #   `ara`, `rex`, `sal`, `leo`.
       # - **Humain:** Use `Humain.<VoiceId>` (e.g., `Humain.sara-ar`). Available voices:
@@ -212,7 +228,8 @@ module Telnyx
               Telnyx::AzureVoiceSettings,
               Telnyx::ResembleVoiceSettings,
               Telnyx::InworldVoiceSettings,
-              Telnyx::XaiVoiceSettings
+              Telnyx::XaiVoiceSettings,
+              Telnyx::Calls::SonioxVoiceSettings
             )
           )
         )
@@ -230,7 +247,8 @@ module Telnyx
               Telnyx::AzureVoiceSettings::OrHash,
               Telnyx::ResembleVoiceSettings::OrHash,
               Telnyx::InworldVoiceSettings::OrHash,
-              Telnyx::XaiVoiceSettings::OrHash
+              Telnyx::XaiVoiceSettings::OrHash,
+              Telnyx::Calls::SonioxVoiceSettings::OrHash
             )
         ).void
       end
@@ -260,7 +278,8 @@ module Telnyx
           structured_provider: T::Hash[Symbol, T.anything],
           transcription_engine:
             Telnyx::ConversationRelayEmbeddedConfig::TranscriptionEngine::OrSymbol,
-          transcription_engine_config: T::Hash[Symbol, T.anything],
+          transcription_engine_config:
+            Telnyx::Calls::ConversationRelayTranscriptionEngineConfig::OrHash,
           tts_provider: String,
           voice: String,
           voice_settings:
@@ -272,7 +291,8 @@ module Telnyx
               Telnyx::AzureVoiceSettings::OrHash,
               Telnyx::ResembleVoiceSettings::OrHash,
               Telnyx::InworldVoiceSettings::OrHash,
-              Telnyx::XaiVoiceSettings::OrHash
+              Telnyx::XaiVoiceSettings::OrHash,
+              Telnyx::Calls::SonioxVoiceSettings::OrHash
             )
         ).returns(T.attached_class)
       end
@@ -315,7 +335,10 @@ module Telnyx
         # Engine-specific transcription settings for Conversation Relay. This accepts the
         # same provider-specific options used by the Call Transcription Start command,
         # such as `transcription_model`, without requiring the engine discriminator to be
-        # repeated inside this object.
+        # repeated inside this object. With Deepgram Flux (`deepgram/flux`),
+        # `interim_results`, `eot_threshold` and `eager_eot_threshold` control the interim
+        # prompts and the `eagerEndOfTurn` and `turnResumed` frames sent to your WebSocket
+        # server.
         transcription_engine_config: nil,
         # Text-to-speech provider. If omitted, Telnyx derives it from `voice` or
         # `provider`.
@@ -330,10 +353,10 @@ module Telnyx
         #   the `VoiceId` (e.g., `AWS.Polly.Joanna-Neural`). Check the
         #   [available voices](https://docs.aws.amazon.com/polly/latest/dg/available-voices.html)
         #   for compatibility.
-        # - **Azure:** Use `Azure.<VoiceId>. (e.g. Azure.en-CA-ClaraNeural,
-        #   Azure.en-CA-LiamNeural, Azure.en-US-BrianMultilingualNeural,
-        #   Azure.en-US-Ava:DragonHDLatestNeural. For a complete list of voices, go to
-        #   [Azure Voice Gallery](https://speech.microsoft.com/portal/voicegallery).)
+        # - **Azure:** Use `Azure.<VoiceId>` (e.g., `Azure.en-CA-ClaraNeural`,
+        #   `Azure.en-CA-LiamNeural`, `Azure.en-US-BrianMultilingualNeural`,
+        #   `Azure.en-US-Ava:DragonHDLatestNeural`). For a complete list of voices, go to
+        #   [Azure Voice Gallery](https://speech.microsoft.com/portal/voicegallery).
         # - **ElevenLabs:** Use `ElevenLabs.<ModelId>.<VoiceId>` (e.g.,
         #   `ElevenLabs.BaseModel.John`). The `ModelId` part is optional. To use
         #   ElevenLabs, you must provide your ElevenLabs API key as an integration secret
@@ -348,6 +371,12 @@ module Telnyx
         # - **Fish Audio:** Use `FishAudio.<ModelId>.<VoiceId>` (e.g.,
         #   `FishAudio.s2.1-pro.<reference_id>`). Supported models: `s2.1-pro`, `s2-pro`,
         #   `s1`. `VoiceId` is a Fish Voice-Library reference ID.
+        # - **Soniox:** Use `Soniox.<ModelId>.<VoiceId>` (e.g., `Soniox.tts-rt-v2.Emma`).
+        #   Supported model: `tts-rt-v2`. Browse the catalog via the
+        #   [Voices API](https://developers.telnyx.com/api-reference/text-to-speech-commands/list-available-voices).
+        #   Every voice speaks all supported languages; set `language` to the two-letter
+        #   ISO 639-1 code of the text, for example `it`. SSML is not supported. Use
+        #   `voice_settings` to configure `speed` (0.7 to 1.3) and `reduce_silence`.
         # - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
         #   `ara`, `rex`, `sal`, `leo`.
         # - **Humain:** Use `Humain.<VoiceId>` (e.g., `Humain.sara-ar`). Available voices:
@@ -379,7 +408,8 @@ module Telnyx
             structured_provider: T::Hash[Symbol, T.anything],
             transcription_engine:
               Telnyx::ConversationRelayEmbeddedConfig::TranscriptionEngine::OrSymbol,
-            transcription_engine_config: T::Hash[Symbol, T.anything],
+            transcription_engine_config:
+              Telnyx::Calls::ConversationRelayTranscriptionEngineConfig,
             tts_provider: String,
             voice: String,
             voice_settings:
@@ -391,7 +421,8 @@ module Telnyx
                 Telnyx::AzureVoiceSettings,
                 Telnyx::ResembleVoiceSettings,
                 Telnyx::InworldVoiceSettings,
-                Telnyx::XaiVoiceSettings
+                Telnyx::XaiVoiceSettings,
+                Telnyx::Calls::SonioxVoiceSettings
               )
           }
         )
@@ -491,7 +522,8 @@ module Telnyx
               Telnyx::AzureVoiceSettings,
               Telnyx::ResembleVoiceSettings,
               Telnyx::InworldVoiceSettings,
-              Telnyx::XaiVoiceSettings
+              Telnyx::XaiVoiceSettings,
+              Telnyx::Calls::SonioxVoiceSettings
             )
           end
 

data/rbi/telnyx/models/conversation_relay_language.rbi

@@ -45,12 +45,22 @@ module Telnyx
       # Engine-specific transcription settings for Conversation Relay. This accepts the
       # same provider-specific options used by the Call Transcription Start command,
       # such as `transcription_model`, without requiring the engine discriminator to be
-      # repeated inside this object.
-      sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
+      # repeated inside this object. With Deepgram Flux (`deepgram/flux`),
+      # `interim_results`, `eot_threshold` and `eager_eot_threshold` control the interim
+      # prompts and the `eagerEndOfTurn` and `turnResumed` frames sent to your WebSocket
+      # server.
+      sig do
+        returns(
+          T.nilable(Telnyx::Calls::ConversationRelayTranscriptionEngineConfig)
+        )
+      end
       attr_reader :transcription_engine_config
 
       sig do
-        params(transcription_engine_config: T::Hash[Symbol, T.anything]).void
+        params(
+          transcription_engine_config:
+            Telnyx::Calls::ConversationRelayTranscriptionEngineConfig::OrHash
+        ).void
       end
       attr_writer :transcription_engine_config
 
@@ -89,7 +99,8 @@ module Telnyx
               Telnyx::AzureVoiceSettings,
               Telnyx::ResembleVoiceSettings,
               Telnyx::InworldVoiceSettings,
-              Telnyx::XaiVoiceSettings
+              Telnyx::XaiVoiceSettings,
+              Telnyx::Calls::SonioxVoiceSettings
             )
           )
         )
@@ -107,7 +118,8 @@ module Telnyx
               Telnyx::AzureVoiceSettings::OrHash,
               Telnyx::ResembleVoiceSettings::OrHash,
               Telnyx::InworldVoiceSettings::OrHash,
-              Telnyx::XaiVoiceSettings::OrHash
+              Telnyx::XaiVoiceSettings::OrHash,
+              Telnyx::Calls::SonioxVoiceSettings::OrHash
             )
         ).void
       end
@@ -120,7 +132,8 @@ module Telnyx
           speech_model: String,
           transcription_engine:
             Telnyx::ConversationRelayLanguage::TranscriptionEngine::OrSymbol,
-          transcription_engine_config: T::Hash[Symbol, T.anything],
+          transcription_engine_config:
+            Telnyx::Calls::ConversationRelayTranscriptionEngineConfig::OrHash,
           transcription_provider: String,
           tts_provider: String,
           voice: String,
@@ -133,7 +146,8 @@ module Telnyx
               Telnyx::AzureVoiceSettings::OrHash,
               Telnyx::ResembleVoiceSettings::OrHash,
               Telnyx::InworldVoiceSettings::OrHash,
-              Telnyx::XaiVoiceSettings::OrHash
+              Telnyx::XaiVoiceSettings::OrHash,
+              Telnyx::Calls::SonioxVoiceSettings::OrHash
             )
         ).returns(T.attached_class)
       end
@@ -152,7 +166,10 @@ module Telnyx
         # Engine-specific transcription settings for Conversation Relay. This accepts the
         # same provider-specific options used by the Call Transcription Start command,
         # such as `transcription_model`, without requiring the engine discriminator to be
-        # repeated inside this object.
+        # repeated inside this object. With Deepgram Flux (`deepgram/flux`),
+        # `interim_results`, `eot_threshold` and `eager_eot_threshold` control the interim
+        # prompts and the `eagerEndOfTurn` and `turnResumed` frames sent to your WebSocket
+        # server.
         transcription_engine_config: nil,
         # Conversation Relay transcription provider name. Prefer `transcription_engine`
         # when configuring speech-to-text.
@@ -174,7 +191,8 @@ module Telnyx
             speech_model: String,
             transcription_engine:
               Telnyx::ConversationRelayLanguage::TranscriptionEngine::OrSymbol,
-            transcription_engine_config: T::Hash[Symbol, T.anything],
+            transcription_engine_config:
+              Telnyx::Calls::ConversationRelayTranscriptionEngineConfig,
             transcription_provider: String,
             tts_provider: String,
             voice: String,
@@ -187,7 +205,8 @@ module Telnyx
                 Telnyx::AzureVoiceSettings,
                 Telnyx::ResembleVoiceSettings,
                 Telnyx::InworldVoiceSettings,
-                Telnyx::XaiVoiceSettings
+                Telnyx::XaiVoiceSettings,
+                Telnyx::Calls::SonioxVoiceSettings
               )
           }
         )
@@ -287,7 +306,8 @@ module Telnyx
               Telnyx::AzureVoiceSettings,
               Telnyx::ResembleVoiceSettings,
               Telnyx::InworldVoiceSettings,
-              Telnyx::XaiVoiceSettings
+              Telnyx::XaiVoiceSettings,
+              Telnyx::Calls::SonioxVoiceSettings
             )
           end
 

data/rbi/telnyx/models/dir/phone_number_list_params.rbi

@@ -29,19 +29,11 @@ module Telnyx
         sig { params(page_size: Integer).void }
         attr_writer :page_size
 
-        # Filter by phone-number status.
-        sig { returns(T.nilable(Telnyx::Dir::DirPhoneNumberStatus::OrSymbol)) }
-        attr_reader :status
-
-        sig { params(status: Telnyx::Dir::DirPhoneNumberStatus::OrSymbol).void }
-        attr_writer :status
-
         sig do
           params(
             dir_id: String,
             page_number: Integer,
             page_size: Integer,
-            status: Telnyx::Dir::DirPhoneNumberStatus::OrSymbol,
             request_options: Telnyx::RequestOptions::OrHash
           ).returns(T.attached_class)
         end
@@ -51,8 +43,6 @@ module Telnyx
           page_number: nil,
           # Items per page. Maximum 250; values above are clamped to 250.
           page_size: nil,
-          # Filter by phone-number status.
-          status: nil,
           request_options: {}
         )
         end
@@ -63,7 +53,6 @@ module Telnyx
               dir_id: String,
               page_number: Integer,
               page_size: Integer,
-              status: Telnyx::Dir::DirPhoneNumberStatus::OrSymbol,
               request_options: Telnyx::RequestOptions
             }
           )

data/rbi/telnyx/models/dir/phone_number_remove_params.rbi

@@ -18,6 +18,8 @@ module Telnyx
         sig { returns(String) }
         attr_accessor :dir_id
 
+        # The phone numbers to remove from this brand, in E.164 format, up to 100 per
+        # request. They must currently be attached to this brand.
         sig { returns(T::Array[String]) }
         attr_accessor :phone_numbers
 
@@ -28,7 +30,13 @@ module Telnyx
             request_options: Telnyx::RequestOptions::OrHash
           ).returns(T.attached_class)
         end
-        def self.new(dir_id:, phone_numbers:, request_options: {})
+        def self.new(
+          dir_id:,
+          # The phone numbers to remove from this brand, in E.164 format, up to 100 per
+          # request. They must currently be attached to this brand.
+          phone_numbers:,
+          request_options: {}
+        )
         end
 
         sig do

data/rbi/telnyx/models/dir/reference_update_params.rbi

@@ -21,29 +21,31 @@ module Telnyx
         sig { returns(Integer) }
         attr_accessor :slot
 
-        # Reference contact email address.
+        # The reference's email address. We email them scheduling and dial-in instructions
+        # before we call, so use an address they check.
         sig { returns(T.nilable(String)) }
         attr_reader :email
 
         sig { params(email: String).void }
         attr_writer :email
 
-        # Full name of the reference contact.
+        # The full name of the person we should contact as your reference.
         sig { returns(T.nilable(String)) }
         attr_reader :full_name
 
         sig { params(full_name: String).void }
         attr_writer :full_name
 
-        # Job title of the reference contact.
+        # The reference contact's job title, for example CFO or Owner.
         sig { returns(T.nilable(String)) }
         attr_accessor :job_title
 
-        # Organization the reference contact belongs to.
+        # The name of the organization the reference contact works for.
         sig { returns(T.nilable(String)) }
         attr_accessor :organization
 
-        # Reference phone number in E.164 format.
+        # The reference's phone number in E.164 format, for example +14155550123. We call
+        # this number during their local business hours.
         sig { returns(T.nilable(String)) }
         attr_reader :phone_e164
 
@@ -54,7 +56,8 @@ module Telnyx
         sig { returns(T.nilable(String)) }
         attr_accessor :relationship_to_registrant
 
-        # IANA timezone id for the reference.
+        # The reference's IANA time zone, for example America/New_York. We only call
+        # during their local 8am to 9pm hours, which is why we need it.
         sig { returns(T.nilable(String)) }
         attr_reader :timezone
 
@@ -80,19 +83,22 @@ module Telnyx
           dir_id:,
           ref_type:,
           slot:,
-          # Reference contact email address.
+          # The reference's email address. We email them scheduling and dial-in instructions
+          # before we call, so use an address they check.
           email: nil,
-          # Full name of the reference contact.
+          # The full name of the person we should contact as your reference.
           full_name: nil,
-          # Job title of the reference contact.
+          # The reference contact's job title, for example CFO or Owner.
           job_title: nil,
-          # Organization the reference contact belongs to.
+          # The name of the organization the reference contact works for.
           organization: nil,
-          # Reference phone number in E.164 format.
+          # The reference's phone number in E.164 format, for example +14155550123. We call
+          # this number during their local business hours.
           phone_e164: nil,
           # How the reference contact is related to the registering business.
           relationship_to_registrant: nil,
-          # IANA timezone id for the reference.
+          # The reference's IANA time zone, for example America/New_York. We only call
+          # during their local 8am to 9pm hours, which is why we need it.
           timezone: nil,
           request_options: {}
         )