telnyx 5.36.0 → 5.36.2

data/lib/telnyx/models/verify_profile_create_params.rb

@@ -27,6 +27,11 @@ module Telnyx
       #   @return [String, nil]
       optional :language, String
 
+      # @!attribute rcs
+      #
+      #   @return [Telnyx::Models::VerifyProfileCreateParams::Rcs, nil]
+      optional :rcs, -> { Telnyx::VerifyProfileCreateParams::Rcs }
+
       # @!attribute sms
       #
       #   @return [Telnyx::Models::VerifyProfileCreateParams::SMS, nil]
@@ -42,11 +47,12 @@ module Telnyx
       #   @return [String, nil]
       optional :webhook_url, String
 
-      # @!method initialize(name:, call: nil, flashcall: nil, language: nil, sms: nil, webhook_failover_url: nil, webhook_url: nil, request_options: {})
+      # @!method initialize(name:, call: nil, flashcall: nil, language: nil, rcs: nil, sms: nil, webhook_failover_url: nil, webhook_url: nil, request_options: {})
       #   @param name [String]
       #   @param call [Telnyx::Models::VerifyProfileCreateParams::Call]
       #   @param flashcall [Telnyx::Models::VerifyProfileCreateParams::Flashcall]
       #   @param language [String]
+      #   @param rcs [Telnyx::Models::VerifyProfileCreateParams::Rcs]
       #   @param sms [Telnyx::Models::VerifyProfileCreateParams::SMS]
       #   @param webhook_failover_url [String]
       #   @param webhook_url [String]
@@ -105,6 +111,13 @@ module Telnyx
       end
 
       class Flashcall < Telnyx::Internal::Type::BaseModel
+        # @!attribute app_name
+        #   The name that identifies the application requesting 2fa in the verification
+        #   message.
+        #
+        #   @return [String, nil]
+        optional :app_name, String
+
         # @!attribute default_verification_timeout_secs
         #   For every request that is initiated via this Verify profile, this sets the
         #   number of seconds before a verification request code expires. Once the
@@ -122,24 +135,78 @@ module Telnyx
         #   @return [Array<String>, nil]
         optional :whitelisted_destinations, Telnyx::Internal::Type::ArrayOf[String]
 
-        # @!method initialize(default_verification_timeout_secs: nil, whitelisted_destinations: nil)
+        # @!method initialize(app_name: nil, default_verification_timeout_secs: nil, whitelisted_destinations: nil)
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::VerifyProfileCreateParams::Flashcall} for more details.
         #
+        #   @param app_name [String] The name that identifies the application requesting 2fa in the verification mess
+        #
         #   @param default_verification_timeout_secs [Integer] For every request that is initiated via this Verify profile, this sets the numbe
         #
         #   @param whitelisted_destinations [Array<String>] Enabled country destinations to send verification codes. The elements in the lis
       end
 
-      class SMS < Telnyx::Internal::Type::BaseModel
+      class Rcs < Telnyx::Internal::Type::BaseModel
+        # @!attribute app_name
+        #   The name that identifies the application requesting 2fa in the verification
+        #   message.
+        #
+        #   @return [String, nil]
+        optional :app_name, String
+
+        # @!attribute code_length
+        #   The length of the verify code to generate.
+        #
+        #   @return [Integer, nil]
+        optional :code_length, Integer
+
+        # @!attribute default_verification_timeout_secs
+        #   For every request that is initiated via this Verify profile, this sets the
+        #   number of seconds before a verification request code expires. Once the
+        #   verification request expires, the user cannot use the code to verify their
+        #   identity.
+        #
+        #   @return [Integer, nil]
+        optional :default_verification_timeout_secs, Integer
+
+        # @!attribute messaging_template_id
+        #   The message template identifier selected from /verify_profiles/templates
+        #
+        #   @return [String, nil]
+        optional :messaging_template_id, String
+
+        # @!attribute sms_fallback
+        #   Enable SMS fallback when RCS delivery fails.
+        #
+        #   @return [Boolean, nil]
+        optional :sms_fallback, Telnyx::Internal::Type::Boolean
+
         # @!attribute whitelisted_destinations
         #   Enabled country destinations to send verification codes. The elements in the
         #   list must be valid ISO 3166-1 alpha-2 country codes. If set to `["*"]`, all
         #   destinations will be allowed.
         #
-        #   @return [Array<String>]
-        required :whitelisted_destinations, Telnyx::Internal::Type::ArrayOf[String]
+        #   @return [Array<String>, nil]
+        optional :whitelisted_destinations, Telnyx::Internal::Type::ArrayOf[String]
 
+        # @!method initialize(app_name: nil, code_length: nil, default_verification_timeout_secs: nil, messaging_template_id: nil, sms_fallback: nil, whitelisted_destinations: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::VerifyProfileCreateParams::Rcs} for more details.
+        #
+        #   @param app_name [String] The name that identifies the application requesting 2fa in the verification mess
+        #
+        #   @param code_length [Integer] The length of the verify code to generate.
+        #
+        #   @param default_verification_timeout_secs [Integer] For every request that is initiated via this Verify profile, this sets the numbe
+        #
+        #   @param messaging_template_id [String] The message template identifier selected from /verify_profiles/templates
+        #
+        #   @param sms_fallback [Boolean] Enable SMS fallback when RCS delivery fails.
+        #
+        #   @param whitelisted_destinations [Array<String>] Enabled country destinations to send verification codes. The elements in the lis
+      end
+
+      class SMS < Telnyx::Internal::Type::BaseModel
         # @!attribute alpha_sender
         #   The alphanumeric sender ID to use when sending to destinations that require an
         #   alphanumeric sender ID.
@@ -175,12 +242,18 @@ module Telnyx
         #   @return [String, nil]
         optional :messaging_template_id, String
 
-        # @!method initialize(whitelisted_destinations:, alpha_sender: nil, app_name: nil, code_length: nil, default_verification_timeout_secs: nil, messaging_template_id: nil)
+        # @!attribute whitelisted_destinations
+        #   Enabled country destinations to send verification codes. The elements in the
+        #   list must be valid ISO 3166-1 alpha-2 country codes. If set to `["*"]`, all
+        #   destinations will be allowed.
+        #
+        #   @return [Array<String>, nil]
+        optional :whitelisted_destinations, Telnyx::Internal::Type::ArrayOf[String]
+
+        # @!method initialize(alpha_sender: nil, app_name: nil, code_length: nil, default_verification_timeout_secs: nil, messaging_template_id: nil, whitelisted_destinations: nil)
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::VerifyProfileCreateParams::SMS} for more details.
         #
-        #   @param whitelisted_destinations [Array<String>] Enabled country destinations to send verification codes. The elements in the lis
-        #
         #   @param alpha_sender [String, nil] The alphanumeric sender ID to use when sending to destinations that require an a
         #
         #   @param app_name [String] The name that identifies the application requesting 2fa in the verification mess
@@ -190,6 +263,8 @@ module Telnyx
         #   @param default_verification_timeout_secs [Integer] For every request that is initiated via this Verify profile, this sets the numbe
         #
         #   @param messaging_template_id [String] The message template identifier selected from /verify_profiles/templates
+        #
+        #   @param whitelisted_destinations [Array<String>] Enabled country destinations to send verification codes. The elements in the lis
       end
     end
   end

data/lib/telnyx/models/verify_profile_update_params.rb

@@ -27,6 +27,11 @@ module Telnyx
       #   @return [String, nil]
       optional :name, String
 
+      # @!attribute rcs
+      #
+      #   @return [Telnyx::Models::VerifyProfileUpdateParams::Rcs, nil]
+      optional :rcs, -> { Telnyx::VerifyProfileUpdateParams::Rcs }
+
       # @!attribute sms
       #
       #   @return [Telnyx::Models::VerifyProfileUpdateParams::SMS, nil]
@@ -42,11 +47,12 @@ module Telnyx
       #   @return [String, nil]
       optional :webhook_url, String
 
-      # @!method initialize(call: nil, flashcall: nil, language: nil, name: nil, sms: nil, webhook_failover_url: nil, webhook_url: nil, request_options: {})
+      # @!method initialize(call: nil, flashcall: nil, language: nil, name: nil, rcs: nil, sms: nil, webhook_failover_url: nil, webhook_url: nil, request_options: {})
       #   @param call [Telnyx::Models::VerifyProfileUpdateParams::Call]
       #   @param flashcall [Telnyx::Models::VerifyProfileUpdateParams::Flashcall]
       #   @param language [String]
       #   @param name [String]
+      #   @param rcs [Telnyx::Models::VerifyProfileUpdateParams::Rcs]
       #   @param sms [Telnyx::Models::VerifyProfileUpdateParams::SMS]
       #   @param webhook_failover_url [String]
       #   @param webhook_url [String]
@@ -105,6 +111,13 @@ module Telnyx
       end
 
       class Flashcall < Telnyx::Internal::Type::BaseModel
+        # @!attribute app_name
+        #   The name that identifies the application requesting 2fa in the verification
+        #   message.
+        #
+        #   @return [String, nil]
+        optional :app_name, String
+
         # @!attribute default_verification_timeout_secs
         #   For every request that is initiated via this Verify profile, this sets the
         #   number of seconds before a verification request code expires. Once the
@@ -122,15 +135,77 @@ module Telnyx
         #   @return [Array<String>, nil]
         optional :whitelisted_destinations, Telnyx::Internal::Type::ArrayOf[String]
 
-        # @!method initialize(default_verification_timeout_secs: nil, whitelisted_destinations: nil)
+        # @!method initialize(app_name: nil, default_verification_timeout_secs: nil, whitelisted_destinations: nil)
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::VerifyProfileUpdateParams::Flashcall} for more details.
         #
+        #   @param app_name [String] The name that identifies the application requesting 2fa in the verification mess
+        #
         #   @param default_verification_timeout_secs [Integer] For every request that is initiated via this Verify profile, this sets the numbe
         #
         #   @param whitelisted_destinations [Array<String>] Enabled country destinations to send verification codes. The elements in the lis
       end
 
+      class Rcs < Telnyx::Internal::Type::BaseModel
+        # @!attribute app_name
+        #   The name that identifies the application requesting 2fa in the verification
+        #   message.
+        #
+        #   @return [String, nil]
+        optional :app_name, String
+
+        # @!attribute code_length
+        #   The length of the verify code to generate.
+        #
+        #   @return [Integer, nil]
+        optional :code_length, Integer
+
+        # @!attribute default_verification_timeout_secs
+        #   For every request that is initiated via this Verify profile, this sets the
+        #   number of seconds before a verification request code expires. Once the
+        #   verification request expires, the user cannot use the code to verify their
+        #   identity.
+        #
+        #   @return [Integer, nil]
+        optional :default_verification_timeout_secs, Integer
+
+        # @!attribute messaging_template_id
+        #   The message template identifier selected from /verify_profiles/templates
+        #
+        #   @return [String, nil]
+        optional :messaging_template_id, String
+
+        # @!attribute sms_fallback
+        #   Enable SMS fallback when RCS delivery fails.
+        #
+        #   @return [Boolean, nil]
+        optional :sms_fallback, Telnyx::Internal::Type::Boolean
+
+        # @!attribute whitelisted_destinations
+        #   Enabled country destinations to send verification codes. The elements in the
+        #   list must be valid ISO 3166-1 alpha-2 country codes. If set to `["*"]`, all
+        #   destinations will be allowed.
+        #
+        #   @return [Array<String>, nil]
+        optional :whitelisted_destinations, Telnyx::Internal::Type::ArrayOf[String]
+
+        # @!method initialize(app_name: nil, code_length: nil, default_verification_timeout_secs: nil, messaging_template_id: nil, sms_fallback: nil, whitelisted_destinations: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::VerifyProfileUpdateParams::Rcs} for more details.
+        #
+        #   @param app_name [String] The name that identifies the application requesting 2fa in the verification mess
+        #
+        #   @param code_length [Integer] The length of the verify code to generate.
+        #
+        #   @param default_verification_timeout_secs [Integer] For every request that is initiated via this Verify profile, this sets the numbe
+        #
+        #   @param messaging_template_id [String] The message template identifier selected from /verify_profiles/templates
+        #
+        #   @param sms_fallback [Boolean] Enable SMS fallback when RCS delivery fails.
+        #
+        #   @param whitelisted_destinations [Array<String>] Enabled country destinations to send verification codes. The elements in the lis
+      end
+
       class SMS < Telnyx::Internal::Type::BaseModel
         # @!attribute alpha_sender
         #   The alphanumeric sender ID to use when sending to destinations that require an

data/lib/telnyx/models.rb

@@ -87,6 +87,14 @@ module Telnyx
 
   AISummarizeParams = Telnyx::Models::AISummarizeParams
 
+  AlphanumericSenderIDCreateParams = Telnyx::Models::AlphanumericSenderIDCreateParams
+
+  AlphanumericSenderIDDeleteParams = Telnyx::Models::AlphanumericSenderIDDeleteParams
+
+  AlphanumericSenderIDListParams = Telnyx::Models::AlphanumericSenderIDListParams
+
+  AlphanumericSenderIDRetrieveParams = Telnyx::Models::AlphanumericSenderIDRetrieveParams
+
   AnchorsiteOverride = Telnyx::Models::AnchorsiteOverride
 
   APIError = Telnyx::Models::APIError
@@ -750,6 +758,8 @@ module Telnyx
 
   MessageCancelScheduledParams = Telnyx::Models::MessageCancelScheduledParams
 
+  MessageRetrieveGroupMessagesParams = Telnyx::Models::MessageRetrieveGroupMessagesParams
+
   MessageRetrieveParams = Telnyx::Models::MessageRetrieveParams
 
   Messages = Telnyx::Models::Messages
@@ -768,6 +778,8 @@ module Telnyx
 
   MessageSendWhatsappParams = Telnyx::Models::MessageSendWhatsappParams
 
+  MessageSendWithAlphanumericSenderParams = Telnyx::Models::MessageSendWithAlphanumericSenderParams
+
   MessageTemplate = Telnyx::Models::MessageTemplate
 
   Messaging = Telnyx::Models::Messaging
@@ -782,6 +794,8 @@ module Telnyx
 
   MessagingHostedNumberDeleteParams = Telnyx::Models::MessagingHostedNumberDeleteParams
 
+  MessagingHostedNumberListParams = Telnyx::Models::MessagingHostedNumberListParams
+
   MessagingHostedNumberOrder = Telnyx::Models::MessagingHostedNumberOrder
 
   MessagingHostedNumberOrderCheckEligibilityParams =
@@ -803,6 +817,10 @@ module Telnyx
   MessagingHostedNumberOrderValidateCodesParams =
     Telnyx::Models::MessagingHostedNumberOrderValidateCodesParams
 
+  MessagingHostedNumberRetrieveParams = Telnyx::Models::MessagingHostedNumberRetrieveParams
+
+  MessagingHostedNumberUpdateParams = Telnyx::Models::MessagingHostedNumberUpdateParams
+
   MessagingNumbersBulkUpdateCreateParams = Telnyx::Models::MessagingNumbersBulkUpdateCreateParams
 
   MessagingNumbersBulkUpdateRetrieveParams = Telnyx::Models::MessagingNumbersBulkUpdateRetrieveParams
@@ -817,12 +835,19 @@ module Telnyx
 
   MessagingProfileDeleteParams = Telnyx::Models::MessagingProfileDeleteParams
 
+  MessagingProfileListAlphanumericSenderIDsParams =
+    Telnyx::Models::MessagingProfileListAlphanumericSenderIDsParams
+
   MessagingProfileListParams = Telnyx::Models::MessagingProfileListParams
 
   MessagingProfileListPhoneNumbersParams = Telnyx::Models::MessagingProfileListPhoneNumbersParams
 
   MessagingProfileListShortCodesParams = Telnyx::Models::MessagingProfileListShortCodesParams
 
+  MessagingProfileMetricListParams = Telnyx::Models::MessagingProfileMetricListParams
+
+  MessagingProfileRetrieveMetricsParams = Telnyx::Models::MessagingProfileRetrieveMetricsParams
+
   MessagingProfileRetrieveParams = Telnyx::Models::MessagingProfileRetrieveParams
 
   MessagingProfiles = Telnyx::Models::MessagingProfiles

data/lib/telnyx/resources/alphanumeric_sender_ids.rb

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class AlphanumericSenderIDs
+      # Create a new alphanumeric sender ID associated with a messaging profile.
+      #
+      # @overload create(alphanumeric_sender_id:, messaging_profile_id:, us_long_code_fallback: nil, request_options: {})
+      #
+      # @param alphanumeric_sender_id [String] The alphanumeric sender ID string.
+      #
+      # @param messaging_profile_id [String] The messaging profile to associate the sender ID with.
+      #
+      # @param us_long_code_fallback [String] A US long code number to use as fallback when sending to US destinations.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::AlphanumericSenderIDCreateResponse]
+      #
+      # @see Telnyx::Models::AlphanumericSenderIDCreateParams
+      def create(params)
+        parsed, options = Telnyx::AlphanumericSenderIDCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "alphanumeric_sender_ids",
+          body: parsed,
+          model: Telnyx::Models::AlphanumericSenderIDCreateResponse,
+          options: options
+        )
+      end
+
+      # Retrieve a specific alphanumeric sender ID.
+      #
+      # @overload retrieve(id, request_options: {})
+      #
+      # @param id [String] The identifier of the alphanumeric sender ID.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::AlphanumericSenderIDRetrieveResponse]
+      #
+      # @see Telnyx::Models::AlphanumericSenderIDRetrieveParams
+      def retrieve(id, params = {})
+        @client.request(
+          method: :get,
+          path: ["alphanumeric_sender_ids/%1$s", id],
+          model: Telnyx::Models::AlphanumericSenderIDRetrieveResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # List all alphanumeric sender IDs for the authenticated user.
+      #
+      # @overload list(filter_messaging_profile_id: nil, page_number: nil, page_size: nil, request_options: {})
+      #
+      # @param filter_messaging_profile_id [String] Filter by messaging profile ID.
+      #
+      # @param page_number [Integer] Page number.
+      #
+      # @param page_size [Integer] Page size.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::AlphanumericSenderIDListResponse>]
+      #
+      # @see Telnyx::Models::AlphanumericSenderIDListParams
+      def list(params = {})
+        parsed, options = Telnyx::AlphanumericSenderIDListParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: "alphanumeric_sender_ids",
+          query: parsed.transform_keys(
+            filter_messaging_profile_id: "filter[messaging_profile_id]",
+            page_number: "page[number]",
+            page_size: "page[size]"
+          ),
+          page: Telnyx::Internal::DefaultFlatPagination,
+          model: Telnyx::Models::AlphanumericSenderIDListResponse,
+          options: options
+        )
+      end
+
+      # Delete an alphanumeric sender ID and disassociate it from its messaging profile.
+      #
+      # @overload delete(id, request_options: {})
+      #
+      # @param id [String] The identifier of the alphanumeric sender ID.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::AlphanumericSenderIDDeleteResponse]
+      #
+      # @see Telnyx::Models::AlphanumericSenderIDDeleteParams
+      def delete(id, params = {})
+        @client.request(
+          method: :delete,
+          path: ["alphanumeric_sender_ids/%1$s", id],
+          model: Telnyx::Models::AlphanumericSenderIDDeleteResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Telnyx::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/telnyx/resources/messages.rb

@@ -50,6 +50,26 @@ module Telnyx
         )
       end
 
+      # Retrieve all messages in a group MMS conversation by the group message ID.
+      #
+      # @overload retrieve_group_messages(message_id, request_options: {})
+      #
+      # @param message_id [String] The group message ID.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::MessageRetrieveGroupMessagesResponse]
+      #
+      # @see Telnyx::Models::MessageRetrieveGroupMessagesParams
+      def retrieve_group_messages(message_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["messages/group/%1$s", message_id],
+          model: Telnyx::Models::MessageRetrieveGroupMessagesResponse,
+          options: params[:request_options]
+        )
+      end
+
       # Some parameter documentations has been truncated, see
       # {Telnyx::Models::MessageScheduleParams} for more details.
       #
@@ -360,6 +380,40 @@ module Telnyx
         )
       end
 
+      # Send an SMS message using an alphanumeric sender ID. This is SMS only.
+      #
+      # @overload send_with_alphanumeric_sender(from:, messaging_profile_id:, text:, to:, use_profile_webhooks: nil, webhook_failover_url: nil, webhook_url: nil, request_options: {})
+      #
+      # @param from [String] A valid alphanumeric sender ID on the user's account.
+      #
+      # @param messaging_profile_id [String] The messaging profile ID to use.
+      #
+      # @param text [String] The message body.
+      #
+      # @param to [String] Receiving address (+E.164 formatted phone number).
+      #
+      # @param use_profile_webhooks [Boolean] If true, use the messaging profile's webhook settings.
+      #
+      # @param webhook_failover_url [String, nil] Failover callback URL for delivery status updates.
+      #
+      # @param webhook_url [String, nil] Callback URL for delivery status updates.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::MessageSendWithAlphanumericSenderResponse]
+      #
+      # @see Telnyx::Models::MessageSendWithAlphanumericSenderParams
+      def send_with_alphanumeric_sender(params)
+        parsed, options = Telnyx::MessageSendWithAlphanumericSenderParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "messages/alphanumeric_sender_id",
+          body: parsed,
+          model: Telnyx::Models::MessageSendWithAlphanumericSenderResponse,
+          options: options
+        )
+      end
+
       # @api private
       #
       # @param client [Telnyx::Client]

data/lib/telnyx/resources/messaging_hosted_numbers.rb

@@ -3,6 +3,97 @@
 module Telnyx
   module Resources
     class MessagingHostedNumbers
+      # Retrieve a specific messaging hosted number by its ID or phone number.
+      #
+      # @overload retrieve(id, request_options: {})
+      #
+      # @param id [String] The ID or phone number of the hosted number.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::MessagingHostedNumberRetrieveResponse]
+      #
+      # @see Telnyx::Models::MessagingHostedNumberRetrieveParams
+      def retrieve(id, params = {})
+        @client.request(
+          method: :get,
+          path: ["messaging_hosted_numbers/%1$s", id],
+          model: Telnyx::Models::MessagingHostedNumberRetrieveResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Telnyx::Models::MessagingHostedNumberUpdateParams} for more details.
+      #
+      # Update the messaging settings for a hosted number.
+      #
+      # @overload update(id, messaging_product: nil, messaging_profile_id: nil, tags: nil, request_options: {})
+      #
+      # @param id [String] The ID or phone number of the hosted number.
+      #
+      # @param messaging_product [String] Configure the messaging product for this number:
+      #
+      # @param messaging_profile_id [String] Configure the messaging profile this phone number is assigned to:
+      #
+      # @param tags [Array<String>] Tags to set on this phone number.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::MessagingHostedNumberUpdateResponse]
+      #
+      # @see Telnyx::Models::MessagingHostedNumberUpdateParams
+      def update(id, params = {})
+        parsed, options = Telnyx::MessagingHostedNumberUpdateParams.dump_request(params)
+        @client.request(
+          method: :patch,
+          path: ["messaging_hosted_numbers/%1$s", id],
+          body: parsed,
+          model: Telnyx::Models::MessagingHostedNumberUpdateResponse,
+          options: options
+        )
+      end
+
+      # List all hosted numbers associated with the authenticated user.
+      #
+      # @overload list(filter_messaging_profile_id: nil, filter_phone_number: nil, filter_phone_number_contains: nil, page_number: nil, page_size: nil, sort_phone_number: nil, request_options: {})
+      #
+      # @param filter_messaging_profile_id [String] Filter by messaging profile ID.
+      #
+      # @param filter_phone_number [String] Filter by exact phone number.
+      #
+      # @param filter_phone_number_contains [String] Filter by phone number substring.
+      #
+      # @param page_number [Integer]
+      #
+      # @param page_size [Integer]
+      #
+      # @param sort_phone_number [Symbol, Telnyx::Models::MessagingHostedNumberListParams::SortPhoneNumber] Sort by phone number.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::PhoneNumberWithMessagingSettings>]
+      #
+      # @see Telnyx::Models::MessagingHostedNumberListParams
+      def list(params = {})
+        parsed, options = Telnyx::MessagingHostedNumberListParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: "messaging_hosted_numbers",
+          query: parsed.transform_keys(
+            filter_messaging_profile_id: "filter[messaging_profile_id]",
+            filter_phone_number: "filter[phone_number]",
+            filter_phone_number_contains: "filter[phone_number][contains]",
+            page_number: "page[number]",
+            page_size: "page[size]",
+            sort_phone_number: "sort[phone_number]"
+          ),
+          page: Telnyx::Internal::DefaultFlatPagination,
+          model: Telnyx::PhoneNumberWithMessagingSettings,
+          options: options
+        )
+      end
+
       # Delete a messaging hosted number
       #
       # @overload delete(id, request_options: {})

data/lib/telnyx/resources/messaging_numbers_bulk_updates.rb

@@ -8,12 +8,14 @@ module Telnyx
       #
       # Bulk update phone number profiles
       #
-      # @overload create(messaging_profile_id:, numbers:, request_options: {})
+      # @overload create(messaging_profile_id:, numbers:, assign_only: nil, request_options: {})
       #
       # @param messaging_profile_id [String] Configure the messaging profile these phone numbers are assigned to:
       #
       # @param numbers [Array<String>] The list of phone numbers to update.
       #
+      # @param assign_only [Boolean] If true, only assign numbers to the profile without changing other settings.
+      #
       # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Telnyx::Models::MessagingNumbersBulkUpdateCreateResponse]

data/lib/telnyx/resources/messaging_profile_metrics.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class MessagingProfileMetrics
+      # List high-level metrics for all messaging profiles belonging to the
+      # authenticated user.
+      #
+      # @overload list(time_frame: nil, request_options: {})
+      #
+      # @param time_frame [Symbol, Telnyx::Models::MessagingProfileMetricListParams::TimeFrame] The time frame for metrics.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::MessagingProfileMetricListResponse]
+      #
+      # @see Telnyx::Models::MessagingProfileMetricListParams
+      def list(params = {})
+        parsed, options = Telnyx::MessagingProfileMetricListParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: "messaging_profile_metrics",
+          query: parsed,
+          model: Telnyx::Models::MessagingProfileMetricListResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Telnyx::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end