telnyx 5.150.0 → 5.152.0

data/rbi/telnyx/models/virtual_cross_connect_create.rbi

@@ -8,11 +8,272 @@ module Telnyx
           T.any(Telnyx::VirtualCrossConnectCreate, Telnyx::Internal::AnyHash)
         end
 
-      sig { returns(T.attached_class) }
-      def self.new
+      # A user specified name for the interface.
+      sig { returns(T.nilable(String)) }
+      attr_reader :name
+
+      sig { params(name: String).void }
+      attr_writer :name
+
+      # The id of the network associated with the interface.
+      sig { returns(T.nilable(String)) }
+      attr_reader :network_id
+
+      sig { params(network_id: String).void }
+      attr_writer :network_id
+
+      # The region the interface should be deployed to.
+      sig { returns(String) }
+      attr_accessor :region_code
+
+      # The desired throughput in Megabits per Second (Mbps) for your Virtual Cross
+      # Connect.<br /><br />The available bandwidths can be found using the
+      # /virtual_cross_connect_regions endpoint.
+      sig { returns(T.nilable(Float)) }
+      attr_reader :bandwidth_mbps
+
+      sig { params(bandwidth_mbps: Float).void }
+      attr_writer :bandwidth_mbps
+
+      # The Border Gateway Protocol (BGP) Autonomous System Number (ASN). If null, value
+      # will be assigned by Telnyx.
+      sig { returns(T.nilable(Float)) }
+      attr_reader :bgp_asn
+
+      sig { params(bgp_asn: Float).void }
+      attr_writer :bgp_asn
+
+      # The Virtual Private Cloud with which you would like to establish a cross
+      # connect.
+      sig do
+        returns(
+          T.nilable(Telnyx::VirtualCrossConnectCreate::CloudProvider::OrSymbol)
+        )
       end
+      attr_reader :cloud_provider
+
+      sig do
+        params(
+          cloud_provider:
+            Telnyx::VirtualCrossConnectCreate::CloudProvider::OrSymbol
+        ).void
+      end
+      attr_writer :cloud_provider
+
+      # The region where your Virtual Private Cloud hosts are located.<br /><br />The
+      # available regions can be found using the /virtual_cross_connect_regions
+      # endpoint.
+      sig { returns(T.nilable(String)) }
+      attr_reader :cloud_provider_region
+
+      sig { params(cloud_provider_region: String).void }
+      attr_writer :cloud_provider_region
+
+      # The authentication key for BGP peer configuration.
+      sig { returns(T.nilable(String)) }
+      attr_reader :primary_bgp_key
+
+      sig { params(primary_bgp_key: String).void }
+      attr_writer :primary_bgp_key
+
+      # The identifier for your Virtual Private Cloud. The number will be different
+      # based upon your Cloud provider.
+      sig { returns(T.nilable(String)) }
+      attr_reader :primary_cloud_account_id
+
+      sig { params(primary_cloud_account_id: String).void }
+      attr_writer :primary_cloud_account_id
+
+      # The IP address assigned for your side of the Virtual Cross
+      # Connect.<br /><br />If none is provided, one will be generated for
+      # you.<br /><br />This value should be null for GCE as Google will only inform you
+      # of your assigned IP once the connection has been accepted.
+      sig { returns(T.nilable(String)) }
+      attr_reader :primary_cloud_ip
+
+      sig { params(primary_cloud_ip: String).void }
+      attr_writer :primary_cloud_ip
 
-      sig { override.returns({}) }
+      # The IP address assigned to the Telnyx side of the Virtual Cross
+      # Connect.<br /><br />If none is provided, one will be generated for
+      # you.<br /><br />This value should be null for GCE as Google will only inform you
+      # of your assigned IP once the connection has been accepted.
+      sig { returns(T.nilable(String)) }
+      attr_reader :primary_telnyx_ip
+
+      sig { params(primary_telnyx_ip: String).void }
+      attr_writer :primary_telnyx_ip
+
+      # The authentication key for BGP peer configuration.
+      sig { returns(T.nilable(String)) }
+      attr_reader :secondary_bgp_key
+
+      sig { params(secondary_bgp_key: String).void }
+      attr_writer :secondary_bgp_key
+
+      # The identifier for your Virtual Private Cloud. The number will be different
+      # based upon your Cloud provider.<br /><br />This attribute is only necessary for
+      # GCE.
+      sig { returns(T.nilable(String)) }
+      attr_reader :secondary_cloud_account_id
+
+      sig { params(secondary_cloud_account_id: String).void }
+      attr_writer :secondary_cloud_account_id
+
+      # The IP address assigned for your side of the Virtual Cross
+      # Connect.<br /><br />If none is provided, one will be generated for
+      # you.<br /><br />This value should be null for GCE as Google will only inform you
+      # of your assigned IP once the connection has been accepted.
+      sig { returns(T.nilable(String)) }
+      attr_reader :secondary_cloud_ip
+
+      sig { params(secondary_cloud_ip: String).void }
+      attr_writer :secondary_cloud_ip
+
+      # The IP address assigned to the Telnyx side of the Virtual Cross
+      # Connect.<br /><br />If none is provided, one will be generated for
+      # you.<br /><br />This value should be null for GCE as Google will only inform you
+      # of your assigned IP once the connection has been accepted.
+      sig { returns(T.nilable(String)) }
+      attr_reader :secondary_telnyx_ip
+
+      sig { params(secondary_telnyx_ip: String).void }
+      attr_writer :secondary_telnyx_ip
+
+      # The current status of the interface deployment.
+      sig { returns(T.nilable(Telnyx::InterfaceStatus::OrSymbol)) }
+      attr_reader :status
+
+      sig { params(status: Telnyx::InterfaceStatus::OrSymbol).void }
+      attr_writer :status
+
+      # Indicates whether the primary circuit is enabled. Setting this to `false` will
+      # disable the circuit.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :primary_enabled
+
+      sig { params(primary_enabled: T::Boolean).void }
+      attr_writer :primary_enabled
+
+      # Indicates whether the secondary circuit is enabled. Setting this to `false` will
+      # disable the circuit.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :secondary_enabled
+
+      sig { params(secondary_enabled: T::Boolean).void }
+      attr_writer :secondary_enabled
+
+      sig do
+        params(
+          region_code: String,
+          name: String,
+          network_id: String,
+          status: Telnyx::InterfaceStatus::OrSymbol,
+          bandwidth_mbps: Float,
+          bgp_asn: Float,
+          cloud_provider:
+            Telnyx::VirtualCrossConnectCreate::CloudProvider::OrSymbol,
+          cloud_provider_region: String,
+          primary_bgp_key: String,
+          primary_cloud_account_id: String,
+          primary_cloud_ip: String,
+          primary_enabled: T::Boolean,
+          primary_telnyx_ip: String,
+          secondary_bgp_key: String,
+          secondary_cloud_account_id: String,
+          secondary_cloud_ip: String,
+          secondary_enabled: T::Boolean,
+          secondary_telnyx_ip: String
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The region the interface should be deployed to.
+        region_code:,
+        # A user specified name for the interface.
+        name: nil,
+        # The id of the network associated with the interface.
+        network_id: nil,
+        # The current status of the interface deployment.
+        status: nil,
+        # The desired throughput in Megabits per Second (Mbps) for your Virtual Cross
+        # Connect.<br /><br />The available bandwidths can be found using the
+        # /virtual_cross_connect_regions endpoint.
+        bandwidth_mbps: nil,
+        # The Border Gateway Protocol (BGP) Autonomous System Number (ASN). If null, value
+        # will be assigned by Telnyx.
+        bgp_asn: nil,
+        # The Virtual Private Cloud with which you would like to establish a cross
+        # connect.
+        cloud_provider: nil,
+        # The region where your Virtual Private Cloud hosts are located.<br /><br />The
+        # available regions can be found using the /virtual_cross_connect_regions
+        # endpoint.
+        cloud_provider_region: nil,
+        # The authentication key for BGP peer configuration.
+        primary_bgp_key: nil,
+        # The identifier for your Virtual Private Cloud. The number will be different
+        # based upon your Cloud provider.
+        primary_cloud_account_id: nil,
+        # The IP address assigned for your side of the Virtual Cross
+        # Connect.<br /><br />If none is provided, one will be generated for
+        # you.<br /><br />This value should be null for GCE as Google will only inform you
+        # of your assigned IP once the connection has been accepted.
+        primary_cloud_ip: nil,
+        # Indicates whether the primary circuit is enabled. Setting this to `false` will
+        # disable the circuit.
+        primary_enabled: nil,
+        # The IP address assigned to the Telnyx side of the Virtual Cross
+        # Connect.<br /><br />If none is provided, one will be generated for
+        # you.<br /><br />This value should be null for GCE as Google will only inform you
+        # of your assigned IP once the connection has been accepted.
+        primary_telnyx_ip: nil,
+        # The authentication key for BGP peer configuration.
+        secondary_bgp_key: nil,
+        # The identifier for your Virtual Private Cloud. The number will be different
+        # based upon your Cloud provider.<br /><br />This attribute is only necessary for
+        # GCE.
+        secondary_cloud_account_id: nil,
+        # The IP address assigned for your side of the Virtual Cross
+        # Connect.<br /><br />If none is provided, one will be generated for
+        # you.<br /><br />This value should be null for GCE as Google will only inform you
+        # of your assigned IP once the connection has been accepted.
+        secondary_cloud_ip: nil,
+        # Indicates whether the secondary circuit is enabled. Setting this to `false` will
+        # disable the circuit.
+        secondary_enabled: nil,
+        # The IP address assigned to the Telnyx side of the Virtual Cross
+        # Connect.<br /><br />If none is provided, one will be generated for
+        # you.<br /><br />This value should be null for GCE as Google will only inform you
+        # of your assigned IP once the connection has been accepted.
+        secondary_telnyx_ip: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            name: String,
+            network_id: String,
+            status: Telnyx::InterfaceStatus::OrSymbol,
+            region_code: String,
+            bandwidth_mbps: Float,
+            bgp_asn: Float,
+            cloud_provider:
+              Telnyx::VirtualCrossConnectCreate::CloudProvider::OrSymbol,
+            cloud_provider_region: String,
+            primary_bgp_key: String,
+            primary_cloud_account_id: String,
+            primary_cloud_ip: String,
+            primary_enabled: T::Boolean,
+            primary_telnyx_ip: String,
+            secondary_bgp_key: String,
+            secondary_cloud_account_id: String,
+            secondary_cloud_ip: String,
+            secondary_enabled: T::Boolean,
+            secondary_telnyx_ip: String
+          }
+        )
+      end
       def to_hash
       end
 
@@ -23,10 +284,7 @@ module Telnyx
 
         TaggedSymbol =
           T.type_alias do
-            T.all(
-              Symbol,
-              Telnyx::VirtualCrossConnectCreate::CloudProvider
-            )
+            T.all(Symbol, Telnyx::VirtualCrossConnectCreate::CloudProvider)
           end
         OrSymbol = T.type_alias { T.any(Symbol, String) }
 

data/rbi/telnyx/models/whatsapp/phone_number_retrieve_conversation_window_params.rbi

@@ -0,0 +1,54 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    module Whatsapp
+      class PhoneNumberRetrieveConversationWindowParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Telnyx::Whatsapp::PhoneNumberRetrieveConversationWindowParams,
+              Telnyx::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :phone_number
+
+        # Destination phone number in E.164 format
+        sig { returns(String) }
+        attr_accessor :destination_number
+
+        sig do
+          params(
+            phone_number: String,
+            destination_number: String,
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          phone_number:,
+          # Destination phone number in E.164 format
+          destination_number:,
+          request_options: {}
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              phone_number: String,
+              destination_number: String,
+              request_options: Telnyx::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/models/whatsapp/phone_number_retrieve_conversation_window_response.rbi

@@ -0,0 +1,125 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    module Whatsapp
+      class PhoneNumberRetrieveConversationWindowResponse < Telnyx::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Telnyx::Models::Whatsapp::PhoneNumberRetrieveConversationWindowResponse,
+              Telnyx::Internal::AnyHash
+            )
+          end
+
+        sig do
+          returns(
+            T.nilable(
+              Telnyx::Models::Whatsapp::PhoneNumberRetrieveConversationWindowResponse::Data
+            )
+          )
+        end
+        attr_reader :data
+
+        sig do
+          params(
+            data:
+              Telnyx::Models::Whatsapp::PhoneNumberRetrieveConversationWindowResponse::Data::OrHash
+          ).void
+        end
+        attr_writer :data
+
+        sig do
+          params(
+            data:
+              Telnyx::Models::Whatsapp::PhoneNumberRetrieveConversationWindowResponse::Data::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(data: nil)
+        end
+
+        sig do
+          override.returns(
+            {
+              data:
+                Telnyx::Models::Whatsapp::PhoneNumberRetrieveConversationWindowResponse::Data
+            }
+          )
+        end
+        def to_hash
+        end
+
+        class Data < Telnyx::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Telnyx::Models::Whatsapp::PhoneNumberRetrieveConversationWindowResponse::Data,
+                Telnyx::Internal::AnyHash
+              )
+            end
+
+          # Timestamp of the last inbound message that opened the window
+          sig { returns(T.nilable(Time)) }
+          attr_reader :last_user_message_at
+
+          sig { params(last_user_message_at: Time).void }
+          attr_writer :last_user_message_at
+
+          # Whether the 24-hour conversation window is currently open
+          sig { returns(T.nilable(T::Boolean)) }
+          attr_reader :window_active
+
+          sig { params(window_active: T::Boolean).void }
+          attr_writer :window_active
+
+          # When the window closes. Null if no active window.
+          sig { returns(T.nilable(Time)) }
+          attr_reader :window_expires_at
+
+          sig { params(window_expires_at: Time).void }
+          attr_writer :window_expires_at
+
+          # Window type. Currently always 24h when present.
+          sig { returns(T.nilable(String)) }
+          attr_reader :window_type
+
+          sig { params(window_type: String).void }
+          attr_writer :window_type
+
+          sig do
+            params(
+              last_user_message_at: Time,
+              window_active: T::Boolean,
+              window_expires_at: Time,
+              window_type: String
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Timestamp of the last inbound message that opened the window
+            last_user_message_at: nil,
+            # Whether the 24-hour conversation window is currently open
+            window_active: nil,
+            # When the window closes. Null if no active window.
+            window_expires_at: nil,
+            # Window type. Currently always 24h when present.
+            window_type: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                last_user_message_at: Time,
+                window_active: T::Boolean,
+                window_expires_at: Time,
+                window_type: String
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/models/wireguard_interface.rbi

@@ -8,11 +8,56 @@ module Telnyx
           T.any(Telnyx::WireguardInterface, Telnyx::Internal::AnyHash)
         end
 
-      sig { returns(T.attached_class) }
-      def self.new
+      # A user specified name for the interface.
+      sig { returns(T.nilable(String)) }
+      attr_reader :name
+
+      sig { params(name: String).void }
+      attr_writer :name
+
+      # The id of the network associated with the interface.
+      sig { returns(T.nilable(String)) }
+      attr_reader :network_id
+
+      sig { params(network_id: String).void }
+      attr_writer :network_id
+
+      # Enable SIP traffic forwarding over VPN interface.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :enable_sip_trunking
+
+      sig { params(enable_sip_trunking: T::Boolean).void }
+      attr_writer :enable_sip_trunking
+
+      sig do
+        params(
+          name: String,
+          network_id: String,
+          enable_sip_trunking: T::Boolean
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # A user specified name for the interface.
+        name: nil,
+        # The id of the network associated with the interface.
+        network_id: nil,
+        # Enable SIP traffic forwarding over VPN interface.
+        enable_sip_trunking: nil
+      )
       end
 
-      sig { override.returns({}) }
+      sig do
+        override.returns(
+          {
+            name: String,
+            network_id: String,
+            status: Telnyx::InterfaceStatus::OrSymbol,
+            enable_sip_trunking: T::Boolean,
+            endpoint: String,
+            public_key: String
+          }
+        )
+      end
       def to_hash
       end
     end

data/rbi/telnyx/models/wireguard_peer_retrieve_config_response.rbi

@@ -2,6 +2,6 @@
 
 module Telnyx
   module Models
-    WireguardPeerRetrieveConfigResponse = String
+    WireguardPeerRetrieveConfigResponse = T.type_alias { String }
   end
 end

data/rbi/telnyx/models.rbi

@@ -613,14 +613,9 @@ module Telnyx
     Telnyx::Models::DirListInfringementClaimsParams
 
   DirListParams = Telnyx::Models::DirListParams
-  DirLoaParams = Telnyx::Models::DirLoaParams
 
   DirNewLoaParams = Telnyx::Models::DirNewLoaParams
 
-  DirRetrieveDocumentTypesParams =
-    Telnyx::Models::DirRetrieveDocumentTypesParams
-  DirRetrieveInfringementClaimsParams =
-    Telnyx::Models::DirRetrieveInfringementClaimsParams
   DirRetrieveParams = Telnyx::Models::DirRetrieveParams
 
   DirStatus = Telnyx::Models::DirStatus
@@ -628,8 +623,6 @@ module Telnyx
   DirSubmitParams = Telnyx::Models::DirSubmitParams
 
   DirUpdateInfringementParams = Telnyx::Models::DirUpdateInfringementParams
-  DirUpdateInfringementUpdateParams =
-    Telnyx::Models::DirUpdateInfringementUpdateParams
 
   DirUpdateParams = Telnyx::Models::DirUpdateParams
 

data/rbi/telnyx/resources/ai.rbi

@@ -66,12 +66,12 @@ module Telnyx
       #
       # 1. The query text is embedded into a 1024-dimensional vector using the
       #    multilingual-e5-large model.
-      # 2. The vector is sent to regional OpenSearch clusters for kNN search using HNSW
-      #    cosine similarity.
+      # 2. The vector is compared against indexed record chunks using semantic
+      #    similarity search.
       # 3. When no region is specified, all regions are queried in parallel (fan-out)
       #    and results are merged by score.
-      # 4. Results are ranked by cosine similarity score (descending) and truncated to
-      #    `top_k`.
+      # 4. Results are ranked by similarity score (descending) and paginated via
+      #    `page[number]` / `page[size]`.
       #
       # **Authentication:** Requires a Telnyx API key via `Authorization: Bearer <key>`.
       # Results are automatically scoped to the caller's organization —
@@ -85,14 +85,14 @@ module Telnyx
       # **Filtering:** Use `filter[field][operator]=value` query parameters to narrow
       # results before vector search.
       #
-      # Top-level filterable fields: `user_id`, `record_type`, `region`, `document_id`,
-      # `record_id`, `record_created_at`, `ingested_at`, `retention`
+      # Top-level filterable fields: `user_id`, `region`, `record_id`,
+      # `record_created_at`, `ingested_at`, `retention`
       #
       # Note: `retention` is filter-only — it can be used to narrow results but is not
       # returned in the response body.
       #
       # Metadata fields: any field not in the list above is resolved to
-      # `data.metadata.<field>` in OpenSearch (e.g., `filter[language]=en` →
+      # `data.metadata.<field>` (e.g., `filter[language]=en` →
       # `data.metadata.language`).
       #
       # Supported filter operators:
@@ -105,18 +105,15 @@ module Telnyx
       # **Examples:**
       #
       # ```
-      # GET /v2/ai/conversation_histories?q=billing+issue&record_type=voice&top_k=10
-      # GET /v2/ai/conversation_histories?q=setup+guide&record_type=knowledge_base&region=USA&min_score=0.5
-      # GET /v2/ai/conversation_histories?q=refund&record_type=voice&filter[record_created_at][gte]=2026-01-01T00:00:00Z
-      # GET /v2/ai/conversation_histories?q=outage&record_type=voice&filter[region][in]=USA,DEU
-      # GET /v2/ai/conversation_histories?q=hold+time&record_type=voice&filter[language]=en
+      # GET /v2/ai/conversation_histories?q=billing+issue&page[size]=10
+      # GET /v2/ai/conversation_histories?q=setup+guide&region=USA&min_score=0.5
+      # GET /v2/ai/conversation_histories?q=refund&filter[record_created_at][gte]=2026-01-01T00:00:00Z
+      # GET /v2/ai/conversation_histories?q=outage&filter[region][in]=USA,DEU
+      # GET /v2/ai/conversation_histories?q=hold+time&filter[language]=en
       # ```
       sig do
         params(
           q: String,
-          record_type:
-            Telnyx::AIRetrieveConversationHistoriesParams::RecordType::OrSymbol,
-          filter_document_id: String,
           filter_ingested_at_gte: Time,
           filter_ingested_at_lte: Time,
           filter_record_created_at_gte: Time,
@@ -126,22 +123,17 @@ module Telnyx
           filter_retention: String,
           filter_user_id: String,
           min_score: Float,
+          page_number: Integer,
+          page_size: Integer,
           region:
             Telnyx::AIRetrieveConversationHistoriesParams::Region::OrSymbol,
-          top_k: Integer,
           request_options: Telnyx::RequestOptions::OrHash
         ).returns(Telnyx::Models::AIRetrieveConversationHistoriesResponse)
       end
       def retrieve_conversation_histories(
         # Natural language search query. The text is embedded into a 1024-dimensional
-        # vector and compared against indexed record chunks using kNN cosine similarity.
+        # vector and compared against indexed record chunks using semantic similarity.
         q:,
-        # The type of records to search. Each record type is stored in a separate vector
-        # index.
-        record_type:,
-        # Filter by document identifier (exact match). Populated for knowledge_base
-        # records.
-        filter_document_id: nil,
         # Only include records ingested (chunked, embedded, and indexed) on or after this
         # ISO 8601 timestamp.
         filter_ingested_at_gte: nil,
@@ -168,12 +160,13 @@ module Telnyx
         # Minimum cosine similarity score threshold (0.0 to 1.0). Results below this
         # threshold are excluded.
         min_score: nil,
-        # Restrict search to a specific region's OpenSearch cluster. When omitted, all
-        # regions are queried in parallel (fan-out) and results are merged by cosine
-        # similarity score.
+        # Page number to return (1-based). Defaults to 1.
+        page_number: nil,
+        # Number of results per page. Defaults to 20, maximum 100.
+        page_size: nil,
+        # Restrict search to a specific region. When omitted, all regions are queried in
+        # parallel (fan-out) and results are merged by similarity score.
         region: nil,
-        # Maximum number of results to return. Defaults to 20, maximum 100.
-        top_k: nil,
         request_options: {}
       )
       end

data/rbi/telnyx/resources/calls/actions.rbi

@@ -1839,6 +1839,7 @@ module Telnyx
                 Telnyx::Calls::TranscriptionEngineAssemblyaiConfig::OrHash,
                 Telnyx::Calls::TranscriptionEngineSpeechmaticsConfig::OrHash,
                 Telnyx::Calls::TranscriptionEngineSonioxConfig::OrHash,
+                Telnyx::Calls::TranscriptionEngineParakeetConfig::OrHash,
                 Telnyx::Calls::TranscriptionEngineAConfig::OrHash,
                 Telnyx::Calls::TranscriptionEngineBConfig::OrHash,
                 Telnyx::Calls::DeepgramNova2Config::OrHash,