telnyx 5.159.0 → 5.160.0

data/lib/telnyx/resources/faxes.rb

@@ -83,7 +83,7 @@ module Telnyx
         )
       end
 
-      # View a fax
+      # Retrieve the details of a single fax.
       #
       # @overload retrieve(id, request_options: {})
       #
@@ -106,7 +106,7 @@ module Telnyx
       # Some parameter documentations has been truncated, see
       # {Telnyx::Models::FaxListParams} for more details.
       #
-      # View a list of faxes
+      # Retrieve a paginated list of faxes sent or received on your account.
       #
       # @overload list(filter: nil, page_number: nil, page_size: nil, request_options: {})
       #
@@ -134,7 +134,7 @@ module Telnyx
         )
       end
 
-      # Delete a fax
+      # Delete a fax resource from your account.
       #
       # @overload delete(id, request_options: {})
       #

data/lib/telnyx/resources/fqdn_connections/fqdn_authentication.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class FqdnConnections
+      # FQDN connection operations
+      class FqdnAuthentication
+        # Retrieves the details of an existing FQDN authentication strategy for a specific
+        # FQDN connection.
+        #
+        # @overload list(fqdn_connection_id, request_options: {})
+        #
+        # @param fqdn_connection_id [String] The ID of the FQDN connection.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::FqdnConnections::FqdnAuthenticationListResponse]
+        #
+        # @see Telnyx::Models::FqdnConnections::FqdnAuthenticationListParams
+        def list(fqdn_connection_id, params = {})
+          @client.request(
+            method: :get,
+            path: ["fqdn_connections/%1$s/fqdn_authentication", fqdn_connection_id],
+            model: Telnyx::Models::FqdnConnections::FqdnAuthenticationListResponse,
+            options: params[:request_options]
+          )
+        end
+
+        # Updates the FQDN authentication strategy for a specific FQDN connection.
+        #
+        # @overload patch_all(fqdn_connection_id, failover_url: nil, fqdn_outbound_authentication: nil, ip_authentication_method: nil, password: nil, txt_name: nil, txt_ttl: nil, txt_value: nil, user_name: nil, webhook_url: nil, request_options: {})
+        #
+        # @param fqdn_connection_id [String] The ID of the FQDN connection.
+        #
+        # @param failover_url [String] The failover webhook URL.
+        #
+        # @param fqdn_outbound_authentication [Symbol, Telnyx::Models::FqdnConnections::FqdnAuthenticationPatchAllParams::FqdnOutboundAuthentication] The outbound authentication type.
+        #
+        # @param ip_authentication_method [Symbol, Telnyx::Models::FqdnConnections::FqdnAuthenticationPatchAllParams::IPAuthenticationMethod] The IP authentication method.
+        #
+        # @param password [String] The password for authentication.
+        #
+        # @param txt_name [String] The TXT record name for Microsoft Teams SBC DNS verification.
+        #
+        # @param txt_ttl [Integer] The TTL for the TXT record.
+        #
+        # @param txt_value [String] The TXT record value for Microsoft Teams SBC DNS verification.
+        #
+        # @param user_name [String] The username for authentication.
+        #
+        # @param webhook_url [String] The webhook URL for authentication events.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::FqdnConnections::FqdnAuthenticationPatchAllResponse]
+        #
+        # @see Telnyx::Models::FqdnConnections::FqdnAuthenticationPatchAllParams
+        def patch_all(fqdn_connection_id, params = {})
+          parsed, options = Telnyx::FqdnConnections::FqdnAuthenticationPatchAllParams.dump_request(params)
+          @client.request(
+            method: :patch,
+            path: ["fqdn_connections/%1$s/fqdn_authentication", fqdn_connection_id],
+            body: parsed,
+            model: Telnyx::Models::FqdnConnections::FqdnAuthenticationPatchAllResponse,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Telnyx::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/resources/fqdn_connections.rb

@@ -4,6 +4,10 @@ module Telnyx
   module Resources
     # FQDN connection operations
     class FqdnConnections
+      # FQDN connection operations
+      # @return [Telnyx::Resources::FqdnConnections::FqdnAuthentication]
+      attr_reader :fqdn_authentication
+
       # Some parameter documentations has been truncated, see
       # {Telnyx::Models::FqdnConnectionCreateParams} for more details.
       #
@@ -100,7 +104,7 @@ module Telnyx
       #
       # Updates settings of an existing FQDN connection.
       #
-      # @overload update(id, active: nil, anchorsite_override: nil, android_push_credential_id: nil, call_cost_in_webhooks: nil, connection_name: nil, default_on_hold_comfort_noise_enabled: nil, dtmf_type: nil, encode_contact_header_enabled: nil, encrypted_media: nil, inbound: nil, ios_push_credential_id: nil, jitter_buffer: nil, noise_suppression: nil, noise_suppression_details: nil, onnet_t38_passthrough_enabled: nil, outbound: nil, rtcp_settings: nil, tags: nil, transport_protocol: nil, webhook_api_version: nil, webhook_event_failover_url: nil, webhook_event_url: nil, webhook_timeout_secs: nil, request_options: {})
+      # @overload update(id, active: nil, anchorsite_override: nil, android_push_credential_id: nil, call_cost_in_webhooks: nil, connection_name: nil, conversation_persistence: nil, default_on_hold_comfort_noise_enabled: nil, dtmf_type: nil, encode_contact_header_enabled: nil, encrypted_media: nil, inbound: nil, ios_push_credential_id: nil, jitter_buffer: nil, noise_suppression: nil, noise_suppression_details: nil, onnet_t38_passthrough_enabled: nil, outbound: nil, rtcp_settings: nil, tags: nil, transport_protocol: nil, webhook_api_version: nil, webhook_event_failover_url: nil, webhook_event_url: nil, webhook_timeout_secs: nil, request_options: {})
       #
       # @param id [String] Identifies the resource.
       #
@@ -114,6 +118,8 @@ module Telnyx
       #
       # @param connection_name [String] A user-assigned name to help manage the connection.
       #
+      # @param conversation_persistence [Boolean] Whether conversation persistence is enabled for this connection. When enabled, c
+      #
       # @param default_on_hold_comfort_noise_enabled [Boolean] When enabled, Telnyx will generate comfort noise when you place the call on hold
       #
       # @param dtmf_type [Symbol, Telnyx::Models::DtmfType] Sets the type of DTMF digits sent from Telnyx to this Connection. Note that DTMF
@@ -225,6 +231,7 @@ module Telnyx
       # @param client [Telnyx::Client]
       def initialize(client:)
         @client = client
+        @fqdn_authentication = Telnyx::Resources::FqdnConnections::FqdnAuthentication.new(client: client)
       end
     end
   end

data/lib/telnyx/resources/global_ip_assignment_health.rb

@@ -7,7 +7,7 @@ module Telnyx
       # Some parameter documentations has been truncated, see
       # {Telnyx::Models::GlobalIPAssignmentHealthRetrieveParams} for more details.
       #
-      # Global IP Assignment Health Check Metrics
+      # Retrieve health check metrics for your Global IP assignments.
       #
       # @overload retrieve(filter: nil, request_options: {})
       #

data/lib/telnyx/resources/global_ip_assignments_usage.rb

@@ -7,7 +7,7 @@ module Telnyx
       # Some parameter documentations has been truncated, see
       # {Telnyx::Models::GlobalIPAssignmentsUsageRetrieveParams} for more details.
       #
-      # Global IP Assignment Usage Metrics
+      # Retrieve usage metrics for your Global IP assignments.
       #
       # @overload retrieve(filter: nil, request_options: {})
       #

data/lib/telnyx/resources/global_ip_latency.rb

@@ -7,7 +7,7 @@ module Telnyx
       # Some parameter documentations has been truncated, see
       # {Telnyx::Models::GlobalIPLatencyRetrieveParams} for more details.
       #
-      # Global IP Latency Metrics
+      # Retrieve latency metrics measured for your Global IPs.
       #
       # @overload retrieve(filter: nil, request_options: {})
       #

data/lib/telnyx/resources/global_ip_usage.rb

@@ -7,7 +7,7 @@ module Telnyx
       # Some parameter documentations has been truncated, see
       # {Telnyx::Models::GlobalIPUsageRetrieveParams} for more details.
       #
-      # Global IP Usage Metrics
+      # Retrieve usage metrics for your Global IPs.
       #
       # @overload retrieve(filter: nil, request_options: {})
       #

data/lib/telnyx/resources/ip_connections.rb

@@ -98,7 +98,7 @@ module Telnyx
       #
       # Updates settings of an existing IP connection.
       #
-      # @overload update(id, active: nil, anchorsite_override: nil, android_push_credential_id: nil, call_cost_in_webhooks: nil, connection_name: nil, default_on_hold_comfort_noise_enabled: nil, dtmf_type: nil, encode_contact_header_enabled: nil, encrypted_media: nil, inbound: nil, ios_push_credential_id: nil, jitter_buffer: nil, noise_suppression: nil, noise_suppression_details: nil, onnet_t38_passthrough_enabled: nil, outbound: nil, rtcp_settings: nil, tags: nil, transport_protocol: nil, webhook_api_version: nil, webhook_event_failover_url: nil, webhook_event_url: nil, webhook_timeout_secs: nil, request_options: {})
+      # @overload update(id, active: nil, anchorsite_override: nil, android_push_credential_id: nil, call_cost_in_webhooks: nil, connection_name: nil, conversation_persistence: nil, default_on_hold_comfort_noise_enabled: nil, dtmf_type: nil, encode_contact_header_enabled: nil, encrypted_media: nil, inbound: nil, ios_push_credential_id: nil, jitter_buffer: nil, noise_suppression: nil, noise_suppression_details: nil, onnet_t38_passthrough_enabled: nil, outbound: nil, rtcp_settings: nil, tags: nil, transport_protocol: nil, webhook_api_version: nil, webhook_event_failover_url: nil, webhook_event_url: nil, webhook_timeout_secs: nil, request_options: {})
       #
       # @param id [String] Identifies the type of resource.
       #
@@ -112,6 +112,8 @@ module Telnyx
       #
       # @param connection_name [String]
       #
+      # @param conversation_persistence [Boolean] Whether conversation persistence is enabled for this connection. When enabled, c
+      #
       # @param default_on_hold_comfort_noise_enabled [Boolean] When enabled, Telnyx will generate comfort noise when you place the call on hold
       #
       # @param dtmf_type [Symbol, Telnyx::Models::DtmfType] Sets the type of DTMF digits sent from Telnyx to this Connection. Note that DTMF

data/lib/telnyx/resources/ledger_billing_group_reports.rb

@@ -4,7 +4,8 @@ module Telnyx
   module Resources
     # Ledger billing reports
     class LedgerBillingGroupReports
-      # Create a ledger billing group report
+      # Create a ledger billing group report, which aggregates ledger activity by
+      # billing group.
       #
       # @overload create(month: nil, year: nil, request_options: {})
       #
@@ -28,7 +29,8 @@ module Telnyx
         )
       end
 
-      # Get a ledger billing group report
+      # Retrieve the details and status of a previously created ledger billing group
+      # report.
       #
       # @overload retrieve(id, request_options: {})
       #

data/lib/telnyx/resources/messages/rcs.rb

@@ -33,7 +33,8 @@ module Telnyx
           )
         end
 
-        # Send an RCS message
+        # Queues an outbound RCS message through the selected RCS agent. Check recipient
+        # capabilities before sending features that require RCS support.
         #
         # @overload send_(agent_id:, agent_message:, messaging_profile_id:, to:, mms_fallback: nil, sms_fallback: nil, type: nil, webhook_url: nil, request_options: {})
         #

data/lib/telnyx/resources/messages.rb

@@ -2,7 +2,6 @@
 
 module Telnyx
   module Resources
-    # Messages
     class Messages
       # Send RCS messages
       # @return [Telnyx::Resources::Messages::Rcs]
@@ -181,7 +180,8 @@ module Telnyx
       # Some parameter documentations has been truncated, see
       # {Telnyx::Models::MessageSendGroupMmsParams} for more details.
       #
-      # Send a group MMS message
+      # Queues an MMS addressed to multiple recipients as a group conversation. Delivery
+      # events are reported asynchronously through messaging webhooks.
       #
       # @overload send_group_mms(from:, to:, media_urls: nil, subject: nil, text: nil, use_profile_webhooks: nil, webhook_failover_url: nil, webhook_url: nil, request_options: {})
       #
@@ -220,7 +220,8 @@ module Telnyx
       # Some parameter documentations has been truncated, see
       # {Telnyx::Models::MessageSendLongCodeParams} for more details.
       #
-      # Send a long code message
+      # Queues an outbound SMS or MMS using a long-code sender. Delivery progress and
+      # final disposition are reported asynchronously through messaging webhooks.
       #
       # @overload send_long_code(from:, to:, auto_detect: nil, encoding: nil, media_urls: nil, subject: nil, text: nil, type: nil, use_profile_webhooks: nil, webhook_failover_url: nil, webhook_url: nil, request_options: {})
       #
@@ -265,7 +266,8 @@ module Telnyx
       # Some parameter documentations has been truncated, see
       # {Telnyx::Models::MessageSendNumberPoolParams} for more details.
       #
-      # Send a message using number pool
+      # Queues an outbound message using a number pool. Telnyx selects an eligible
+      # sender from the pool according to its messaging profile configuration.
       #
       # @overload send_number_pool(messaging_profile_id:, to:, auto_detect: nil, encoding: nil, media_urls: nil, subject: nil, text: nil, type: nil, use_profile_webhooks: nil, webhook_failover_url: nil, webhook_url: nil, request_options: {})
       #
@@ -310,7 +312,8 @@ module Telnyx
       # Some parameter documentations has been truncated, see
       # {Telnyx::Models::MessageSendShortCodeParams} for more details.
       #
-      # Send a short code message
+      # Queues an outbound SMS or MMS using a short-code sender. Delivery progress and
+      # final disposition are reported asynchronously through messaging webhooks.
       #
       # @overload send_short_code(from:, to:, auto_detect: nil, encoding: nil, media_urls: nil, subject: nil, text: nil, type: nil, use_profile_webhooks: nil, webhook_failover_url: nil, webhook_url: nil, request_options: {})
       #
@@ -386,6 +389,41 @@ module Telnyx
         )
       end
 
+      # Sends a WhatsApp message using a Telnyx WhatsApp-enabled number. The message
+      # body, interactive elements, media, location, and reaction content are specified
+      # in the `whatsapp_message` field. Delivery progress and final disposition are
+      # reported asynchronously through messaging webhooks.
+      #
+      # @overload whatsapp(from:, to:, whatsapp_message:, messaging_profile_id: nil, type: nil, webhook_url: nil, request_options: {})
+      #
+      # @param from [String] Phone number in +E.164 format associated with Whatsapp account
+      #
+      # @param to [String] Phone number in +E.164 format
+      #
+      # @param whatsapp_message [Telnyx::Models::WhatsappMessageContent]
+      #
+      # @param messaging_profile_id [String] Messaging profile ID - required if the 'from' number is not SMS-enabled
+      #
+      # @param type [Symbol, Telnyx::Models::MessageWhatsappParams::Type] Message type - must be set to "WHATSAPP"
+      #
+      # @param webhook_url [String] The URL where webhooks related to this message will be sent.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::MessageWhatsappResponse]
+      #
+      # @see Telnyx::Models::MessageWhatsappParams
+      def whatsapp(params)
+        parsed, options = Telnyx::MessageWhatsappParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "messages/whatsapp",
+          body: parsed,
+          model: Telnyx::Models::MessageWhatsappResponse,
+          options: options
+        )
+      end
+
       # @api private
       #
       # @param client [Telnyx::Client]

data/lib/telnyx/resources/messaging/rcs/agents.rb

@@ -6,7 +6,7 @@ module Telnyx
       class Rcs
         # Send RCS messages
         class Agents
-          # Retrieve an RCS agent
+          # Returns the configuration and current state of the specified RCS agent.
           #
           # @overload retrieve(id, request_options: {})
           #
@@ -14,19 +14,19 @@ module Telnyx
           #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
-          # @return [Telnyx::Models::RcsAgentResponse]
+          # @return [Telnyx::Models::Rcs::RcsAgentResponse]
           #
           # @see Telnyx::Models::Messaging::Rcs::AgentRetrieveParams
           def retrieve(id, params = {})
             @client.request(
               method: :get,
               path: ["messaging/rcs/agents/%1$s", id],
-              model: Telnyx::RcsAgentResponse,
+              model: Telnyx::Rcs::RcsAgentResponse,
               options: params[:request_options]
             )
           end
 
-          # Modify an RCS agent
+          # Updates the supplied configuration fields on the specified RCS agent.
           #
           # @overload update(id, profile_id: nil, webhook_failover_url: nil, webhook_url: nil, request_options: {})
           #
@@ -40,7 +40,7 @@ module Telnyx
           #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
-          # @return [Telnyx::Models::RcsAgentResponse]
+          # @return [Telnyx::Models::Rcs::RcsAgentResponse]
           #
           # @see Telnyx::Models::Messaging::Rcs::AgentUpdateParams
           def update(id, params = {})
@@ -49,12 +49,12 @@ module Telnyx
               method: :patch,
               path: ["messaging/rcs/agents/%1$s", id],
               body: parsed,
-              model: Telnyx::RcsAgentResponse,
+              model: Telnyx::Rcs::RcsAgentResponse,
               options: options
             )
           end
 
-          # List all RCS agents
+          # Returns RCS agents available to the authenticated account.
           #
           # @overload list(page_number: nil, page_size: nil, request_options: {})
           #
@@ -62,7 +62,7 @@ module Telnyx
           # @param page_size [Integer]
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
-          # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::RcsAgent>]
+          # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::Rcs::RcsAgent>]
           #
           # @see Telnyx::Models::Messaging::Rcs::AgentListParams
           def list(params = {})
@@ -73,7 +73,7 @@ module Telnyx
               path: "messaging/rcs/agents",
               query: query.transform_keys(page_number: "page[number]", page_size: "page[size]"),
               page: Telnyx::Internal::DefaultFlatPagination,
-              model: Telnyx::RcsAgent,
+              model: Telnyx::Rcs::RcsAgent,
               options: options
             )
           end

data/lib/telnyx/resources/messaging/rcs.rb

@@ -36,7 +36,7 @@ module Telnyx
           )
         end
 
-        # Check RCS capabilities (batch)
+        # Returns RCS capability information for multiple recipients in one request.
         #
         # @overload list_bulk_capabilities(agent_id:, phone_numbers:, request_options: {})
         #
@@ -60,7 +60,8 @@ module Telnyx
           )
         end
 
-        # Check RCS capabilities
+        # Returns the RCS features supported by the specified recipient for the selected
+        # agent.
         #
         # @overload retrieve_capabilities(phone_number, agent_id:, request_options: {})
         #

data/lib/telnyx/resources/messaging_10dlc/brand.rb

@@ -317,7 +317,9 @@ module Telnyx
           )
         end
 
-        # Resend brand 2FA email
+        # Requests a new two-factor authentication email for the specified 10DLC brand.
+        # Complete verification through the link delivered to the brand contact before
+        # continuing registration.
         #
         # @overload resend_2fa_email(brand_id, request_options: {})
         #

data/lib/telnyx/resources/messaging_10dlc/campaign/osr.rb

@@ -6,7 +6,9 @@ module Telnyx
       class Campaign
         # Campaign operations
         class Osr
-          # Get OSR campaign attributes
+          # Returns the optional shared-responsibility attributes recorded for the campaign.
+          # Use these values to inspect the campaign configuration submitted to the
+          # registry.
           #
           # @overload get_attributes(campaign_id, request_options: {})
           #

data/lib/telnyx/resources/messaging_10dlc/campaign/usecase.rb

@@ -6,7 +6,8 @@ module Telnyx
       class Campaign
         # Campaign operations
         class Usecase
-          # Get Campaign Cost
+          # Returns the upfront and monthly cost associated with the selected 10DLC campaign
+          # use case.
           #
           # @overload get_cost(usecase:, request_options: {})
           #

data/lib/telnyx/resources/messaging_10dlc/campaign.rb

@@ -194,7 +194,8 @@ module Telnyx
           )
         end
 
-        # Get Sharing Status
+        # Returns whether the campaign is configured for partner sharing and the current
+        # sharing state.
         #
         # @overload get_sharing_status(campaign_id, request_options: {})
         #

data/lib/telnyx/resources/messaging_10dlc/partner_campaigns.rb

@@ -120,7 +120,7 @@ module Telnyx
           )
         end
 
-        # Get Sharing Status
+        # Returns the partner-sharing state for the specified campaign.
         #
         # @overload retrieve_sharing_status(campaign_id, request_options: {})
         #

data/lib/telnyx/resources/messaging_10dlc/phone_number_campaigns.rb

@@ -5,7 +5,8 @@ module Telnyx
     class Messaging10dlc
       # Phone number campaign assignment
       class PhoneNumberCampaigns
-        # Create New Phone Number Campaign
+        # Assigns a phone number to a 10DLC campaign. The assignment controls which
+        # registered campaign is used for traffic from that number.
         #
         # @overload create(campaign_id:, phone_number:, request_options: {})
         #
@@ -49,7 +50,7 @@ module Telnyx
           )
         end
 
-        # Create New Phone Number Campaign
+        # Replaces the 10DLC campaign assignment for the specified phone number.
         #
         # @overload update(campaign_phone_number, campaign_id:, phone_number:, request_options: {})
         #
@@ -79,7 +80,8 @@ module Telnyx
         # {Telnyx::Models::Messaging10dlc::PhoneNumberCampaignListParams} for more
         # details.
         #
-        # List phone number campaigns
+        # Returns phone-number-to-campaign assignments for the authenticated account.
+        # Apply the documented filters and pagination parameters to narrow the result set.
         #
         # @overload list(filter: nil, page: nil, records_per_page: nil, sort: nil, request_options: {})
         #

data/lib/telnyx/resources/messaging_10dlc.rb

@@ -26,7 +26,8 @@ module Telnyx
       # @return [Telnyx::Resources::Messaging10dlc::PhoneNumberAssignmentByProfile]
       attr_reader :phone_number_assignment_by_profile
 
-      # Get Enum
+      # Returns the accepted values for the selected 10DLC enumeration endpoint. Use
+      # these values when constructing brand and campaign requests.
       #
       # @overload get_enum(endpoint, request_options: {})
       #

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

@@ -9,7 +9,7 @@ module Telnyx
         # {Telnyx::Models::MessagingHostedNumberOrders::ActionUploadFileParams} for more
         # details.
         #
-        # Upload hosted number document
+        # Uploads a supporting document to the specified hosted-messaging order.
         #
         # @overload upload_file(id, bill: nil, loa: nil, request_options: {})
         #

data/lib/telnyx/resources/messaging_hosted_number_orders.rb

@@ -11,7 +11,8 @@ module Telnyx
       # Some parameter documentations has been truncated, see
       # {Telnyx::Models::MessagingHostedNumberOrderCreateParams} for more details.
       #
-      # Create a messaging hosted number order
+      # Creates an order to enable Telnyx messaging on phone numbers whose voice service
+      # remains with another carrier.
       #
       # @overload create(messaging_profile_id: nil, phone_numbers: nil, request_options: {})
       #
@@ -35,7 +36,8 @@ module Telnyx
         )
       end
 
-      # Retrieve a messaging hosted number order
+      # Returns the current state, phone numbers, and required actions for the specified
+      # hosted-messaging order.
       #
       # @overload retrieve(id, request_options: {})
       #
@@ -55,7 +57,8 @@ module Telnyx
         )
       end
 
-      # List messaging hosted number orders
+      # Returns hosted-messaging orders for the authenticated account. Apply the
+      # documented filters and pagination parameters to narrow the result set.
       #
       # @overload list(page_number: nil, page_size: nil, request_options: {})
       #
@@ -99,7 +102,8 @@ module Telnyx
         )
       end
 
-      # Check hosted messaging eligibility
+      # Checks whether the supplied phone numbers are eligible for hosted messaging
+      # before an order is created.
       #
       # @overload check_eligibility(phone_numbers:, request_options: {})
       #

data/lib/telnyx/resources/messaging_hosted_numbers.rb

@@ -95,7 +95,7 @@ module Telnyx
         )
       end
 
-      # Delete a messaging hosted number
+      # Removes the specified hosted number from Telnyx messaging management.
       #
       # @overload delete(id, request_options: {})
       #

data/lib/telnyx/resources/messaging_numbers_bulk_updates.rb

@@ -7,7 +7,8 @@ module Telnyx
       # Some parameter documentations has been truncated, see
       # {Telnyx::Models::MessagingNumbersBulkUpdateCreateParams} for more details.
       #
-      # Bulk update phone number profiles
+      # Starts a bulk update of messaging-profile assignments for the supplied phone
+      # numbers. The response identifies the order used to monitor processing.
       #
       # @overload create(messaging_profile_id:, numbers:, assign_only: nil, request_options: {})
       #
@@ -33,7 +34,8 @@ module Telnyx
         )
       end
 
-      # Retrieve bulk update status
+      # Returns processing status and results for a bulk messaging-settings update
+      # order.
       #
       # @overload retrieve(order_id, request_options: {})
       #

data/lib/telnyx/resources/messaging_profiles/autoresp_configs.rb

@@ -5,7 +5,8 @@ module Telnyx
     class MessagingProfiles
       # Opt-Out Management
       class AutorespConfigs
-        # Create auto-response setting
+        # Creates an auto-response rule on the specified messaging profile. Matching
+        # inbound messages trigger the configured response.
         #
         # @overload create(profile_id, country_code:, keywords:, op:, resp_text: nil, request_options: {})
         #
@@ -35,7 +36,8 @@ module Telnyx
           )
         end
 
-        # Get Auto-Response Setting
+        # Returns the matching criteria and response content for the specified
+        # auto-response rule.
         #
         # @overload retrieve(autoresp_cfg_id, profile_id:, request_options: {})
         #
@@ -62,7 +64,7 @@ module Telnyx
           )
         end
 
-        # Update Auto-Response Setting
+        # Replaces the configuration of the specified auto-response rule.
         #
         # @overload update(autoresp_cfg_id, profile_id:, country_code:, keywords:, op:, resp_text: nil, request_options: {})
         #
@@ -101,7 +103,7 @@ module Telnyx
         # Some parameter documentations has been truncated, see
         # {Telnyx::Models::MessagingProfiles::AutorespConfigListParams} for more details.
         #
-        # List Auto-Response Settings
+        # Returns the auto-response rules configured for the specified messaging profile.
         #
         # @overload list(profile_id, country_code: nil, created_at: nil, updated_at: nil, request_options: {})
         #
@@ -130,7 +132,7 @@ module Telnyx
           )
         end
 
-        # Delete Auto-Response Setting
+        # Deletes the specified auto-response rule from the messaging profile.
         #
         # @overload delete(autoresp_cfg_id, profile_id:, request_options: {})
         #