telnyx 5.69.0 → 5.71.0

data/rbi/telnyx/models/voice_clone_create_params.rbi

@@ -11,56 +11,30 @@ module Telnyx
           T.any(Telnyx::VoiceCloneCreateParams, Telnyx::Internal::AnyHash)
         end
 
-      # Gender of the voice clone.
-      sig { returns(Telnyx::VoiceCloneCreateParams::Gender::OrSymbol) }
-      attr_accessor :gender
-
-      # ISO 639-1 language code for the clone (e.g. `en`, `fr`, `de`).
-      sig { returns(String) }
-      attr_accessor :language
-
-      # Name for the voice clone.
-      sig { returns(String) }
-      attr_accessor :name
-
-      # UUID of the source voice design to clone.
-      sig { returns(String) }
-      attr_accessor :voice_design_id
-
-      # Voice synthesis provider. Case-insensitive. Defaults to `telnyx`.
+      # Request body for creating a voice clone from an existing voice design.
       sig do
-        returns(T.nilable(Telnyx::VoiceCloneCreateParams::Provider::OrSymbol))
-      end
-      attr_reader :provider
-
-      sig do
-        params(
-          provider: Telnyx::VoiceCloneCreateParams::Provider::OrSymbol
-        ).void
+        returns(
+          T.any(
+            Telnyx::VoiceCloneCreateParams::Params::TelnyxDesignClone,
+            Telnyx::VoiceCloneCreateParams::Params::MinimaxDesignClone
+          )
+        )
       end
-      attr_writer :provider
+      attr_accessor :params
 
       sig do
         params(
-          gender: Telnyx::VoiceCloneCreateParams::Gender::OrSymbol,
-          language: String,
-          name: String,
-          voice_design_id: String,
-          provider: Telnyx::VoiceCloneCreateParams::Provider::OrSymbol,
+          params:
+            T.any(
+              Telnyx::VoiceCloneCreateParams::Params::TelnyxDesignClone::OrHash,
+              Telnyx::VoiceCloneCreateParams::Params::MinimaxDesignClone::OrHash
+            ),
           request_options: Telnyx::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
       def self.new(
-        # Gender of the voice clone.
-        gender:,
-        # ISO 639-1 language code for the clone (e.g. `en`, `fr`, `de`).
-        language:,
-        # Name for the voice clone.
-        name:,
-        # UUID of the source voice design to clone.
-        voice_design_id:,
-        # Voice synthesis provider. Case-insensitive. Defaults to `telnyx`.
-        provider: nil,
+        # Request body for creating a voice clone from an existing voice design.
+        params:,
         request_options: {}
       )
       end
@@ -68,11 +42,11 @@ module Telnyx
       sig do
         override.returns(
           {
-            gender: Telnyx::VoiceCloneCreateParams::Gender::OrSymbol,
-            language: String,
-            name: String,
-            voice_design_id: String,
-            provider: Telnyx::VoiceCloneCreateParams::Provider::OrSymbol,
+            params:
+              T.any(
+                Telnyx::VoiceCloneCreateParams::Params::TelnyxDesignClone,
+                Telnyx::VoiceCloneCreateParams::Params::MinimaxDesignClone
+              ),
             request_options: Telnyx::RequestOptions
           }
         )
@@ -80,54 +54,346 @@ module Telnyx
       def to_hash
       end
 
-      # Gender of the voice clone.
-      module Gender
-        extend Telnyx::Internal::Type::Enum
+      # Request body for creating a voice clone from an existing voice design.
+      module Params
+        extend Telnyx::Internal::Type::Union
+
+        Variants =
+          T.type_alias do
+            T.any(
+              Telnyx::VoiceCloneCreateParams::Params::TelnyxDesignClone,
+              Telnyx::VoiceCloneCreateParams::Params::MinimaxDesignClone
+            )
+          end
 
-        TaggedSymbol =
-          T.type_alias { T.all(Symbol, Telnyx::VoiceCloneCreateParams::Gender) }
-        OrSymbol = T.type_alias { T.any(Symbol, String) }
+        class TelnyxDesignClone < Telnyx::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Telnyx::VoiceCloneCreateParams::Params::TelnyxDesignClone,
+                Telnyx::Internal::AnyHash
+              )
+            end
 
-        MALE =
-          T.let(:male, Telnyx::VoiceCloneCreateParams::Gender::TaggedSymbol)
-        FEMALE =
-          T.let(:female, Telnyx::VoiceCloneCreateParams::Gender::TaggedSymbol)
-        NEUTRAL =
-          T.let(:neutral, Telnyx::VoiceCloneCreateParams::Gender::TaggedSymbol)
+          # Gender of the voice clone.
+          sig do
+            returns(
+              Telnyx::VoiceCloneCreateParams::Params::TelnyxDesignClone::Gender::OrSymbol
+            )
+          end
+          attr_accessor :gender
 
-        sig do
-          override.returns(
-            T::Array[Telnyx::VoiceCloneCreateParams::Gender::TaggedSymbol]
+          # ISO 639-1 language code for the clone. Supports the combined Telnyx language
+          # set.
+          sig { returns(String) }
+          attr_accessor :language
+
+          # Name for the voice clone.
+          sig { returns(String) }
+          attr_accessor :name
+
+          # UUID of the source voice design to clone.
+          sig { returns(String) }
+          attr_accessor :voice_design_id
+
+          # Voice synthesis provider. Defaults to `telnyx`.
+          sig do
+            returns(
+              T.nilable(
+                Telnyx::VoiceCloneCreateParams::Params::TelnyxDesignClone::Provider::OrSymbol
+              )
+            )
+          end
+          attr_reader :provider
+
+          sig do
+            params(
+              provider:
+                Telnyx::VoiceCloneCreateParams::Params::TelnyxDesignClone::Provider::OrSymbol
+            ).void
+          end
+          attr_writer :provider
+
+          # Create a voice clone from a voice design using the Telnyx provider.
+          sig do
+            params(
+              gender:
+                Telnyx::VoiceCloneCreateParams::Params::TelnyxDesignClone::Gender::OrSymbol,
+              language: String,
+              name: String,
+              voice_design_id: String,
+              provider:
+                Telnyx::VoiceCloneCreateParams::Params::TelnyxDesignClone::Provider::OrSymbol
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Gender of the voice clone.
+            gender:,
+            # ISO 639-1 language code for the clone. Supports the combined Telnyx language
+            # set.
+            language:,
+            # Name for the voice clone.
+            name:,
+            # UUID of the source voice design to clone.
+            voice_design_id:,
+            # Voice synthesis provider. Defaults to `telnyx`.
+            provider: nil
           )
+          end
+
+          sig do
+            override.returns(
+              {
+                gender:
+                  Telnyx::VoiceCloneCreateParams::Params::TelnyxDesignClone::Gender::OrSymbol,
+                language: String,
+                name: String,
+                voice_design_id: String,
+                provider:
+                  Telnyx::VoiceCloneCreateParams::Params::TelnyxDesignClone::Provider::OrSymbol
+              }
+            )
+          end
+          def to_hash
+          end
+
+          # Gender of the voice clone.
+          module Gender
+            extend Telnyx::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Telnyx::VoiceCloneCreateParams::Params::TelnyxDesignClone::Gender
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            MALE =
+              T.let(
+                :male,
+                Telnyx::VoiceCloneCreateParams::Params::TelnyxDesignClone::Gender::TaggedSymbol
+              )
+            FEMALE =
+              T.let(
+                :female,
+                Telnyx::VoiceCloneCreateParams::Params::TelnyxDesignClone::Gender::TaggedSymbol
+              )
+            NEUTRAL =
+              T.let(
+                :neutral,
+                Telnyx::VoiceCloneCreateParams::Params::TelnyxDesignClone::Gender::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Telnyx::VoiceCloneCreateParams::Params::TelnyxDesignClone::Gender::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+
+          # Voice synthesis provider. Defaults to `telnyx`.
+          module Provider
+            extend Telnyx::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Telnyx::VoiceCloneCreateParams::Params::TelnyxDesignClone::Provider
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            TELNYX =
+              T.let(
+                :telnyx,
+                Telnyx::VoiceCloneCreateParams::Params::TelnyxDesignClone::Provider::TaggedSymbol
+              )
+            MINIMAX =
+              T.let(
+                :minimax,
+                Telnyx::VoiceCloneCreateParams::Params::TelnyxDesignClone::Provider::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Telnyx::VoiceCloneCreateParams::Params::TelnyxDesignClone::Provider::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
         end
-        def self.values
-        end
-      end
 
-      # Voice synthesis provider. Case-insensitive. Defaults to `telnyx`.
-      module Provider
-        extend Telnyx::Internal::Type::Enum
+        class MinimaxDesignClone < Telnyx::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Telnyx::VoiceCloneCreateParams::Params::MinimaxDesignClone,
+                Telnyx::Internal::AnyHash
+              )
+            end
 
-        TaggedSymbol =
-          T.type_alias do
-            T.all(Symbol, Telnyx::VoiceCloneCreateParams::Provider)
+          # Gender of the voice clone.
+          sig do
+            returns(
+              Telnyx::VoiceCloneCreateParams::Params::MinimaxDesignClone::Gender::OrSymbol
+            )
+          end
+          attr_accessor :gender
+
+          # ISO 639-1 language code for the clone. Supports the Minimax language set.
+          sig { returns(String) }
+          attr_accessor :language
+
+          # Name for the voice clone.
+          sig { returns(String) }
+          attr_accessor :name
+
+          # Voice synthesis provider. Must be `minimax`.
+          sig do
+            returns(
+              Telnyx::VoiceCloneCreateParams::Params::MinimaxDesignClone::Provider::OrSymbol
+            )
           end
-        OrSymbol = T.type_alias { T.any(Symbol, String) }
+          attr_accessor :provider
 
-        TELNYX =
-          T.let(:telnyx, Telnyx::VoiceCloneCreateParams::Provider::TaggedSymbol)
-        MINIMAX =
-          T.let(
-            :minimax,
-            Telnyx::VoiceCloneCreateParams::Provider::TaggedSymbol
+          # UUID of the source voice design to clone.
+          sig { returns(String) }
+          attr_accessor :voice_design_id
+
+          # Create a voice clone from a voice design using the Minimax provider.
+          sig do
+            params(
+              gender:
+                Telnyx::VoiceCloneCreateParams::Params::MinimaxDesignClone::Gender::OrSymbol,
+              language: String,
+              name: String,
+              provider:
+                Telnyx::VoiceCloneCreateParams::Params::MinimaxDesignClone::Provider::OrSymbol,
+              voice_design_id: String
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Gender of the voice clone.
+            gender:,
+            # ISO 639-1 language code for the clone. Supports the Minimax language set.
+            language:,
+            # Name for the voice clone.
+            name:,
+            # Voice synthesis provider. Must be `minimax`.
+            provider:,
+            # UUID of the source voice design to clone.
+            voice_design_id:
           )
+          end
+
+          sig do
+            override.returns(
+              {
+                gender:
+                  Telnyx::VoiceCloneCreateParams::Params::MinimaxDesignClone::Gender::OrSymbol,
+                language: String,
+                name: String,
+                provider:
+                  Telnyx::VoiceCloneCreateParams::Params::MinimaxDesignClone::Provider::OrSymbol,
+                voice_design_id: String
+              }
+            )
+          end
+          def to_hash
+          end
+
+          # Gender of the voice clone.
+          module Gender
+            extend Telnyx::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Telnyx::VoiceCloneCreateParams::Params::MinimaxDesignClone::Gender
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            MALE =
+              T.let(
+                :male,
+                Telnyx::VoiceCloneCreateParams::Params::MinimaxDesignClone::Gender::TaggedSymbol
+              )
+            FEMALE =
+              T.let(
+                :female,
+                Telnyx::VoiceCloneCreateParams::Params::MinimaxDesignClone::Gender::TaggedSymbol
+              )
+            NEUTRAL =
+              T.let(
+                :neutral,
+                Telnyx::VoiceCloneCreateParams::Params::MinimaxDesignClone::Gender::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Telnyx::VoiceCloneCreateParams::Params::MinimaxDesignClone::Gender::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+
+          # Voice synthesis provider. Must be `minimax`.
+          module Provider
+            extend Telnyx::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Telnyx::VoiceCloneCreateParams::Params::MinimaxDesignClone::Provider
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            TELNYX =
+              T.let(
+                :telnyx,
+                Telnyx::VoiceCloneCreateParams::Params::MinimaxDesignClone::Provider::TaggedSymbol
+              )
+            MINIMAX =
+              T.let(
+                :minimax,
+                Telnyx::VoiceCloneCreateParams::Params::MinimaxDesignClone::Provider::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Telnyx::VoiceCloneCreateParams::Params::MinimaxDesignClone::Provider::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
 
         sig do
           override.returns(
-            T::Array[Telnyx::VoiceCloneCreateParams::Provider::TaggedSymbol]
+            T::Array[Telnyx::VoiceCloneCreateParams::Params::Variants]
           )
         end
-        def self.values
+        def self.variants
         end
       end
     end

data/rbi/telnyx/models/voice_clone_data.rbi

@@ -35,6 +35,13 @@ module Telnyx
       sig { returns(T.nilable(String)) }
       attr_accessor :language
 
+      # TTS model identifier for the voice clone.
+      sig { returns(T.nilable(Telnyx::VoiceCloneData::ModelID::TaggedSymbol)) }
+      attr_reader :model_id
+
+      sig { params(model_id: Telnyx::VoiceCloneData::ModelID::OrSymbol).void }
+      attr_writer :model_id
+
       # Name of the voice clone.
       sig { returns(T.nilable(String)) }
       attr_reader :name
@@ -56,8 +63,8 @@ module Telnyx
       sig { params(provider_supported_models: T::Array[String]).void }
       attr_writer :provider_supported_models
 
-      # Provider-specific voice identifier used for TTS synthesis. For Telnyx clones
-      # this equals the clone ID; for Minimax it is the Minimax-assigned voice ID.
+      # Provider-specific voice identifier used for TTS synthesis. May differ from the
+      # clone UUID depending on the provider and model.
       sig { returns(T.nilable(String)) }
       attr_accessor :provider_voice_id
 
@@ -80,6 +87,14 @@ module Telnyx
       sig { returns(T.nilable(Integer)) }
       attr_accessor :source_voice_design_version
 
+      # Clone status. pending for Ultra clones while on-prem import is in progress,
+      # active once ready, failed if verification timed out, expired if not kept alive.
+      sig { returns(T.nilable(Telnyx::VoiceCloneData::Status::TaggedSymbol)) }
+      attr_reader :status
+
+      sig { params(status: Telnyx::VoiceCloneData::Status::OrSymbol).void }
+      attr_writer :status
+
       # Timestamp when the voice clone was last updated.
       sig { returns(T.nilable(Time)) }
       attr_reader :updated_at
@@ -95,6 +110,7 @@ module Telnyx
           gender: T.nilable(Telnyx::VoiceCloneData::Gender::OrSymbol),
           label: T.nilable(String),
           language: T.nilable(String),
+          model_id: Telnyx::VoiceCloneData::ModelID::OrSymbol,
           name: String,
           provider: Telnyx::VoiceCloneData::Provider::OrSymbol,
           provider_supported_models: T::Array[String],
@@ -102,6 +118,7 @@ module Telnyx
           record_type: Telnyx::VoiceCloneData::RecordType::OrSymbol,
           source_voice_design_id: T.nilable(String),
           source_voice_design_version: T.nilable(Integer),
+          status: Telnyx::VoiceCloneData::Status::OrSymbol,
           updated_at: Time
         ).returns(T.attached_class)
       end
@@ -117,14 +134,16 @@ module Telnyx
         label: nil,
         # ISO 639-1 language code of the voice clone.
         language: nil,
+        # TTS model identifier for the voice clone.
+        model_id: nil,
         # Name of the voice clone.
         name: nil,
         # Voice synthesis provider used for this clone.
         provider: nil,
         # List of TTS model identifiers supported by this clone's provider.
         provider_supported_models: nil,
-        # Provider-specific voice identifier used for TTS synthesis. For Telnyx clones
-        # this equals the clone ID; for Minimax it is the Minimax-assigned voice ID.
+        # Provider-specific voice identifier used for TTS synthesis. May differ from the
+        # clone UUID depending on the provider and model.
         provider_voice_id: nil,
         # Identifies the resource type.
         record_type: nil,
@@ -132,6 +151,9 @@ module Telnyx
         source_voice_design_id: nil,
         # Version of the source voice design used. `null` for upload-based clones.
         source_voice_design_version: nil,
+        # Clone status. pending for Ultra clones while on-prem import is in progress,
+        # active once ready, failed if verification timed out, expired if not kept alive.
+        status: nil,
         # Timestamp when the voice clone was last updated.
         updated_at: nil
       )
@@ -145,6 +167,7 @@ module Telnyx
             gender: T.nilable(Telnyx::VoiceCloneData::Gender::TaggedSymbol),
             label: T.nilable(String),
             language: T.nilable(String),
+            model_id: Telnyx::VoiceCloneData::ModelID::TaggedSymbol,
             name: String,
             provider: Telnyx::VoiceCloneData::Provider::TaggedSymbol,
             provider_supported_models: T::Array[String],
@@ -152,6 +175,7 @@ module Telnyx
             record_type: Telnyx::VoiceCloneData::RecordType::TaggedSymbol,
             source_voice_design_id: T.nilable(String),
             source_voice_design_version: T.nilable(Integer),
+            status: Telnyx::VoiceCloneData::Status::TaggedSymbol,
             updated_at: Time
           }
         )
@@ -180,6 +204,32 @@ module Telnyx
         end
       end
 
+      # TTS model identifier for the voice clone.
+      module ModelID
+        extend Telnyx::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Telnyx::VoiceCloneData::ModelID) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        QWEN3_TTS =
+          T.let(:Qwen3TTS, Telnyx::VoiceCloneData::ModelID::TaggedSymbol)
+        ULTRA = T.let(:Ultra, Telnyx::VoiceCloneData::ModelID::TaggedSymbol)
+        SPEECH_2_8_TURBO =
+          T.let(
+            :"speech-2.8-turbo",
+            Telnyx::VoiceCloneData::ModelID::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[Telnyx::VoiceCloneData::ModelID::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+
       # Voice synthesis provider used for this clone.
       module Provider
         extend Telnyx::Internal::Type::Enum
@@ -220,6 +270,29 @@ module Telnyx
         def self.values
         end
       end
+
+      # Clone status. pending for Ultra clones while on-prem import is in progress,
+      # active once ready, failed if verification timed out, expired if not kept alive.
+      module Status
+        extend Telnyx::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Telnyx::VoiceCloneData::Status) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        ACTIVE = T.let(:active, Telnyx::VoiceCloneData::Status::TaggedSymbol)
+        PENDING = T.let(:pending, Telnyx::VoiceCloneData::Status::TaggedSymbol)
+        FAILED = T.let(:failed, Telnyx::VoiceCloneData::Status::TaggedSymbol)
+        EXPIRED = T.let(:expired, Telnyx::VoiceCloneData::Status::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[Telnyx::VoiceCloneData::Status::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
     end
   end
 end

data/rbi/telnyx/models/whatsapp/phone_numbers/profile/photo_retrieve_params.rbi

@@ -0,0 +1,47 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    module Whatsapp
+      module PhoneNumbers
+        module Profile
+          class PhotoRetrieveParams < Telnyx::Internal::Type::BaseModel
+            extend Telnyx::Internal::Type::RequestParameters::Converter
+            include Telnyx::Internal::Type::RequestParameters
+
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Telnyx::Whatsapp::PhoneNumbers::Profile::PhotoRetrieveParams,
+                  Telnyx::Internal::AnyHash
+                )
+              end
+
+            sig { returns(String) }
+            attr_accessor :phone_number
+
+            sig do
+              params(
+                phone_number: String,
+                request_options: Telnyx::RequestOptions::OrHash
+              ).returns(T.attached_class)
+            end
+            def self.new(phone_number:, request_options: {})
+            end
+
+            sig do
+              override.returns(
+                {
+                  phone_number: String,
+                  request_options: Telnyx::RequestOptions
+                }
+              )
+            end
+            def to_hash
+            end
+          end
+        end
+      end
+    end
+  end
+end