telnyx 5.158.0 → 5.160.0

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: {})
         #

data/lib/telnyx/resources/messaging_profiles.rb

@@ -13,7 +13,8 @@ module Telnyx
       # Some parameter documentations has been truncated, see
       # {Telnyx::Models::MessagingProfileCreateParams} for more details.
       #
-      # Create a messaging profile
+      # Creates a messaging profile that controls outbound sender selection, webhook
+      # delivery, and inbound message handling for associated numbers and short codes.
       #
       # @overload create(name:, whitelisted_destinations:, ai_assistant_id: nil, alpha_sender: nil, daily_spend_limit: nil, daily_spend_limit_enabled: nil, enabled: nil, health_webhook_url: nil, mms_fall_back_to_sms: nil, mms_transcoding: nil, mobile_only: nil, number_pool_settings: nil, resource_group_id: nil, smart_encoding: nil, url_shortener_settings: nil, webhook_api_version: nil, webhook_failover_url: nil, webhook_url: nil, request_options: {})
       #
@@ -69,7 +70,8 @@ module Telnyx
         )
       end
 
-      # Retrieve a messaging profile
+      # Returns the complete configuration of the specified messaging profile, including
+      # webhook and sender-selection settings.
       #
       # @overload retrieve(messaging_profile_id, request_options: {})
       #
@@ -92,7 +94,8 @@ module Telnyx
       # Some parameter documentations has been truncated, see
       # {Telnyx::Models::MessagingProfileUpdateParams} for more details.
       #
-      # Update a messaging profile
+      # Updates the supplied settings on the specified messaging profile. Settings
+      # omitted from the request remain unchanged.
       #
       # @overload update(messaging_profile_id, ai_assistant_id: nil, alpha_sender: nil, daily_spend_limit: nil, daily_spend_limit_enabled: nil, enabled: nil, mms_fall_back_to_sms: nil, mms_transcoding: nil, mobile_only: nil, name: nil, number_pool_settings: nil, smart_encoding: nil, url_shortener_settings: nil, v1_secret: nil, webhook_api_version: nil, webhook_failover_url: nil, webhook_url: nil, whitelisted_destinations: nil, request_options: {})
       #
@@ -148,7 +151,8 @@ module Telnyx
         )
       end
 
-      # List messaging profiles
+      # Returns messaging profiles owned by the authenticated account. Apply the
+      # documented filters and pagination parameters to narrow the result set.
       #
       # @overload list(filter: nil, filter_name_contains: nil, filter_name_eq: nil, page_number: nil, page_size: nil, request_options: {})
       #
@@ -185,7 +189,8 @@ module Telnyx
         )
       end
 
-      # Delete a messaging profile
+      # Deletes the specified messaging profile and returns the profile's final
+      # configuration.
       #
       # @overload delete(messaging_profile_id, request_options: {})
       #
@@ -233,7 +238,8 @@ module Telnyx
         )
       end
 
-      # List phone numbers associated with a messaging profile
+      # Returns the phone numbers currently associated with the specified messaging
+      # profile.
       #
       # @overload list_phone_numbers(messaging_profile_id, page_number: nil, page_size: nil, request_options: {})
       #
@@ -261,7 +267,8 @@ module Telnyx
         )
       end
 
-      # List short codes associated with a messaging profile
+      # Returns the short codes currently associated with the specified messaging
+      # profile.
       #
       # @overload list_short_codes(messaging_profile_id, page_number: nil, page_size: nil, request_options: {})
       #

data/lib/telnyx/resources/messaging_tollfree/verification/requests.rb

@@ -64,7 +64,7 @@ module Telnyx
           #
           # @param doing_business_as [String, nil] Doing Business As (DBA) name if different from legal name
           #
-          # @param entity_type [Symbol, Telnyx::Models::MessagingTollfree::Verification::TollFreeVerificationEntityType, nil] Business entity classification
+          # @param entity_type [Symbol, Telnyx::Models::MessagingTollfree::Verification::MessagingTollFreeVerificationEntityType, nil] Business entity classification
           #
           # @param help_message_response [String, nil] The message returned when users text 'HELP'
           #
@@ -82,7 +82,7 @@ module Telnyx
           #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
-          # @return [Telnyx::Models::MessagingTollfree::Verification::VerificationRequestEgress]
+          # @return [Telnyx::Models::MessagingTollfree::Verification::MessagingTollFreeVerificationVerificationRequestEgress]
           #
           # @see Telnyx::Models::MessagingTollfree::Verification::RequestCreateParams
           def create(params)
@@ -91,7 +91,7 @@ module Telnyx
               method: :post,
               path: "messaging_tollfree/verification/requests",
               body: parsed,
-              model: Telnyx::MessagingTollfree::Verification::VerificationRequestEgress,
+              model: Telnyx::MessagingTollfree::Verification::MessagingTollFreeVerificationVerificationRequestEgress,
               options: options
             )
           end
@@ -104,14 +104,14 @@ module Telnyx
           #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
-          # @return [Telnyx::Models::MessagingTollfree::Verification::VerificationRequestStatus]
+          # @return [Telnyx::Models::MessagingTollfree::Verification::RequestRetrieveResponse]
           #
           # @see Telnyx::Models::MessagingTollfree::Verification::RequestRetrieveParams
           def retrieve(id, params = {})
             @client.request(
               method: :get,
               path: ["messaging_tollfree/verification/requests/%1$s", id],
-              model: Telnyx::MessagingTollfree::Verification::VerificationRequestStatus,
+              model: Telnyx::Models::MessagingTollfree::Verification::RequestRetrieveResponse,
               options: params[:request_options]
             )
           end
@@ -177,7 +177,7 @@ module Telnyx
           #
           # @param doing_business_as [String, nil] Doing Business As (DBA) name if different from legal name
           #
-          # @param entity_type [Symbol, Telnyx::Models::MessagingTollfree::Verification::TollFreeVerificationEntityType, nil] Business entity classification
+          # @param entity_type [Symbol, Telnyx::Models::MessagingTollfree::Verification::MessagingTollFreeVerificationEntityType, nil] Business entity classification
           #
           # @param help_message_response [String, nil] The message returned when users text 'HELP'
           #
@@ -195,7 +195,7 @@ module Telnyx
           #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
-          # @return [Telnyx::Models::MessagingTollfree::Verification::VerificationRequestEgress]
+          # @return [Telnyx::Models::MessagingTollfree::Verification::MessagingTollFreeVerificationVerificationRequestEgress]
           #
           # @see Telnyx::Models::MessagingTollfree::Verification::RequestUpdateParams
           def update(id, params)
@@ -204,7 +204,7 @@ module Telnyx
               method: :patch,
               path: ["messaging_tollfree/verification/requests/%1$s", id],
               body: parsed,
-              model: Telnyx::MessagingTollfree::Verification::VerificationRequestEgress,
+              model: Telnyx::MessagingTollfree::Verification::MessagingTollFreeVerificationVerificationRequestEgress,
               options: options
             )
           end

data/lib/telnyx/resources/messaging_url_domains.rb

@@ -4,7 +4,8 @@ module Telnyx
   module Resources
     # Messaging URL Domains
     class MessagingURLDomains
-      # List messaging URL domains
+      # Returns the URL domains available to the authenticated account for message URL
+      # shortening.
       #
       # @overload list(page_number: nil, page_size: nil, request_options: {})
       #

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

@@ -4,7 +4,7 @@ module Telnyx
   module Resources
     class MobilePhoneNumbers
       class Messaging
-        # Retrieve a mobile phone number with messaging settings
+        # Returns the messaging configuration for the specified mobile phone number.
         #
         # @overload retrieve(id, request_options: {})
         #
@@ -24,7 +24,7 @@ module Telnyx
           )
         end
 
-        # List mobile phone numbers with messaging settings
+        # Returns mobile phone numbers with their current messaging configuration.
         #
         # @overload list(page_number: nil, page_size: nil, request_options: {})
         #

data/lib/telnyx/resources/mobile_phone_numbers.rb

@@ -7,7 +7,7 @@ module Telnyx
       # @return [Telnyx::Resources::MobilePhoneNumbers::Messaging]
       attr_reader :messaging
 
-      # Retrieve a Mobile Phone Number
+      # Retrieve the details of a specific mobile phone number.
       #
       # @overload retrieve(id, request_options: {})
       #
@@ -27,7 +27,7 @@ module Telnyx
         )
       end
 
-      # Update a Mobile Phone Number
+      # Update the settings of a specific mobile phone number.
       #
       # @overload update(id, call_forwarding: nil, call_recording: nil, caller_id_name_enabled: nil, cnam_listing: nil, connection_id: nil, customer_reference: nil, inbound: nil, inbound_call_screening: nil, noise_suppression: nil, outbound: nil, tags: nil, request_options: {})
       #
@@ -71,7 +71,7 @@ module Telnyx
         )
       end
 
-      # List Mobile Phone Numbers
+      # Retrieve a paginated list of mobile phone numbers on your account.
       #
       # @overload list(page_number: nil, page_size: nil, request_options: {})
       #

data/lib/telnyx/resources/mobile_voice_connections.rb

@@ -4,7 +4,7 @@ module Telnyx
   module Resources
     # Mobile voice connection operations
     class MobileVoiceConnections
-      # Create a Mobile Voice Connection
+      # Create a new mobile voice connection.
       #
       # @overload create(active: nil, connection_name: nil, inbound: nil, outbound: nil, tags: nil, webhook_api_version: nil, webhook_event_failover_url: nil, webhook_event_url: nil, webhook_timeout_secs: nil, request_options: {})
       #
@@ -33,7 +33,7 @@ module Telnyx
         )
       end
 
-      # Retrieve a Mobile Voice Connection
+      # Retrieve the details of a specific mobile voice connection.
       #
       # @overload retrieve(id, request_options: {})
       #
@@ -53,7 +53,7 @@ module Telnyx
         )
       end
 
-      # Update a Mobile Voice Connection
+      # Update the settings of a specific mobile voice connection.
       #
       # @overload update(id, active: nil, connection_name: nil, inbound: nil, outbound: nil, tags: nil, webhook_api_version: nil, webhook_event_failover_url: nil, webhook_event_url: nil, webhook_timeout_secs: nil, request_options: {})
       #
@@ -96,7 +96,7 @@ module Telnyx
       # Some parameter documentations has been truncated, see
       # {Telnyx::Models::MobileVoiceConnectionListParams} for more details.
       #
-      # List Mobile Voice Connections
+      # Retrieve a paginated list of mobile voice connections on your account.
       #
       # @overload list(filter_connection_name_contains: nil, page_number: nil, page_size: nil, sort: nil, request_options: {})
       #
@@ -130,7 +130,7 @@ module Telnyx
         )
       end
 
-      # Delete a Mobile Voice Connection
+      # Delete a mobile voice connection from your account.
       #
       # @overload delete(id, request_options: {})
       #

data/lib/telnyx/resources/number_order_phone_numbers.rb

@@ -49,7 +49,8 @@ module Telnyx
         )
       end
 
-      # Update requirement group for a phone number order
+      # Associates an existing requirement group with a phone number in a number order.
+      # The response contains the updated number-order phone-number details.
       #
       # @overload update_requirement_group(id, requirement_group_id:, request_options: {})
       #