telnyx 5.0.0 → 5.1.0

data/lib/telnyx/models/messaging_profile_update_params.rb

@@ -67,6 +67,14 @@ module Telnyx
       #   @return [Telnyx::Models::NumberPoolSettings, nil]
       optional :number_pool_settings, -> { Telnyx::NumberPoolSettings }, nil?: true
 
+      # @!attribute smart_encoding
+      #   Enables automatic character encoding optimization for SMS messages. When
+      #   enabled, the system automatically selects the most efficient encoding (GSM-7 or
+      #   UCS-2) based on message content to maximize character limits and minimize costs.
+      #
+      #   @return [Boolean, nil]
+      optional :smart_encoding, Telnyx::Internal::Type::Boolean
+
       # @!attribute url_shortener_settings
       #   The URL shortener feature allows automatic replacement of URLs that were
       #   generated using a public URL shortener service. Some examples include bit.do,
@@ -115,7 +123,7 @@ module Telnyx
       #   @return [Array<String>, nil]
       optional :whitelisted_destinations, Telnyx::Internal::Type::ArrayOf[String]
 
-      # @!method initialize(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, url_shortener_settings: nil, v1_secret: nil, webhook_api_version: nil, webhook_failover_url: nil, webhook_url: nil, whitelisted_destinations: nil, request_options: {})
+      # @!method initialize(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: {})
       #   Some parameter documentations has been truncated, see
       #   {Telnyx::Models::MessagingProfileUpdateParams} for more details.
       #
@@ -137,6 +145,8 @@ module Telnyx
       #
       #   @param number_pool_settings [Telnyx::Models::NumberPoolSettings, nil] Number Pool allows you to send messages from a pool of numbers of different type
       #
+      #   @param smart_encoding [Boolean] Enables automatic character encoding optimization for SMS messages. When enabled
+      #
       #   @param url_shortener_settings [Telnyx::Models::URLShortenerSettings, nil] The URL shortener feature allows automatic replacement of URLs that were generat
       #
       #   @param v1_secret [String] Secret used to authenticate with v1 endpoints.

data/lib/telnyx/models/messaging_tollfree/verification/tf_verification_request.rb

@@ -167,6 +167,17 @@ module Telnyx
           #   @return [String, nil]
           optional :business_registration_type, String, api_name: :businessRegistrationType, nil?: true
 
+          # @!attribute campaign_verify_authorization_token
+          #   Campaign Verify Authorization Token required for Political use case submissions
+          #   starting February 17, 2026. This token is validated by Zipwhip and must be
+          #   provided for all Political use case verifications after the deadline.
+          #
+          #   @return [String, nil]
+          optional :campaign_verify_authorization_token,
+                   String,
+                   api_name: :campaignVerifyAuthorizationToken,
+                   nil?: true
+
           # @!attribute doing_business_as
           #   Doing Business As (DBA) name if different from legal name
           #
@@ -220,7 +231,7 @@ module Telnyx
           #   @return [String, nil]
           optional :webhook_url, String, api_name: :webhookUrl
 
-          # @!method initialize(additional_information:, business_addr1:, business_city:, business_contact_email:, business_contact_first_name:, business_contact_last_name:, business_contact_phone:, business_name:, business_state:, business_zip:, corporate_website:, isv_reseller:, message_volume:, opt_in_workflow:, opt_in_workflow_image_urls:, phone_numbers:, production_message_content:, use_case:, use_case_summary:, age_gated_content: nil, business_addr2: nil, business_registration_country: nil, business_registration_number: nil, business_registration_type: nil, doing_business_as: nil, entity_type: nil, help_message_response: nil, opt_in_confirmation_response: nil, opt_in_keywords: nil, privacy_policy_url: nil, terms_and_condition_url: nil, webhook_url: nil)
+          # @!method initialize(additional_information:, business_addr1:, business_city:, business_contact_email:, business_contact_first_name:, business_contact_last_name:, business_contact_phone:, business_name:, business_state:, business_zip:, corporate_website:, isv_reseller:, message_volume:, opt_in_workflow:, opt_in_workflow_image_urls:, phone_numbers:, production_message_content:, use_case:, use_case_summary:, age_gated_content: nil, business_addr2: nil, business_registration_country: nil, business_registration_number: nil, business_registration_type: nil, campaign_verify_authorization_token: nil, doing_business_as: nil, entity_type: nil, help_message_response: nil, opt_in_confirmation_response: nil, opt_in_keywords: nil, privacy_policy_url: nil, terms_and_condition_url: nil, webhook_url: nil)
           #   Some parameter documentations has been truncated, see
           #   {Telnyx::Models::MessagingTollfree::Verification::TfVerificationRequest} for
           #   more details.
@@ -275,6 +286,8 @@ module Telnyx
           #
           #   @param business_registration_type [String, nil] Type of business registration being provided. Required from January 2026.
           #
+          #   @param campaign_verify_authorization_token [String, nil] Campaign Verify Authorization Token required for Political use case submissions
+          #
           #   @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

data/lib/telnyx/models/messaging_tollfree/verification/verification_request_egress.rb

@@ -148,6 +148,16 @@ module Telnyx
           #   @return [String, nil]
           optional :business_registration_type, String, api_name: :businessRegistrationType
 
+          # @!attribute campaign_verify_authorization_token
+          #   Campaign Verify Authorization Token required for Political use case submissions
+          #   starting February 17, 2026
+          #
+          #   @return [String, nil]
+          optional :campaign_verify_authorization_token,
+                   String,
+                   api_name: :campaignVerifyAuthorizationToken,
+                   nil?: true
+
           # @!attribute doing_business_as
           #
           #   @return [String, nil]
@@ -199,7 +209,11 @@ module Telnyx
           #   @return [String, nil]
           optional :webhook_url, String, api_name: :webhookUrl
 
-          # @!method initialize(id:, additional_information:, business_addr1:, business_city:, business_contact_email:, business_contact_first_name:, business_contact_last_name:, business_contact_phone:, business_name:, business_state:, business_zip:, corporate_website:, isv_reseller:, message_volume:, opt_in_workflow:, opt_in_workflow_image_urls:, phone_numbers:, production_message_content:, use_case:, use_case_summary:, verification_request_id:, age_gated_content: nil, business_addr2: nil, business_registration_country: nil, business_registration_number: nil, business_registration_type: nil, doing_business_as: nil, entity_type: nil, help_message_response: nil, opt_in_confirmation_response: nil, opt_in_keywords: nil, privacy_policy_url: nil, terms_and_condition_url: nil, verification_status: nil, webhook_url: nil)
+          # @!method initialize(id:, additional_information:, business_addr1:, business_city:, business_contact_email:, business_contact_first_name:, business_contact_last_name:, business_contact_phone:, business_name:, business_state:, business_zip:, corporate_website:, isv_reseller:, message_volume:, opt_in_workflow:, opt_in_workflow_image_urls:, phone_numbers:, production_message_content:, use_case:, use_case_summary:, verification_request_id:, age_gated_content: nil, business_addr2: nil, business_registration_country: nil, business_registration_number: nil, business_registration_type: nil, campaign_verify_authorization_token: nil, doing_business_as: nil, entity_type: nil, help_message_response: nil, opt_in_confirmation_response: nil, opt_in_keywords: nil, privacy_policy_url: nil, terms_and_condition_url: nil, verification_status: nil, webhook_url: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::MessagingTollfree::Verification::VerificationRequestEgress} for
+          #   more details.
+          #
           #   A verification request as it comes out of the database
           #
           #   @param id [String]
@@ -254,6 +268,8 @@ module Telnyx
           #
           #   @param business_registration_type [String]
           #
+          #   @param campaign_verify_authorization_token [String, nil] Campaign Verify Authorization Token required for Political use case submissions
+          #
           #   @param doing_business_as [String]
           #
           #   @param entity_type [Symbol, Telnyx::Models::MessagingTollfree::Verification::TollFreeVerificationEntityType] Business entity classification

data/lib/telnyx/models/messaging_tollfree/verification/verification_request_status.rb

@@ -151,6 +151,16 @@ module Telnyx
           #   @return [String, nil]
           optional :business_registration_type, String, api_name: :businessRegistrationType
 
+          # @!attribute campaign_verify_authorization_token
+          #   Campaign Verify Authorization Token required for Political use case submissions
+          #   starting February 17, 2026
+          #
+          #   @return [String, nil]
+          optional :campaign_verify_authorization_token,
+                   String,
+                   api_name: :campaignVerifyAuthorizationToken,
+                   nil?: true
+
           # @!attribute created_at
           #
           #   @return [Time, nil]
@@ -209,7 +219,11 @@ module Telnyx
           #   @return [String, nil]
           optional :webhook_url, String, api_name: :webhookUrl
 
-          # @!method initialize(id:, additional_information:, business_addr1:, business_city:, business_contact_email:, business_contact_first_name:, business_contact_last_name:, business_contact_phone:, business_name:, business_state:, business_zip:, corporate_website:, isv_reseller:, message_volume:, opt_in_workflow:, opt_in_workflow_image_urls:, phone_numbers:, production_message_content:, use_case:, use_case_summary:, verification_status:, age_gated_content: nil, business_addr2: nil, business_registration_country: nil, business_registration_number: nil, business_registration_type: nil, created_at: nil, doing_business_as: nil, entity_type: nil, help_message_response: nil, opt_in_confirmation_response: nil, opt_in_keywords: nil, privacy_policy_url: nil, reason: nil, terms_and_condition_url: nil, updated_at: nil, webhook_url: nil)
+          # @!method initialize(id:, additional_information:, business_addr1:, business_city:, business_contact_email:, business_contact_first_name:, business_contact_last_name:, business_contact_phone:, business_name:, business_state:, business_zip:, corporate_website:, isv_reseller:, message_volume:, opt_in_workflow:, opt_in_workflow_image_urls:, phone_numbers:, production_message_content:, use_case:, use_case_summary:, verification_status:, age_gated_content: nil, business_addr2: nil, business_registration_country: nil, business_registration_number: nil, business_registration_type: nil, campaign_verify_authorization_token: nil, created_at: nil, doing_business_as: nil, entity_type: nil, help_message_response: nil, opt_in_confirmation_response: nil, opt_in_keywords: nil, privacy_policy_url: nil, reason: nil, terms_and_condition_url: nil, updated_at: nil, webhook_url: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::MessagingTollfree::Verification::VerificationRequestStatus} for
+          #   more details.
+          #
           #   A verification request and its status, suitable for returning to users
           #
           #   @param id [String]
@@ -264,6 +278,8 @@ module Telnyx
           #
           #   @param business_registration_type [String]
           #
+          #   @param campaign_verify_authorization_token [String, nil] Campaign Verify Authorization Token required for Political use case submissions
+          #
           #   @param created_at [Time]
           #
           #   @param doing_business_as [String]

data/lib/telnyx/models/organizations/user_get_groups_report_params.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Organizations
+      # @see Telnyx::Resources::Organizations::Users#get_groups_report
+      class UserGetGroupsReportParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        # @!attribute accept
+        #
+        #   @return [Symbol, Telnyx::Models::Organizations::UserGetGroupsReportParams::Accept, nil]
+        optional :accept, enum: -> { Telnyx::Organizations::UserGetGroupsReportParams::Accept }
+
+        # @!method initialize(accept: nil, request_options: {})
+        #   @param accept [Symbol, Telnyx::Models::Organizations::UserGetGroupsReportParams::Accept]
+        #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+
+        module Accept
+          extend Telnyx::Internal::Type::Enum
+
+          APPLICATION_JSON = :"application/json"
+          TEXT_CSV = :"text/csv"
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/organizations/user_get_groups_report_response.rb

@@ -0,0 +1,132 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Organizations
+      # @see Telnyx::Resources::Organizations::Users#get_groups_report
+      class UserGetGroupsReportResponse < Telnyx::Internal::Type::BaseModel
+        # @!attribute data
+        #
+        #   @return [Array<Telnyx::Models::Organizations::UserGetGroupsReportResponse::Data>, nil]
+        optional :data,
+                 -> { Telnyx::Internal::Type::ArrayOf[Telnyx::Models::Organizations::UserGetGroupsReportResponse::Data] }
+
+        # @!method initialize(data: nil)
+        #   @param data [Array<Telnyx::Models::Organizations::UserGetGroupsReportResponse::Data>]
+
+        class Data < Telnyx::Internal::Type::BaseModel
+          # @!attribute id
+          #   Identifies the specific resource.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute created_at
+          #   ISO 8601 formatted date indicating when the resource was created.
+          #
+          #   @return [String]
+          required :created_at, String
+
+          # @!attribute email
+          #   The email address of the user.
+          #
+          #   @return [String]
+          required :email, String
+
+          # @!attribute groups
+          #   The groups the user belongs to.
+          #
+          #   @return [Array<Telnyx::Models::Organizations::UserGetGroupsReportResponse::Data::Group>]
+          required :groups,
+                   -> { Telnyx::Internal::Type::ArrayOf[Telnyx::Models::Organizations::UserGetGroupsReportResponse::Data::Group] }
+
+          # @!attribute record_type
+          #   Identifies the type of the resource. Can be 'organization_owner' or
+          #   'organization_sub_user'.
+          #
+          #   @return [String]
+          required :record_type, String
+
+          # @!attribute user_status
+          #   The status of the account.
+          #
+          #   @return [Symbol, Telnyx::Models::Organizations::UserGetGroupsReportResponse::Data::UserStatus]
+          required :user_status,
+                   enum: -> { Telnyx::Models::Organizations::UserGetGroupsReportResponse::Data::UserStatus }
+
+          # @!attribute last_sign_in_at
+          #   ISO 8601 formatted date indicating when the resource last signed into the
+          #   portal. Null if the user has never signed in.
+          #
+          #   @return [String, nil]
+          optional :last_sign_in_at, String, nil?: true
+
+          # @!attribute organization_user_bypasses_sso
+          #   Indicates whether this user is allowed to bypass SSO and use password
+          #   authentication.
+          #
+          #   @return [Boolean, nil]
+          optional :organization_user_bypasses_sso, Telnyx::Internal::Type::Boolean
+
+          # @!method initialize(id:, created_at:, email:, groups:, record_type:, user_status:, last_sign_in_at: nil, organization_user_bypasses_sso: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::Organizations::UserGetGroupsReportResponse::Data} for more
+          #   details.
+          #
+          #   An organization user with their group memberships always included.
+          #
+          #   @param id [String] Identifies the specific resource.
+          #
+          #   @param created_at [String] ISO 8601 formatted date indicating when the resource was created.
+          #
+          #   @param email [String] The email address of the user.
+          #
+          #   @param groups [Array<Telnyx::Models::Organizations::UserGetGroupsReportResponse::Data::Group>] The groups the user belongs to.
+          #
+          #   @param record_type [String] Identifies the type of the resource. Can be 'organization_owner' or 'organizatio
+          #
+          #   @param user_status [Symbol, Telnyx::Models::Organizations::UserGetGroupsReportResponse::Data::UserStatus] The status of the account.
+          #
+          #   @param last_sign_in_at [String, nil] ISO 8601 formatted date indicating when the resource last signed into the portal
+          #
+          #   @param organization_user_bypasses_sso [Boolean] Indicates whether this user is allowed to bypass SSO and use password authentica
+
+          class Group < Telnyx::Internal::Type::BaseModel
+            # @!attribute id
+            #   The unique identifier of the group.
+            #
+            #   @return [String]
+            required :id, String
+
+            # @!attribute name
+            #   The name of the group.
+            #
+            #   @return [String]
+            required :name, String
+
+            # @!method initialize(id:, name:)
+            #   A reference to a group that a user belongs to.
+            #
+            #   @param id [String] The unique identifier of the group.
+            #
+            #   @param name [String] The name of the group.
+          end
+
+          # The status of the account.
+          #
+          # @see Telnyx::Models::Organizations::UserGetGroupsReportResponse::Data#user_status
+          module UserStatus
+            extend Telnyx::Internal::Type::Enum
+
+            ENABLED = :enabled
+            DISABLED = :disabled
+            BLOCKED = :blocked
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/organizations/user_list_params.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Organizations
+      # @see Telnyx::Resources::Organizations::Users#list
+      class UserListParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        # @!attribute filter_email
+        #   Filter by email address (partial match)
+        #
+        #   @return [String, nil]
+        optional :filter_email, String
+
+        # @!attribute filter_user_status
+        #   Filter by user status
+        #
+        #   @return [Symbol, Telnyx::Models::Organizations::UserListParams::FilterUserStatus, nil]
+        optional :filter_user_status, enum: -> { Telnyx::Organizations::UserListParams::FilterUserStatus }
+
+        # @!attribute include_groups
+        #   When set to true, includes the groups array for each user in the response. The
+        #   groups array contains objects with id and name for each group the user belongs
+        #   to.
+        #
+        #   @return [Boolean, nil]
+        optional :include_groups, Telnyx::Internal::Type::Boolean
+
+        # @!attribute page_number
+        #   The page number to load
+        #
+        #   @return [Integer, nil]
+        optional :page_number, Integer
+
+        # @!attribute page_size
+        #   The size of the page
+        #
+        #   @return [Integer, nil]
+        optional :page_size, Integer
+
+        # @!method initialize(filter_email: nil, filter_user_status: nil, include_groups: nil, page_number: nil, page_size: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::Organizations::UserListParams} for more details.
+        #
+        #   @param filter_email [String] Filter by email address (partial match)
+        #
+        #   @param filter_user_status [Symbol, Telnyx::Models::Organizations::UserListParams::FilterUserStatus] Filter by user status
+        #
+        #   @param include_groups [Boolean] When set to true, includes the groups array for each user in the response. The g
+        #
+        #   @param page_number [Integer] The page number to load
+        #
+        #   @param page_size [Integer] The size of the page
+        #
+        #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+
+        # Filter by user status
+        module FilterUserStatus
+          extend Telnyx::Internal::Type::Enum
+
+          ENABLED = :enabled
+          DISABLED = :disabled
+          BLOCKED = :blocked
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/organizations/user_list_response.rb

@@ -0,0 +1,118 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Organizations
+      # @see Telnyx::Resources::Organizations::Users#list
+      class UserListResponse < Telnyx::Internal::Type::BaseModel
+        # @!attribute id
+        #   Identifies the specific resource.
+        #
+        #   @return [String, nil]
+        optional :id, String
+
+        # @!attribute created_at
+        #   ISO 8601 formatted date indicating when the resource was created.
+        #
+        #   @return [String, nil]
+        optional :created_at, String
+
+        # @!attribute email
+        #   The email address of the user.
+        #
+        #   @return [String, nil]
+        optional :email, String
+
+        # @!attribute groups
+        #   The groups the user belongs to. Only included when include_groups parameter is
+        #   true.
+        #
+        #   @return [Array<Telnyx::Models::Organizations::UserListResponse::Group>, nil]
+        optional :groups,
+                 -> { Telnyx::Internal::Type::ArrayOf[Telnyx::Models::Organizations::UserListResponse::Group] }
+
+        # @!attribute last_sign_in_at
+        #   ISO 8601 formatted date indicating when the resource last signed into the
+        #   portal. Null if the user has never signed in.
+        #
+        #   @return [String, nil]
+        optional :last_sign_in_at, String, nil?: true
+
+        # @!attribute organization_user_bypasses_sso
+        #   Indicates whether this user is allowed to bypass SSO and use password
+        #   authentication.
+        #
+        #   @return [Boolean, nil]
+        optional :organization_user_bypasses_sso, Telnyx::Internal::Type::Boolean
+
+        # @!attribute record_type
+        #   Identifies the type of the resource. Can be 'organization_owner' or
+        #   'organization_sub_user'.
+        #
+        #   @return [String, nil]
+        optional :record_type, String
+
+        # @!attribute user_status
+        #   The status of the account.
+        #
+        #   @return [Symbol, Telnyx::Models::Organizations::UserListResponse::UserStatus, nil]
+        optional :user_status, enum: -> { Telnyx::Models::Organizations::UserListResponse::UserStatus }
+
+        # @!method initialize(id: nil, created_at: nil, email: nil, groups: nil, last_sign_in_at: nil, organization_user_bypasses_sso: nil, record_type: nil, user_status: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::Organizations::UserListResponse} for more details.
+        #
+        #   @param id [String] Identifies the specific resource.
+        #
+        #   @param created_at [String] ISO 8601 formatted date indicating when the resource was created.
+        #
+        #   @param email [String] The email address of the user.
+        #
+        #   @param groups [Array<Telnyx::Models::Organizations::UserListResponse::Group>] The groups the user belongs to. Only included when include_groups parameter is t
+        #
+        #   @param last_sign_in_at [String, nil] ISO 8601 formatted date indicating when the resource last signed into the portal
+        #
+        #   @param organization_user_bypasses_sso [Boolean] Indicates whether this user is allowed to bypass SSO and use password authentica
+        #
+        #   @param record_type [String] Identifies the type of the resource. Can be 'organization_owner' or 'organizatio
+        #
+        #   @param user_status [Symbol, Telnyx::Models::Organizations::UserListResponse::UserStatus] The status of the account.
+
+        class Group < Telnyx::Internal::Type::BaseModel
+          # @!attribute id
+          #   The unique identifier of the group.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute name
+          #   The name of the group.
+          #
+          #   @return [String]
+          required :name, String
+
+          # @!method initialize(id:, name:)
+          #   A reference to a group that a user belongs to.
+          #
+          #   @param id [String] The unique identifier of the group.
+          #
+          #   @param name [String] The name of the group.
+        end
+
+        # The status of the account.
+        #
+        # @see Telnyx::Models::Organizations::UserListResponse#user_status
+        module UserStatus
+          extend Telnyx::Internal::Type::Enum
+
+          ENABLED = :enabled
+          DISABLED = :disabled
+          BLOCKED = :blocked
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/organizations/user_retrieve_params.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Organizations
+      # @see Telnyx::Resources::Organizations::Users#retrieve
+      class UserRetrieveParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        # @!attribute include_groups
+        #   When set to true, includes the groups array for each user in the response. The
+        #   groups array contains objects with id and name for each group the user belongs
+        #   to.
+        #
+        #   @return [Boolean, nil]
+        optional :include_groups, Telnyx::Internal::Type::Boolean
+
+        # @!method initialize(include_groups: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::Organizations::UserRetrieveParams} for more details.
+        #
+        #   @param include_groups [Boolean] When set to true, includes the groups array for each user in the response. The g
+        #
+        #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/telnyx/models/organizations/user_retrieve_response.rb

@@ -0,0 +1,129 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Organizations
+      # @see Telnyx::Resources::Organizations::Users#retrieve
+      class UserRetrieveResponse < Telnyx::Internal::Type::BaseModel
+        # @!attribute data
+        #
+        #   @return [Telnyx::Models::Organizations::UserRetrieveResponse::Data, nil]
+        optional :data, -> { Telnyx::Models::Organizations::UserRetrieveResponse::Data }
+
+        # @!method initialize(data: nil)
+        #   @param data [Telnyx::Models::Organizations::UserRetrieveResponse::Data]
+
+        # @see Telnyx::Models::Organizations::UserRetrieveResponse#data
+        class Data < Telnyx::Internal::Type::BaseModel
+          # @!attribute id
+          #   Identifies the specific resource.
+          #
+          #   @return [String, nil]
+          optional :id, String
+
+          # @!attribute created_at
+          #   ISO 8601 formatted date indicating when the resource was created.
+          #
+          #   @return [String, nil]
+          optional :created_at, String
+
+          # @!attribute email
+          #   The email address of the user.
+          #
+          #   @return [String, nil]
+          optional :email, String
+
+          # @!attribute groups
+          #   The groups the user belongs to. Only included when include_groups parameter is
+          #   true.
+          #
+          #   @return [Array<Telnyx::Models::Organizations::UserRetrieveResponse::Data::Group>, nil]
+          optional :groups,
+                   -> { Telnyx::Internal::Type::ArrayOf[Telnyx::Models::Organizations::UserRetrieveResponse::Data::Group] }
+
+          # @!attribute last_sign_in_at
+          #   ISO 8601 formatted date indicating when the resource last signed into the
+          #   portal. Null if the user has never signed in.
+          #
+          #   @return [String, nil]
+          optional :last_sign_in_at, String, nil?: true
+
+          # @!attribute organization_user_bypasses_sso
+          #   Indicates whether this user is allowed to bypass SSO and use password
+          #   authentication.
+          #
+          #   @return [Boolean, nil]
+          optional :organization_user_bypasses_sso, Telnyx::Internal::Type::Boolean
+
+          # @!attribute record_type
+          #   Identifies the type of the resource. Can be 'organization_owner' or
+          #   'organization_sub_user'.
+          #
+          #   @return [String, nil]
+          optional :record_type, String
+
+          # @!attribute user_status
+          #   The status of the account.
+          #
+          #   @return [Symbol, Telnyx::Models::Organizations::UserRetrieveResponse::Data::UserStatus, nil]
+          optional :user_status, enum: -> { Telnyx::Models::Organizations::UserRetrieveResponse::Data::UserStatus }
+
+          # @!method initialize(id: nil, created_at: nil, email: nil, groups: nil, last_sign_in_at: nil, organization_user_bypasses_sso: nil, record_type: nil, user_status: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::Organizations::UserRetrieveResponse::Data} for more details.
+          #
+          #   @param id [String] Identifies the specific resource.
+          #
+          #   @param created_at [String] ISO 8601 formatted date indicating when the resource was created.
+          #
+          #   @param email [String] The email address of the user.
+          #
+          #   @param groups [Array<Telnyx::Models::Organizations::UserRetrieveResponse::Data::Group>] The groups the user belongs to. Only included when include_groups parameter is t
+          #
+          #   @param last_sign_in_at [String, nil] ISO 8601 formatted date indicating when the resource last signed into the portal
+          #
+          #   @param organization_user_bypasses_sso [Boolean] Indicates whether this user is allowed to bypass SSO and use password authentica
+          #
+          #   @param record_type [String] Identifies the type of the resource. Can be 'organization_owner' or 'organizatio
+          #
+          #   @param user_status [Symbol, Telnyx::Models::Organizations::UserRetrieveResponse::Data::UserStatus] The status of the account.
+
+          class Group < Telnyx::Internal::Type::BaseModel
+            # @!attribute id
+            #   The unique identifier of the group.
+            #
+            #   @return [String]
+            required :id, String
+
+            # @!attribute name
+            #   The name of the group.
+            #
+            #   @return [String]
+            required :name, String
+
+            # @!method initialize(id:, name:)
+            #   A reference to a group that a user belongs to.
+            #
+            #   @param id [String] The unique identifier of the group.
+            #
+            #   @param name [String] The name of the group.
+          end
+
+          # The status of the account.
+          #
+          # @see Telnyx::Models::Organizations::UserRetrieveResponse::Data#user_status
+          module UserStatus
+            extend Telnyx::Internal::Type::Enum
+
+            ENABLED = :enabled
+            DISABLED = :disabled
+            BLOCKED = :blocked
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+      end
+    end
+  end
+end