telnyx 5.150.0 → 5.152.0

data/lib/telnyx/models/virtual_cross_connect_create.rb

@@ -3,18 +3,192 @@
 module Telnyx
   module Models
     class VirtualCrossConnectCreate < Telnyx::Models::Record
-      # @!method initialize
+      # @!attribute name
+      #   A user specified name for the interface.
+      #
+      #   @return [String, nil]
+      optional :name, String
+
+      # @!attribute network_id
+      #   The id of the network associated with the interface.
+      #
+      #   @return [String, nil]
+      optional :network_id, String
+
+      # @!attribute region_code
+      #   The region the interface should be deployed to.
+      #
+      #   @return [String]
+      required :region_code, String
+
+      # @!attribute bandwidth_mbps
+      #   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.
+      #
+      #   @return [Float, nil]
+      optional :bandwidth_mbps, Float
+
+      # @!attribute bgp_asn
+      #   The Border Gateway Protocol (BGP) Autonomous System Number (ASN). If null, value
+      #   will be assigned by Telnyx.
+      #
+      #   @return [Float, nil]
+      optional :bgp_asn, Float
+
+      # @!attribute cloud_provider
+      #   The Virtual Private Cloud with which you would like to establish a cross
+      #   connect.
+      #
+      #   @return [Symbol, Telnyx::Models::VirtualCrossConnectCreate::CloudProvider, nil]
+      optional :cloud_provider, enum: -> { Telnyx::VirtualCrossConnectCreate::CloudProvider }
+
+      # @!attribute cloud_provider_region
+      #   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.
+      #
+      #   @return [String, nil]
+      optional :cloud_provider_region, String
+
+      # @!attribute primary_bgp_key
+      #   The authentication key for BGP peer configuration.
+      #
+      #   @return [String, nil]
+      optional :primary_bgp_key, String
+
+      # @!attribute primary_cloud_account_id
+      #   The identifier for your Virtual Private Cloud. The number will be different
+      #   based upon your Cloud provider.
+      #
+      #   @return [String, nil]
+      optional :primary_cloud_account_id, String
+
+      # @!attribute primary_cloud_ip
+      #   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.
+      #
+      #   @return [String, nil]
+      optional :primary_cloud_ip, String
+
+      # @!attribute primary_telnyx_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.
+      #
+      #   @return [String, nil]
+      optional :primary_telnyx_ip, String
+
+      # @!attribute secondary_bgp_key
+      #   The authentication key for BGP peer configuration.
+      #
+      #   @return [String, nil]
+      optional :secondary_bgp_key, String
+
+      # @!attribute secondary_cloud_account_id
+      #   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.
+      #
+      #   @return [String, nil]
+      optional :secondary_cloud_account_id, String
+
+      # @!attribute secondary_cloud_ip
+      #   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.
+      #
+      #   @return [String, nil]
+      optional :secondary_cloud_ip, String
+
+      # @!attribute secondary_telnyx_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.
+      #
+      #   @return [String, nil]
+      optional :secondary_telnyx_ip, String
+
+      response_only do
+        # @!attribute status
+        #   The current status of the interface deployment.
+        #
+        #   @return [Symbol, Telnyx::Models::InterfaceStatus, nil]
+        optional :status, enum: -> { Telnyx::InterfaceStatus }
+
+        # @!attribute primary_enabled
+        #   Indicates whether the primary circuit is enabled. Setting this to `false` will
+        #   disable the circuit.
+        #
+        #   @return [Boolean, nil]
+        optional :primary_enabled, Telnyx::Internal::Type::Boolean
+
+        # @!attribute secondary_enabled
+        #   Indicates whether the secondary circuit is enabled. Setting this to `false` will
+        #   disable the circuit.
+        #
+        #   @return [Boolean, nil]
+        optional :secondary_enabled, Telnyx::Internal::Type::Boolean
+      end
+
+      # @!method initialize(region_code:, name: nil, network_id: nil, status: nil, bandwidth_mbps: nil, bgp_asn: nil, cloud_provider: nil, cloud_provider_region: nil, primary_bgp_key: nil, primary_cloud_account_id: nil, primary_cloud_ip: nil, primary_enabled: nil, primary_telnyx_ip: nil, secondary_bgp_key: nil, secondary_cloud_account_id: nil, secondary_cloud_ip: nil, secondary_enabled: nil, secondary_telnyx_ip: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::VirtualCrossConnectCreate} for more details.
+      #
+      #   @param region_code [String] The region the interface should be deployed to.
+      #
+      #   @param name [String] A user specified name for the interface.
+      #
+      #   @param network_id [String] The id of the network associated with the interface.
+      #
+      #   @param status [Symbol, Telnyx::Models::InterfaceStatus] The current status of the interface deployment.
+      #
+      #   @param bandwidth_mbps [Float] The desired throughput in Megabits per Second (Mbps) for your Virtual Cross Conn
+      #
+      #   @param bgp_asn [Float] The Border Gateway Protocol (BGP) Autonomous System Number (ASN). If null, value
+      #
+      #   @param cloud_provider [Symbol, Telnyx::Models::VirtualCrossConnectCreate::CloudProvider] The Virtual Private Cloud with which you would like to establish a cross connect
+      #
+      #   @param cloud_provider_region [String] The region where your Virtual Private Cloud hosts are located.<br /><br />The av
+      #
+      #   @param primary_bgp_key [String] The authentication key for BGP peer configuration.
+      #
+      #   @param primary_cloud_account_id [String] The identifier for your Virtual Private Cloud. The number will be different base
+      #
+      #   @param primary_cloud_ip [String] The IP address assigned for your side of the Virtual Cross Connect.<br /><br />I
+      #
+      #   @param primary_enabled [Boolean] Indicates whether the primary circuit is enabled. Setting this to `false` will d
+      #
+      #   @param primary_telnyx_ip [String] The IP address assigned to the Telnyx side of the Virtual Cross Connect.<br /><b
+      #
+      #   @param secondary_bgp_key [String] The authentication key for BGP peer configuration.
+      #
+      #   @param secondary_cloud_account_id [String] The identifier for your Virtual Private Cloud. The number will be different base
+      #
+      #   @param secondary_cloud_ip [String] The IP address assigned for your side of the Virtual Cross Connect.<br /><br />I
+      #
+      #   @param secondary_enabled [Boolean] Indicates whether the secondary circuit is enabled. Setting this to `false` will
+      #
+      #   @param secondary_telnyx_ip [String] The IP address assigned to the Telnyx side of the Virtual Cross Connect.<br /><b
 
       # The Virtual Private Cloud with which you would like to establish a cross
       # connect.
       #
-      # @see Telnyx::Models::VirtualCrossConnectCreate::CloudProvider
+      # @see Telnyx::Models::VirtualCrossConnectCreate#cloud_provider
       module CloudProvider
         extend Telnyx::Internal::Type::Enum
 
         AWS = :aws
         AZURE = :azure
         GCE = :gce
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
       end
     end
   end

data/lib/telnyx/models/whatsapp/phone_number_retrieve_conversation_window_params.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Whatsapp
+      # @see Telnyx::Resources::Whatsapp::PhoneNumbers#retrieve_conversation_window
+      class PhoneNumberRetrieveConversationWindowParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        # @!attribute phone_number
+        #
+        #   @return [String]
+        required :phone_number, String
+
+        # @!attribute destination_number
+        #   Destination phone number in E.164 format
+        #
+        #   @return [String]
+        required :destination_number, String
+
+        # @!method initialize(phone_number:, destination_number:, request_options: {})
+        #   @param phone_number [String]
+        #
+        #   @param destination_number [String] Destination phone number in E.164 format
+        #
+        #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/telnyx/models/whatsapp/phone_number_retrieve_conversation_window_response.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Whatsapp
+      # @see Telnyx::Resources::Whatsapp::PhoneNumbers#retrieve_conversation_window
+      class PhoneNumberRetrieveConversationWindowResponse < Telnyx::Internal::Type::BaseModel
+        # @!attribute data
+        #
+        #   @return [Telnyx::Models::Whatsapp::PhoneNumberRetrieveConversationWindowResponse::Data, nil]
+        optional :data, -> { Telnyx::Models::Whatsapp::PhoneNumberRetrieveConversationWindowResponse::Data }
+
+        # @!method initialize(data: nil)
+        #   @param data [Telnyx::Models::Whatsapp::PhoneNumberRetrieveConversationWindowResponse::Data]
+
+        # @see Telnyx::Models::Whatsapp::PhoneNumberRetrieveConversationWindowResponse#data
+        class Data < Telnyx::Internal::Type::BaseModel
+          # @!attribute last_user_message_at
+          #   Timestamp of the last inbound message that opened the window
+          #
+          #   @return [Time, nil]
+          optional :last_user_message_at, Time
+
+          # @!attribute window_active
+          #   Whether the 24-hour conversation window is currently open
+          #
+          #   @return [Boolean, nil]
+          optional :window_active, Telnyx::Internal::Type::Boolean
+
+          # @!attribute window_expires_at
+          #   When the window closes. Null if no active window.
+          #
+          #   @return [Time, nil]
+          optional :window_expires_at, Time
+
+          # @!attribute window_type
+          #   Window type. Currently always 24h when present.
+          #
+          #   @return [String, nil]
+          optional :window_type, String
+
+          # @!method initialize(last_user_message_at: nil, window_active: nil, window_expires_at: nil, window_type: nil)
+          #   @param last_user_message_at [Time] Timestamp of the last inbound message that opened the window
+          #
+          #   @param window_active [Boolean] Whether the 24-hour conversation window is currently open
+          #
+          #   @param window_expires_at [Time] When the window closes. Null if no active window.
+          #
+          #   @param window_type [String] Window type. Currently always 24h when present.
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/wireguard_interface.rb

@@ -3,7 +3,30 @@
 module Telnyx
   module Models
     class WireguardInterface < Telnyx::Models::Record
-      # @!method initialize
+      # @!attribute name
+      #   A user specified name for the interface.
+      #
+      #   @return [String, nil]
+      optional :name, String
+
+      # @!attribute network_id
+      #   The id of the network associated with the interface.
+      #
+      #   @return [String, nil]
+      optional :network_id, String
+
+      # @!attribute enable_sip_trunking
+      #   Enable SIP traffic forwarding over VPN interface.
+      #
+      #   @return [Boolean, nil]
+      optional :enable_sip_trunking, Telnyx::Internal::Type::Boolean
+
+      # @!method initialize(name: nil, network_id: nil, enable_sip_trunking: nil)
+      #   @param name [String] A user specified name for the interface.
+      #
+      #   @param network_id [String] The id of the network associated with the interface.
+      #
+      #   @param enable_sip_trunking [Boolean] Enable SIP traffic forwarding over VPN interface.
     end
   end
 end

data/lib/telnyx/resources/ai.rb

@@ -82,12 +82,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 —
@@ -101,14 +101,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:
@@ -121,21 +121,17 @@ 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
       # ```
       #
-      # @overload retrieve_conversation_histories(q:, record_type:, filter_document_id: nil, filter_ingested_at_gte: nil, filter_ingested_at_lte: nil, filter_record_created_at_gte: nil, filter_record_created_at_lte: nil, filter_record_id: nil, filter_region_in: nil, filter_retention: nil, filter_user_id: nil, min_score: nil, region: nil, top_k: nil, request_options: {})
+      # @overload retrieve_conversation_histories(q:, filter_ingested_at_gte: nil, filter_ingested_at_lte: nil, filter_record_created_at_gte: nil, filter_record_created_at_lte: nil, filter_record_id: nil, filter_region_in: nil, filter_retention: nil, filter_user_id: nil, min_score: nil, page_number: nil, page_size: nil, region: nil, request_options: {})
       #
       # @param q [String] Natural language search query. The text is embedded into a 1024-dimensional vect
       #
-      # @param record_type [Symbol, Telnyx::Models::AIRetrieveConversationHistoriesParams::RecordType] The type of records to search. Each record type is stored in a separate vector i
-      #
-      # @param filter_document_id [String] Filter by document identifier (exact match). Populated for knowledge_base record
-      #
       # @param filter_ingested_at_gte [Time] Only include records ingested (chunked, embedded, and indexed) on or after this
       #
       # @param filter_ingested_at_lte [Time] Only include records ingested (chunked, embedded, and indexed) on or before this
@@ -154,9 +150,11 @@ module Telnyx
       #
       # @param min_score [Float] Minimum cosine similarity score threshold (0.0 to 1.0). Results below this thres
       #
-      # @param region [Symbol, Telnyx::Models::AIRetrieveConversationHistoriesParams::Region] Restrict search to a specific region's OpenSearch cluster. When omitted, all reg
+      # @param page_number [Integer] Page number to return (1-based). Defaults to 1.
+      #
+      # @param page_size [Integer] Number of results per page. Defaults to 20, maximum 100.
       #
-      # @param top_k [Integer] Maximum number of results to return. Defaults to 20, maximum 100.
+      # @param region [Symbol, Telnyx::Models::AIRetrieveConversationHistoriesParams::Region] Restrict search to a specific region. When omitted, all regions are queried in p
       #
       # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -170,7 +168,6 @@ module Telnyx
           method: :get,
           path: "ai/conversation_histories",
           query: query.transform_keys(
-            filter_document_id: "filter[document_id]",
             filter_ingested_at_gte: "filter[ingested_at][gte]",
             filter_ingested_at_lte: "filter[ingested_at][lte]",
             filter_record_created_at_gte: "filter[record_created_at][gte]",
@@ -178,7 +175,9 @@ module Telnyx
             filter_record_id: "filter[record_id]",
             filter_region_in: "filter[region][in]",
             filter_retention: "filter[retention]",
-            filter_user_id: "filter[user_id]"
+            filter_user_id: "filter[user_id]",
+            page_number: "page[number]",
+            page_size: "page[size]"
           ),
           model: Telnyx::Models::AIRetrieveConversationHistoriesResponse,
           options: options

data/lib/telnyx/resources/calls/actions.rb

@@ -1339,7 +1339,7 @@ module Telnyx
         #
         # @param transcription_engine [Symbol, Telnyx::Models::Calls::TranscriptionStartRequest::TranscriptionEngine] Engine to use for speech recognition. Legacy values `A` - `Google`, `B` - `Telny
         #
-        # @param transcription_engine_config [Telnyx::Models::Calls::TranscriptionEngineGoogleConfig, Telnyx::Models::Calls::TranscriptionEngineTelnyxConfig, Telnyx::Models::Calls::TranscriptionEngineAzureConfig, Telnyx::Models::Calls::TranscriptionEngineXaiConfig, Telnyx::Models::Calls::TranscriptionEngineAssemblyaiConfig, Telnyx::Models::Calls::TranscriptionEngineSpeechmaticsConfig, Telnyx::Models::Calls::TranscriptionEngineSonioxConfig, Telnyx::Models::Calls::TranscriptionEngineAConfig, Telnyx::Models::Calls::TranscriptionEngineBConfig, Telnyx::Models::Calls::DeepgramNova2Config, Telnyx::Models::Calls::DeepgramNova3Config]
+        # @param transcription_engine_config [Telnyx::Models::Calls::TranscriptionEngineGoogleConfig, Telnyx::Models::Calls::TranscriptionEngineTelnyxConfig, Telnyx::Models::Calls::TranscriptionEngineAzureConfig, Telnyx::Models::Calls::TranscriptionEngineXaiConfig, Telnyx::Models::Calls::TranscriptionEngineAssemblyaiConfig, Telnyx::Models::Calls::TranscriptionEngineSpeechmaticsConfig, Telnyx::Models::Calls::TranscriptionEngineSonioxConfig, Telnyx::Models::Calls::TranscriptionEngineParakeetConfig, Telnyx::Models::Calls::TranscriptionEngineAConfig, Telnyx::Models::Calls::TranscriptionEngineBConfig, Telnyx::Models::Calls::DeepgramNova2Config, Telnyx::Models::Calls::DeepgramNova3Config]
         #
         # @param transcription_tracks [String] Indicates which leg of the call will be transcribed. Use `inbound` for the leg t
         #

data/lib/telnyx/resources/dir/references.rb

@@ -0,0 +1,139 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class Dir
+      # Submit and manage the two business references and one financial reference that
+      # vouch for a DIR. References are contacted to confirm the business identity
+      # during vetting.
+      class References
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::Dir::ReferenceCreateParams} for more details.
+        #
+        # Submit the two business references and one financial reference for a DIR.
+        #
+        # The DIR's authorizer email must be verified first (see the email-verification
+        # endpoint). Until it is, this returns `409` and no references are stored.
+        #
+        # The request body carries exactly two business references plus one financial
+        # reference. On success the references are stored and the response echoes them in
+        # the same shape as the GET. Submitting again converges on the already-stored
+        # references rather than erroring.
+        #
+        # @overload create(dir_id, business_references:, financial_reference:, request_options: {})
+        #
+        # @param dir_id [String] The DIR id. Lowercase UUID.
+        #
+        # @param business_references [Array<Telnyx::Models::Dir::ReferenceInput>] Exactly two business references.
+        #
+        # @param financial_reference [Telnyx::Models::Dir::ReferenceInput] One reference supplied at submit. The reference type is implied by the field tha
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::Dir::ReferenceList]
+        #
+        # @see Telnyx::Models::Dir::ReferenceCreateParams
+        def create(dir_id, params)
+          parsed, options = Telnyx::Dir::ReferenceCreateParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: ["dir/%1$s/references", dir_id],
+            body: parsed,
+            model: Telnyx::Dir::ReferenceList,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::Dir::ReferenceUpdateParams} for more details.
+        #
+        # Partially update one reference, addressed by the DIR id plus the reference's
+        # type (business or financial) and slot.
+        #
+        # Cosmetic fields (full name, job title, organization, relationship, email) are
+        # always editable. The phone number and timezone may only be changed while a
+        # scheduled call has not yet been dialed; if a call is in progress or all attempts
+        # are complete, those fields are locked. Changing the timezone reschedules any
+        # pending call into the new local calling window.
+        #
+        # @overload update(slot, dir_id:, ref_type:, email: nil, full_name: nil, job_title: nil, organization: nil, phone_e164: nil, relationship_to_registrant: nil, timezone: nil, request_options: {})
+        #
+        # @param slot [Integer] Path param: Reference slot. Business references use slots 0 and 1; the financial
+        #
+        # @param dir_id [String] Path param: The DIR id. Lowercase UUID.
+        #
+        # @param ref_type [Symbol, Telnyx::Models::Dir::ReferenceUpdateParams::RefType] Path param: Reference type to address.
+        #
+        # @param email [String] Body param: Reference contact email address.
+        #
+        # @param full_name [String] Body param: Full name of the reference contact.
+        #
+        # @param job_title [String, nil] Body param: Job title of the reference contact.
+        #
+        # @param organization [String, nil] Body param: Organization the reference contact belongs to.
+        #
+        # @param phone_e164 [String] Body param: Reference phone number in E.164 format.
+        #
+        # @param relationship_to_registrant [String, nil] Body param: How the reference contact is related to the registering business.
+        #
+        # @param timezone [String] Body param: IANA timezone id for the reference.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::Dir::ReferenceUpdateResponse]
+        #
+        # @see Telnyx::Models::Dir::ReferenceUpdateParams
+        def update(slot, params)
+          parsed, options = Telnyx::Dir::ReferenceUpdateParams.dump_request(params)
+          dir_id =
+            parsed.delete(:dir_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          ref_type =
+            parsed.delete(:ref_type) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :patch,
+            path: ["dir/%1$s/references/%2$s/%3$s", dir_id, ref_type, slot],
+            body: parsed,
+            model: Telnyx::Models::Dir::ReferenceUpdateResponse,
+            options: options
+          )
+        end
+
+        # List the business and financial references submitted for a DIR.
+        #
+        # Returns the two business references (slots 0 and 1) followed by the single
+        # financial reference. Each entry carries only the customer-supplied details
+        # (name, title, organization, relationship, phone, email, timezone). Returns an
+        # empty list when no references were submitted.
+        #
+        # @overload list(dir_id, request_options: {})
+        #
+        # @param dir_id [String] The DIR id. Lowercase UUID.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::Dir::ReferenceList]
+        #
+        # @see Telnyx::Models::Dir::ReferenceListParams
+        def list(dir_id, params = {})
+          @client.request(
+            method: :get,
+            path: ["dir/%1$s/references", dir_id],
+            model: Telnyx::Dir::ReferenceList,
+            options: params[:request_options]
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Telnyx::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/resources/dir/verify_email.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class Dir
+      # Verify ownership of a DIR's authorizer email. A short code is emailed and
+      # confirmed; the email must be verified before references can be submitted.
+      class VerifyEmail
+        # Email a 6-digit code to the DIR's authorizer email to confirm ownership of that
+        # address.
+        #
+        # The code expires in 15 minutes. Requesting a new code invalidates any previous
+        # one. Resends are rate limited (a short cooldown plus a daily cap). Submit the
+        # code to `POST /dir/{dir_id}/verify_email/confirm`.
+        #
+        # @overload create(dir_id, request_options: {})
+        #
+        # @param dir_id [String] The DIR id. Lowercase UUID.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::Dir::EmailVerificationStatusWrapped]
+        #
+        # @see Telnyx::Models::Dir::VerifyEmailCreateParams
+        def create(dir_id, params = {})
+          @client.request(
+            method: :post,
+            path: ["dir/%1$s/verify_email", dir_id],
+            model: Telnyx::Dir::EmailVerificationStatusWrapped,
+            options: params[:request_options]
+          )
+        end
+
+        # Whether the DIR's current authorizer email has been verified.
+        #
+        # @overload list(dir_id, request_options: {})
+        #
+        # @param dir_id [String] The DIR id. Lowercase UUID.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::Dir::EmailVerificationStatusWrapped]
+        #
+        # @see Telnyx::Models::Dir::VerifyEmailListParams
+        def list(dir_id, params = {})
+          @client.request(
+            method: :get,
+            path: ["dir/%1$s/verify_email", dir_id],
+            model: Telnyx::Dir::EmailVerificationStatusWrapped,
+            options: params[:request_options]
+          )
+        end
+
+        # Submit the 6-digit code that was emailed to the DIR's authorizer email. On
+        # success the authorizer email is marked verified.
+        #
+        # For security, any failure (wrong, expired, already-used, or too many attempts)
+        # returns the same generic message.
+        #
+        # @overload confirm(dir_id, code:, request_options: {})
+        #
+        # @param dir_id [String] The DIR id. Lowercase UUID.
+        #
+        # @param code [String] The 6-digit code sent to the authorizer email.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::Dir::EmailVerificationStatusWrapped]
+        #
+        # @see Telnyx::Models::Dir::VerifyEmailConfirmParams
+        def confirm(dir_id, params)
+          parsed, options = Telnyx::Dir::VerifyEmailConfirmParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: ["dir/%1$s/verify_email/confirm", dir_id],
+            body: parsed,
+            model: Telnyx::Dir::EmailVerificationStatusWrapped,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Telnyx::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end