telnyx 5.0.0 → 5.2.0

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

@@ -4,6 +4,37 @@ module Telnyx
   module Resources
     class Calls
       class Actions
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::Calls::ActionAddAIAssistantMessagesParams} for more details.
+        #
+        # Add messages to the conversation started by an AI assistant on the call.
+        #
+        # @overload add_ai_assistant_messages(call_control_id, client_state: nil, command_id: nil, messages: nil, request_options: {})
+        #
+        # @param call_control_id [String] Unique identifier and token for controlling the call
+        #
+        # @param client_state [String] Use this field to add state to every subsequent webhook. It must be a valid Base
+        #
+        # @param command_id [String] Use this field to avoid duplicate commands. Telnyx will ignore any command with
+        #
+        # @param messages [Array<Telnyx::Models::Calls::ActionAddAIAssistantMessagesParams::Message::User, Telnyx::Models::Calls::ActionAddAIAssistantMessagesParams::Message::Assistant, Telnyx::Models::Calls::ActionAddAIAssistantMessagesParams::Message::Tool, Telnyx::Models::Calls::ActionAddAIAssistantMessagesParams::Message::System, Telnyx::Models::Calls::ActionAddAIAssistantMessagesParams::Message::Developer>] The messages to add to the conversation.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::Calls::ActionAddAIAssistantMessagesResponse]
+        #
+        # @see Telnyx::Models::Calls::ActionAddAIAssistantMessagesParams
+        def add_ai_assistant_messages(call_control_id, params = {})
+          parsed, options = Telnyx::Calls::ActionAddAIAssistantMessagesParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: ["calls/%1$s/actions/ai_assistant_add_messages", call_control_id],
+            body: parsed,
+            model: Telnyx::Models::Calls::ActionAddAIAssistantMessagesResponse,
+            options: options
+          )
+        end
+
         # Some parameter documentations has been truncated, see
         # {Telnyx::Models::Calls::ActionAnswerParams} for more details.
         #

data/lib/telnyx/resources/conferences.rb

@@ -98,17 +98,21 @@ module Telnyx
       # of active participants. Conferences are listed in descending order by
       # `expires_at`.
       #
-      # @overload list(filter: nil, page: nil, region: nil, request_options: {})
+      # @overload list(filter: nil, page: nil, page_number: nil, page_size: nil, region: nil, request_options: {})
       #
       # @param filter [Telnyx::Models::ConferenceListParams::Filter] Consolidated filter parameter (deepObject style). Originally: filter[application
       #
       # @param page [Telnyx::Models::ConferenceListParams::Page] Consolidated page parameter (deepObject style). Originally: page[after], page[be
       #
+      # @param page_number [Integer]
+      #
+      # @param page_size [Integer]
+      #
       # @param region [Symbol, Telnyx::Models::ConferenceListParams::Region] Region where the conference data is located
       #
       # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Telnyx::Internal::DefaultPagination<Telnyx::Models::Conference>]
+      # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::Conference>]
       #
       # @see Telnyx::Models::ConferenceListParams
       def list(params = {})
@@ -116,8 +120,8 @@ module Telnyx
         @client.request(
           method: :get,
           path: "conferences",
-          query: parsed,
-          page: Telnyx::Internal::DefaultPagination,
+          query: parsed.transform_keys(page_number: "page[number]", page_size: "page[size]"),
+          page: Telnyx::Internal::DefaultFlatPagination,
           model: Telnyx::Conference,
           options: options
         )
@@ -128,7 +132,7 @@ module Telnyx
       #
       # Lists conference participants
       #
-      # @overload list_participants(conference_id, filter: nil, page: nil, region: nil, request_options: {})
+      # @overload list_participants(conference_id, filter: nil, page: nil, page_number: nil, page_size: nil, region: nil, request_options: {})
       #
       # @param conference_id [String] Uniquely identifies the conference by id
       #
@@ -136,11 +140,15 @@ module Telnyx
       #
       # @param page [Telnyx::Models::ConferenceListParticipantsParams::Page] Consolidated page parameter (deepObject style). Originally: page[after], page[be
       #
+      # @param page_number [Integer]
+      #
+      # @param page_size [Integer]
+      #
       # @param region [Symbol, Telnyx::Models::ConferenceListParticipantsParams::Region] Region where the conference data is located
       #
       # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Telnyx::Internal::DefaultPagination<Telnyx::Models::ConferenceListParticipantsResponse>]
+      # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::ConferenceListParticipantsResponse>]
       #
       # @see Telnyx::Models::ConferenceListParticipantsParams
       def list_participants(conference_id, params = {})
@@ -148,8 +156,8 @@ module Telnyx
         @client.request(
           method: :get,
           path: ["conferences/%1$s/participants", conference_id],
-          query: parsed,
-          page: Telnyx::Internal::DefaultPagination,
+          query: parsed.transform_keys(page_number: "page[number]", page_size: "page[size]"),
+          page: Telnyx::Internal::DefaultFlatPagination,
           model: Telnyx::Models::ConferenceListParticipantsResponse,
           options: options
         )

data/lib/telnyx/resources/connections.rb

@@ -62,15 +62,19 @@ module Telnyx
       # SIP connections with webhook_url or xml_request_url, call control or texml.
       # Returned results are cursor paginated.
       #
-      # @overload list_active_calls(connection_id, page: nil, request_options: {})
+      # @overload list_active_calls(connection_id, page: nil, page_number: nil, page_size: nil, request_options: {})
       #
       # @param connection_id [String] Telnyx connection id
       #
       # @param page [Telnyx::Models::ConnectionListActiveCallsParams::Page] Consolidated page parameter (deepObject style). Originally: page[after], page[be
       #
+      # @param page_number [Integer]
+      #
+      # @param page_size [Integer]
+      #
       # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Telnyx::Internal::DefaultPagination<Telnyx::Models::ConnectionListActiveCallsResponse>]
+      # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::ConnectionListActiveCallsResponse>]
       #
       # @see Telnyx::Models::ConnectionListActiveCallsParams
       def list_active_calls(connection_id, params = {})
@@ -78,8 +82,8 @@ module Telnyx
         @client.request(
           method: :get,
           path: ["connections/%1$s/active_calls", connection_id],
-          query: parsed,
-          page: Telnyx::Internal::DefaultPagination,
+          query: parsed.transform_keys(page_number: "page[number]", page_size: "page[size]"),
+          page: Telnyx::Internal::DefaultFlatPagination,
           model: Telnyx::Models::ConnectionListActiveCallsResponse,
           options: options
         )

data/lib/telnyx/resources/credential_connections.rb

@@ -41,7 +41,7 @@ module Telnyx
       #
       # @param noise_suppression [Symbol, Telnyx::Models::CredentialConnectionCreateParams::NoiseSuppression] Controls when noise suppression is applied to calls. When set to 'inbound', nois
       #
-      # @param noise_suppression_details [Telnyx::Models::CredentialConnectionCreateParams::NoiseSuppressionDetails] Configuration options for noise suppression. These settings are stored regardles
+      # @param noise_suppression_details [Telnyx::Models::ConnectionNoiseSuppressionDetails] Configuration options for noise suppression. These settings are stored regardles
       #
       # @param onnet_t38_passthrough_enabled [Boolean] Enable on-net T38 if you prefer the sender and receiver negotiating T38 directly
       #
@@ -130,7 +130,7 @@ module Telnyx
       #
       # @param noise_suppression [Symbol, Telnyx::Models::CredentialConnectionUpdateParams::NoiseSuppression] Controls when noise suppression is applied to calls. When set to 'inbound', nois
       #
-      # @param noise_suppression_details [Telnyx::Models::CredentialConnectionUpdateParams::NoiseSuppressionDetails] Configuration options for noise suppression. These settings are stored regardles
+      # @param noise_suppression_details [Telnyx::Models::ConnectionNoiseSuppressionDetails] Configuration options for noise suppression. These settings are stored regardles
       #
       # @param onnet_t38_passthrough_enabled [Boolean] Enable on-net T38 if you prefer the sender and receiver negotiating T38 directly
       #

data/lib/telnyx/resources/faxes.rb

@@ -21,7 +21,7 @@ module Telnyx
       # - `fax.delivered`
       # - `fax.failed`
       #
-      # @overload create(connection_id:, from:, to:, client_state: nil, from_display_name: nil, media_name: nil, media_url: nil, monochrome: nil, preview_format: nil, quality: nil, store_media: nil, store_preview: nil, t38_enabled: nil, webhook_url: nil, request_options: {})
+      # @overload create(connection_id:, from:, to:, black_threshold: nil, client_state: nil, from_display_name: nil, media_name: nil, media_url: nil, monochrome: nil, preview_format: nil, quality: nil, store_media: nil, store_preview: nil, t38_enabled: nil, webhook_url: nil, request_options: {})
       #
       # @param connection_id [String] The connection ID to send the fax with.
       #
@@ -29,6 +29,8 @@ module Telnyx
       #
       # @param to [String] The phone number, in E.164 format, the fax will be sent to or SIP URI
       #
+      # @param black_threshold [Integer] The black threshold percentage for monochrome faxes. Only applicable if `monochr
+      #
       # @param client_state [String] Use this field to add state to every subsequent webhook. It must be a valid Base
       #
       # @param from_display_name [String] The `from_display_name` string to be used as the caller id name (SIP From Displa

data/lib/telnyx/resources/fqdn_connections.rb

@@ -36,7 +36,7 @@ module Telnyx
       #
       # @param noise_suppression [Symbol, Telnyx::Models::FqdnConnectionCreateParams::NoiseSuppression] Controls when noise suppression is applied to calls. When set to 'inbound', nois
       #
-      # @param noise_suppression_details [Telnyx::Models::FqdnConnectionCreateParams::NoiseSuppressionDetails] Configuration options for noise suppression. These settings are stored regardles
+      # @param noise_suppression_details [Telnyx::Models::ConnectionNoiseSuppressionDetails] Configuration options for noise suppression. These settings are stored regardles
       #
       # @param onnet_t38_passthrough_enabled [Boolean] Enable on-net T38 if you prefer the sender and receiver negotiating T38 directly
       #
@@ -125,7 +125,7 @@ module Telnyx
       #
       # @param noise_suppression [Symbol, Telnyx::Models::FqdnConnectionUpdateParams::NoiseSuppression] Controls when noise suppression is applied to calls. When set to 'inbound', nois
       #
-      # @param noise_suppression_details [Telnyx::Models::FqdnConnectionUpdateParams::NoiseSuppressionDetails] Configuration options for noise suppression. These settings are stored regardles
+      # @param noise_suppression_details [Telnyx::Models::ConnectionNoiseSuppressionDetails] Configuration options for noise suppression. These settings are stored regardles
       #
       # @param onnet_t38_passthrough_enabled [Boolean] Enable on-net T38 if you prefer that the sender and receiver negotiate T38 direc
       #

data/lib/telnyx/resources/ip_connections.rb

@@ -34,7 +34,7 @@ module Telnyx
       #
       # @param noise_suppression [Symbol, Telnyx::Models::IPConnectionCreateParams::NoiseSuppression] Controls when noise suppression is applied to calls. When set to 'inbound', nois
       #
-      # @param noise_suppression_details [Telnyx::Models::IPConnectionCreateParams::NoiseSuppressionDetails] Configuration options for noise suppression. These settings are stored regardles
+      # @param noise_suppression_details [Telnyx::Models::ConnectionNoiseSuppressionDetails] Configuration options for noise suppression. These settings are stored regardles
       #
       # @param onnet_t38_passthrough_enabled [Boolean] Enable on-net T38 if you prefer the sender and receiver negotiating T38 directly
       #
@@ -123,7 +123,7 @@ module Telnyx
       #
       # @param noise_suppression [Symbol, Telnyx::Models::IPConnectionUpdateParams::NoiseSuppression] Controls when noise suppression is applied to calls. When set to 'inbound', nois
       #
-      # @param noise_suppression_details [Telnyx::Models::IPConnectionUpdateParams::NoiseSuppressionDetails] Configuration options for noise suppression. These settings are stored regardles
+      # @param noise_suppression_details [Telnyx::Models::ConnectionNoiseSuppressionDetails] Configuration options for noise suppression. These settings are stored regardles
       #
       # @param onnet_t38_passthrough_enabled [Boolean] Enable on-net T38 if you prefer the sender and receiver negotiating T38 directly
       #

data/lib/telnyx/resources/messages.rb

@@ -9,7 +9,7 @@ module Telnyx
       # Note: This API endpoint can only retrieve messages that are no older than 10
       # days since their creation. If you require messages older than this, please
       # generate an
-      # [MDR report.](https://developers.telnyx.com/api/v1/mission-control/add-mdr-request)
+      # [MDR report.](https://developers.telnyx.com/api-reference/mdr-usage-reports/create-mdr-usage-report)
       #
       # @overload retrieve(id, request_options: {})
       #

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

@@ -295,37 +295,33 @@ module Telnyx
         end
 
         # Query the status of an SMS OTP (One-Time Password) for Sole Proprietor brand
-        # verification.
+        # verification using the Brand ID.
         #
         # This endpoint allows you to check the delivery and verification status of an OTP
-        # sent during the Sole Proprietor brand verification process. You can query by
-        # either:
-        #
-        # - `referenceId` - The reference ID returned when the OTP was initially triggered
-        # - `brandId` - Query parameter for portal users to look up OTP status by Brand ID
+        # sent during the Sole Proprietor brand verification process by looking it up with
+        # the brand ID.
         #
         # The response includes delivery status, verification dates, and detailed delivery
         # information.
         #
-        # @overload retrieve_sms_otp_status(reference_id, brand_id: nil, request_options: {})
+        # **Note:** This is an alternative to the `/10dlc/brand/smsOtp/{referenceId}`
+        # endpoint when you have the Brand ID but not the reference ID.
         #
-        # @param reference_id [String] The reference ID returned when the OTP was initially triggered
+        # @overload retrieve_sms_otp_status(brand_id, request_options: {})
         #
-        # @param brand_id [String] Filter by Brand ID for easier lookup in portal applications
+        # @param brand_id [String] The Brand ID for which to query OTP status
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Telnyx::Models::Messaging10dlc::BrandRetrieveSMSOtpStatusResponse]
         #
         # @see Telnyx::Models::Messaging10dlc::BrandRetrieveSMSOtpStatusParams
-        def retrieve_sms_otp_status(reference_id, params = {})
-          parsed, options = Telnyx::Messaging10dlc::BrandRetrieveSMSOtpStatusParams.dump_request(params)
+        def retrieve_sms_otp_status(brand_id, params = {})
           @client.request(
             method: :get,
-            path: ["10dlc/brand/smsOtp/%1$s", reference_id],
-            query: parsed.transform_keys(brand_id: "brandId"),
+            path: ["10dlc/brand/%1$s/smsOtp", brand_id],
             model: Telnyx::Models::Messaging10dlc::BrandRetrieveSMSOtpStatusResponse,
-            options: options
+            options: params[:request_options]
           )
         end
 

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

@@ -58,17 +58,17 @@ module Telnyx
         #
         # @overload update(autoresp_cfg_id, profile_id:, country_code:, keywords:, op:, resp_text: nil, request_options: {})
         #
-        # @param autoresp_cfg_id [String] Path param:
+        # @param autoresp_cfg_id [String] Path param
         #
-        # @param profile_id [String] Path param:
+        # @param profile_id [String] Path param
         #
-        # @param country_code [String] Body param:
+        # @param country_code [String] Body param
         #
-        # @param keywords [Array<String>] Body param:
+        # @param keywords [Array<String>] Body param
         #
-        # @param op [Symbol, Telnyx::Models::MessagingProfiles::AutoRespConfigCreate::Op] Body param:
+        # @param op [Symbol, Telnyx::Models::MessagingProfiles::AutoRespConfigCreate::Op] Body param
         #
-        # @param resp_text [String] Body param:
+        # @param resp_text [String] Body param
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #

data/lib/telnyx/resources/messaging_profiles.rb

@@ -11,7 +11,7 @@ module Telnyx
       #
       # Create a messaging profile
       #
-      # @overload create(name:, whitelisted_destinations:, 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, number_pool_settings: nil, url_shortener_settings: nil, webhook_api_version: nil, webhook_failover_url: nil, webhook_url: nil, request_options: {})
+      # @overload create(name:, whitelisted_destinations:, 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, number_pool_settings: nil, smart_encoding: nil, url_shortener_settings: nil, webhook_api_version: nil, webhook_failover_url: nil, webhook_url: nil, request_options: {})
       #
       # @param name [String] A user friendly name for the messaging profile.
       #
@@ -33,6 +33,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 webhook_api_version [Symbol, Telnyx::Models::MessagingProfileCreateParams::WebhookAPIVersion] Determines which webhook format will be used, Telnyx API v1, v2, or a legacy 201
@@ -82,7 +84,7 @@ module Telnyx
       #
       # Update a messaging profile
       #
-      # @overload update(messaging_profile_id, 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: {})
+      # @overload update(messaging_profile_id, 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: {})
       #
       # @param messaging_profile_id [String] The id of the messaging profile to retrieve
       #
@@ -104,6 +106,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/resources/messaging_tollfree/verification/requests.rb

@@ -11,7 +11,7 @@ module Telnyx
           #
           # Submit a new tollfree verification request
           #
-          # @overload create(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, request_options: {})
+          # @overload create(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, request_options: {})
           #
           # @param additional_information [String] Any additional information
           #
@@ -61,6 +61,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
@@ -119,7 +121,7 @@ module Telnyx
           # Update an existing tollfree verification request. This is particularly useful
           # when there are pending customer actions to be taken.
           #
-          # @overload update(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:, 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, request_options: {})
+          # @overload update(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:, 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, request_options: {})
           #
           # @param id [String]
           #
@@ -171,6 +173,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/resources/operator_connect/actions.rb

@@ -8,7 +8,7 @@ module Telnyx
         # integration with Microsoft Teams for the current user. This will create new
         # external connections on the user's account if needed, and/or report the
         # integration results as
-        # [log messages](https://developers.telnyx.com/api/external-voice-integrations/list-external-connection-log-messages).
+        # [log messages](https://developers.telnyx.com/api-reference/external-connections/list-all-log-messages#list-all-log-messages).
         #
         # @overload refresh(request_options: {})
         #

data/lib/telnyx/resources/organizations/users/actions.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class Organizations
+      class Users
+        class Actions
+          # Deletes a user in your organization.
+          #
+          # @overload remove(id, request_options: {})
+          #
+          # @param id [String] Organization User ID
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Models::Organizations::Users::ActionRemoveResponse]
+          #
+          # @see Telnyx::Models::Organizations::Users::ActionRemoveParams
+          def remove(id, params = {})
+            @client.request(
+              method: :post,
+              path: ["organizations/users/%1$s/actions/remove", id],
+              model: Telnyx::Models::Organizations::Users::ActionRemoveResponse,
+              options: params[:request_options]
+            )
+          end
+
+          # @api private
+          #
+          # @param client [Telnyx::Client]
+          def initialize(client:)
+            @client = client
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/resources/organizations/users.rb

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class Organizations
+      class Users
+        # @return [Telnyx::Resources::Organizations::Users::Actions]
+        attr_reader :actions
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::Organizations::UserRetrieveParams} for more details.
+        #
+        # Returns a user in your organization.
+        #
+        # @overload retrieve(id, include_groups: nil, request_options: {})
+        #
+        # @param id [String] Organization User ID
+        #
+        # @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}, nil]
+        #
+        # @return [Telnyx::Models::Organizations::UserRetrieveResponse]
+        #
+        # @see Telnyx::Models::Organizations::UserRetrieveParams
+        def retrieve(id, params = {})
+          parsed, options = Telnyx::Organizations::UserRetrieveParams.dump_request(params)
+          @client.request(
+            method: :get,
+            path: ["organizations/users/%1$s", id],
+            query: parsed,
+            model: Telnyx::Models::Organizations::UserRetrieveResponse,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::Organizations::UserListParams} for more details.
+        #
+        # Returns a list of the users in your organization.
+        #
+        # @overload list(filter_email: nil, filter_user_status: nil, include_groups: nil, page_number: nil, page_size: nil, request_options: {})
+        #
+        # @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}, nil]
+        #
+        # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::Organizations::UserListResponse>]
+        #
+        # @see Telnyx::Models::Organizations::UserListParams
+        def list(params = {})
+          parsed, options = Telnyx::Organizations::UserListParams.dump_request(params)
+          @client.request(
+            method: :get,
+            path: "organizations/users",
+            query: parsed.transform_keys(
+              filter_email: "filter[email]",
+              filter_user_status: "filter[user_status]",
+              page_number: "page[number]",
+              page_size: "page[size]"
+            ),
+            page: Telnyx::Internal::DefaultFlatPagination,
+            model: Telnyx::Models::Organizations::UserListResponse,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::Organizations::UserGetGroupsReportParams} for more details.
+        #
+        # Returns a report of all users in your organization with their group memberships.
+        # This endpoint returns all users without pagination and always includes group
+        # information. The report can be retrieved in JSON or CSV format by sending
+        # specific content-type headers.
+        #
+        # @overload get_groups_report(accept: nil, request_options: {})
+        #
+        # @param accept [Symbol, Telnyx::Models::Organizations::UserGetGroupsReportParams::Accept] Specify the response format. Use 'application/json' for JSON format or 'text/csv
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::Organizations::UserGetGroupsReportResponse]
+        #
+        # @see Telnyx::Models::Organizations::UserGetGroupsReportParams
+        def get_groups_report(params = {})
+          parsed, options = Telnyx::Organizations::UserGetGroupsReportParams.dump_request(params)
+          @client.request(
+            method: :get,
+            path: "organizations/users/users_groups_report",
+            headers: parsed.transform_keys(accept: "accept"),
+            model: Telnyx::Models::Organizations::UserGetGroupsReportResponse,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Telnyx::Client]
+        def initialize(client:)
+          @client = client
+          @actions = Telnyx::Resources::Organizations::Users::Actions.new(client: client)
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/resources/organizations.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class Organizations
+      # @return [Telnyx::Resources::Organizations::Users]
+      attr_reader :users
+
+      # @api private
+      #
+      # @param client [Telnyx::Client]
+      def initialize(client:)
+        @client = client
+        @users = Telnyx::Resources::Organizations::Users.new(client: client)
+      end
+    end
+  end
+end

data/lib/telnyx/resources/phone_numbers/jobs.rb

@@ -109,7 +109,7 @@ module Telnyx
         #
         # @param tags [Array<String>] Body param: A list of user-assigned tags to help organize phone numbers.
         #
-        # @param voice [Telnyx::Models::PhoneNumbers::UpdateVoiceSettings] Body param:
+        # @param voice [Telnyx::Models::PhoneNumbers::UpdateVoiceSettings] Body param
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #

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

@@ -66,15 +66,19 @@ module Telnyx
         #
         # Retrieve the list of calls in an existing queue
         #
-        # @overload list(queue_name, page: nil, request_options: {})
+        # @overload list(queue_name, page: nil, page_number: nil, page_size: nil, request_options: {})
         #
         # @param queue_name [String] Uniquely identifies the queue by name
         #
         # @param page [Telnyx::Models::Queues::CallListParams::Page] Consolidated page parameter (deepObject style). Originally: page[after], page[be
         #
+        # @param page_number [Integer]
+        #
+        # @param page_size [Integer]
+        #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [Telnyx::Internal::DefaultPagination<Telnyx::Models::Queues::CallListResponse>]
+        # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::Queues::CallListResponse>]
         #
         # @see Telnyx::Models::Queues::CallListParams
         def list(queue_name, params = {})
@@ -82,8 +86,8 @@ module Telnyx
           @client.request(
             method: :get,
             path: ["queues/%1$s/calls", queue_name],
-            query: parsed,
-            page: Telnyx::Internal::DefaultPagination,
+            query: parsed.transform_keys(page_number: "page[number]", page_size: "page[size]"),
+            page: Telnyx::Internal::DefaultFlatPagination,
             model: Telnyx::Models::Queues::CallListResponse,
             options: options
           )