telnyx 5.126.0 → 5.128.0

data/lib/telnyx/resources/ai/missions/runs/plan.rb

@@ -10,9 +10,9 @@ module Telnyx
             #
             # @overload create(run_id, mission_id:, steps:, request_options: {})
             #
-            # @param run_id [String] Path param
+            # @param run_id [String] Path param: Unique identifier of the run.
             #
-            # @param mission_id [String] Path param
+            # @param mission_id [String] Path param: Unique identifier of the mission.
             #
             # @param steps [Array<Telnyx::Models::AI::Missions::Runs::PlanCreateParams::Step>] Body param
             #
@@ -40,8 +40,10 @@ module Telnyx
             #
             # @overload retrieve(run_id, mission_id:, request_options: {})
             #
-            # @param run_id [String]
-            # @param mission_id [String]
+            # @param run_id [String] Unique identifier of the run.
+            #
+            # @param mission_id [String] Unique identifier of the mission.
+            #
             # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
             #
             # @return [Telnyx::Models::AI::Missions::Runs::PlanRetrieveResponse]
@@ -65,9 +67,9 @@ module Telnyx
             #
             # @overload add_steps_to_plan(run_id, mission_id:, steps:, request_options: {})
             #
-            # @param run_id [String] Path param
+            # @param run_id [String] Path param: Unique identifier of the run.
             #
-            # @param mission_id [String] Path param
+            # @param mission_id [String] Path param: Unique identifier of the mission.
             #
             # @param steps [Array<Telnyx::Models::AI::Missions::Runs::PlanAddStepsToPlanParams::Step>] Body param
             #
@@ -95,9 +97,12 @@ module Telnyx
             #
             # @overload get_step_details(step_id, mission_id:, run_id:, request_options: {})
             #
-            # @param step_id [String]
-            # @param mission_id [String]
-            # @param run_id [String]
+            # @param step_id [String] Unique identifier of the step.
+            #
+            # @param mission_id [String] Unique identifier of the mission.
+            #
+            # @param run_id [String] Unique identifier of the run.
+            #
             # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
             #
             # @return [Telnyx::Models::AI::Missions::Runs::PlanGetStepDetailsResponse]
@@ -125,11 +130,11 @@ module Telnyx
             #
             # @overload update_step(step_id, mission_id:, run_id:, metadata: nil, status: nil, request_options: {})
             #
-            # @param step_id [String] Path param
+            # @param step_id [String] Path param: Unique identifier of the step.
             #
-            # @param mission_id [String] Path param
+            # @param mission_id [String] Path param: Unique identifier of the mission.
             #
-            # @param run_id [String] Path param
+            # @param run_id [String] Path param: Unique identifier of the run.
             #
             # @param metadata [Hash{Symbol=>Object}] Body param
             #

data/lib/telnyx/resources/ai/missions/runs/telnyx_agents.rb

@@ -10,8 +10,10 @@ module Telnyx
             #
             # @overload list(run_id, mission_id:, request_options: {})
             #
-            # @param run_id [String]
-            # @param mission_id [String]
+            # @param run_id [String] Unique identifier of the run.
+            #
+            # @param mission_id [String] Unique identifier of the mission.
+            #
             # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
             #
             # @return [Telnyx::Models::AI::Missions::Runs::TelnyxAgentListResponse]
@@ -35,9 +37,9 @@ module Telnyx
             #
             # @overload link(run_id, mission_id:, telnyx_agent_id:, request_options: {})
             #
-            # @param run_id [String] Path param
+            # @param run_id [String] Path param: Unique identifier of the run.
             #
-            # @param mission_id [String] Path param
+            # @param mission_id [String] Path param: Unique identifier of the mission.
             #
             # @param telnyx_agent_id [String] Body param: The Telnyx AI agent ID to link
             #
@@ -65,9 +67,12 @@ module Telnyx
             #
             # @overload unlink(telnyx_agent_id, mission_id:, run_id:, request_options: {})
             #
-            # @param telnyx_agent_id [String]
-            # @param mission_id [String]
-            # @param run_id [String]
+            # @param telnyx_agent_id [String] Unique identifier of the telnyx agent.
+            #
+            # @param mission_id [String] Unique identifier of the mission.
+            #
+            # @param run_id [String] Unique identifier of the run.
+            #
             # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
             #
             # @return [nil]

data/lib/telnyx/resources/ai/missions/runs.rb

@@ -18,9 +18,12 @@ module Telnyx
           #
           # @overload create(mission_id, input: nil, metadata: nil, request_options: {})
           #
-          # @param mission_id [String]
+          # @param mission_id [String] Unique identifier of the mission.
+          #
           # @param input [Hash{Symbol=>Object}]
+          #
           # @param metadata [Hash{Symbol=>Object}]
+          #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [Telnyx::Models::AI::Missions::RunCreateResponse]
@@ -41,8 +44,10 @@ module Telnyx
           #
           # @overload retrieve(run_id, mission_id:, request_options: {})
           #
-          # @param run_id [String]
-          # @param mission_id [String]
+          # @param run_id [String] Unique identifier of the run.
+          #
+          # @param mission_id [String] Unique identifier of the mission.
+          #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [Telnyx::Models::AI::Missions::RunRetrieveResponse]
@@ -66,9 +71,9 @@ module Telnyx
           #
           # @overload update(run_id, mission_id:, error: nil, metadata: nil, result_payload: nil, result_summary: nil, status: nil, request_options: {})
           #
-          # @param run_id [String] Path param
+          # @param run_id [String] Path param: Unique identifier of the run.
           #
-          # @param mission_id [String] Path param
+          # @param mission_id [String] Path param: Unique identifier of the mission.
           #
           # @param error [String] Body param
           #
@@ -104,13 +109,13 @@ module Telnyx
           #
           # @overload list(mission_id, page_number: nil, page_size: nil, status: nil, request_options: {})
           #
-          # @param mission_id [String]
+          # @param mission_id [String] Unique identifier of the mission.
           #
           # @param page_number [Integer] Page number (1-based)
           #
           # @param page_size [Integer] Number of items per page
           #
-          # @param status [String]
+          # @param status [String] Filter results by status.
           #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -134,8 +139,10 @@ module Telnyx
           #
           # @overload cancel_run(run_id, mission_id:, request_options: {})
           #
-          # @param run_id [String]
-          # @param mission_id [String]
+          # @param run_id [String] Unique identifier of the run.
+          #
+          # @param mission_id [String] Unique identifier of the mission.
+          #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [Telnyx::Models::AI::Missions::RunCancelRunResponse]
@@ -163,7 +170,7 @@ module Telnyx
           #
           # @param page_size [Integer] Number of items per page
           #
-          # @param status [String]
+          # @param status [String] Filter results by status.
           #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -187,8 +194,10 @@ module Telnyx
           #
           # @overload pause_run(run_id, mission_id:, request_options: {})
           #
-          # @param run_id [String]
-          # @param mission_id [String]
+          # @param run_id [String] Unique identifier of the run.
+          #
+          # @param mission_id [String] Unique identifier of the mission.
+          #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [Telnyx::Models::AI::Missions::RunPauseRunResponse]
@@ -212,8 +221,10 @@ module Telnyx
           #
           # @overload resume_run(run_id, mission_id:, request_options: {})
           #
-          # @param run_id [String]
-          # @param mission_id [String]
+          # @param run_id [String] Unique identifier of the run.
+          #
+          # @param mission_id [String] Unique identifier of the mission.
+          #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [Telnyx::Models::AI::Missions::RunResumeRunResponse]

data/lib/telnyx/resources/ai/missions/tools.rb

@@ -9,7 +9,8 @@ module Telnyx
           #
           # @overload create_tool(mission_id, request_options: {})
           #
-          # @param mission_id [String]
+          # @param mission_id [String] Unique identifier of the mission.
+          #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [Object]
@@ -28,8 +29,10 @@ module Telnyx
           #
           # @overload delete_tool(tool_id, mission_id:, request_options: {})
           #
-          # @param tool_id [String]
-          # @param mission_id [String]
+          # @param tool_id [String] Unique identifier of the tool.
+          #
+          # @param mission_id [String] Unique identifier of the mission.
+          #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [nil]
@@ -53,8 +56,10 @@ module Telnyx
           #
           # @overload get_tool(tool_id, mission_id:, request_options: {})
           #
-          # @param tool_id [String]
-          # @param mission_id [String]
+          # @param tool_id [String] Unique identifier of the tool.
+          #
+          # @param mission_id [String] Unique identifier of the mission.
+          #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [Object]
@@ -78,7 +83,8 @@ module Telnyx
           #
           # @overload list_tools(mission_id, request_options: {})
           #
-          # @param mission_id [String]
+          # @param mission_id [String] Unique identifier of the mission.
+          #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [Object]
@@ -97,8 +103,10 @@ module Telnyx
           #
           # @overload update_tool(tool_id, mission_id:, request_options: {})
           #
-          # @param tool_id [String]
-          # @param mission_id [String]
+          # @param tool_id [String] Unique identifier of the tool.
+          #
+          # @param mission_id [String] Unique identifier of the mission.
+          #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [Object]

data/lib/telnyx/resources/ai/missions.rb

@@ -46,7 +46,8 @@ module Telnyx
         #
         # @overload retrieve(mission_id, request_options: {})
         #
-        # @param mission_id [String]
+        # @param mission_id [String] Unique identifier of the mission.
+        #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Telnyx::Models::AI::MissionRetrieveResponse]
@@ -91,7 +92,8 @@ module Telnyx
         #
         # @overload clone_mission(mission_id, request_options: {})
         #
-        # @param mission_id [String]
+        # @param mission_id [String] Unique identifier of the mission.
+        #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Object]
@@ -110,7 +112,8 @@ module Telnyx
         #
         # @overload delete_mission(mission_id, request_options: {})
         #
-        # @param mission_id [String]
+        # @param mission_id [String] Unique identifier of the mission.
+        #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [nil]
@@ -133,7 +136,7 @@ module Telnyx
         #
         # @param page_size [Integer] Number of items per page
         #
-        # @param type [String]
+        # @param type [String] Filter results by type.
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -157,13 +160,20 @@ module Telnyx
         #
         # @overload update_mission(mission_id, description: nil, execution_mode: nil, instructions: nil, metadata: nil, model: nil, name: nil, request_options: {})
         #
-        # @param mission_id [String]
+        # @param mission_id [String] Unique identifier of the mission.
+        #
         # @param description [String]
+        #
         # @param execution_mode [Symbol, Telnyx::Models::AI::MissionUpdateMissionParams::ExecutionMode]
+        #
         # @param instructions [String]
+        #
         # @param metadata [Hash{Symbol=>Object}]
+        #
         # @param model [String]
+        #
         # @param name [String]
+        #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Telnyx::Models::AI::MissionUpdateMissionResponse]

data/lib/telnyx/resources/ai/tools.rb

@@ -37,7 +37,8 @@ module Telnyx
         #
         # @overload retrieve(tool_id, request_options: {})
         #
-        # @param tool_id [String]
+        # @param tool_id [String] Unique identifier of the tool.
+        #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Telnyx::Models::AI::ToolRetrieveResponse]
@@ -56,15 +57,24 @@ module Telnyx
         #
         # @overload update(tool_id, display_name: nil, function: nil, handoff: nil, invite: nil, retrieval: nil, timeout_ms: nil, type: nil, webhook: nil, request_options: {})
         #
-        # @param tool_id [String]
+        # @param tool_id [String] Unique identifier of the tool.
+        #
         # @param display_name [String]
+        #
         # @param function [Hash{Symbol=>Object}]
+        #
         # @param handoff [Hash{Symbol=>Object}]
+        #
         # @param invite [Hash{Symbol=>Object}]
+        #
         # @param retrieval [Hash{Symbol=>Object}]
+        #
         # @param timeout_ms [Integer]
+        #
         # @param type [String]
+        #
         # @param webhook [Hash{Symbol=>Object}]
+        #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Telnyx::Models::AI::ToolUpdateResponse]
@@ -85,10 +95,14 @@ module Telnyx
         #
         # @overload list(filter_name: nil, filter_type: nil, page_number: nil, page_size: nil, request_options: {})
         #
-        # @param filter_name [String]
-        # @param filter_type [String]
-        # @param page_number [Integer]
-        # @param page_size [Integer]
+        # @param filter_name [String] Filter results by filter name.
+        #
+        # @param filter_type [String] Filter results by filter type.
+        #
+        # @param page_number [Integer] Page number to retrieve (1-based).
+        #
+        # @param page_size [Integer] Number of items to return per page.
+        #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::AI::ToolListResponse>]
@@ -116,7 +130,8 @@ module Telnyx
         #
         # @overload delete(tool_id, request_options: {})
         #
-        # @param tool_id [String]
+        # @param tool_id [String] Unique identifier of the tool.
+        #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Object]

data/lib/telnyx/resources/call_reasons.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    # Static reference values the API accepts: call reasons, document types, rejection
+    # types.
+    class CallReasons
+      # Some parameter documentations has been truncated, see
+      # {Telnyx::Models::CallReasonListParams} for more details.
+      #
+      # Telnyx maintains a library of pre-vetted call-reason phrases (e.g. "Appointment
+      # reminders", "Billing inquiries") that carry through DIR vetting smoothly. You
+      # can use any string that fits your use case in `DirCreateRequest.call_reasons`,
+      # but matching one of these reduces the chance the vetting team flags the phrasing
+      # for clarification.
+      #
+      # @overload list(page_number: nil, page_size: nil, request_options: {})
+      #
+      # @param page_number [Integer] 1-based page number. Out-of-range values return an empty page with correct meta.
+      #
+      # @param page_size [Integer] Items per page. Default `100` for this endpoint (the call-reason library is smal
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::CallReasonListResponse>]
+      #
+      # @see Telnyx::Models::CallReasonListParams
+      def list(params = {})
+        parsed, options = Telnyx::CallReasonListParams.dump_request(params)
+        query = Telnyx::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "call_reasons",
+          query: query.transform_keys(page_number: "page[number]", page_size: "page[size]"),
+          page: Telnyx::Internal::DefaultFlatPagination,
+          model: Telnyx::Models::CallReasonListResponse,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Telnyx::Models::CallReasonValidateParams} for more details.
+      #
+      # Check up to 10 candidate `call_reasons` strings against Telnyx's vetting
+      # heuristics before sending them on a DIR create or update. The endpoint flags
+      # strings that are likely to be rejected during vetting (too generic, banned
+      # phrases, length issues, etc.) so you can fix them up front.
+      #
+      # @overload validate(body:, request_options: {})
+      #
+      # @param body [Array<String>] **Bare JSON array** of candidate call-reason strings (NOT an object - there is n
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::CallReasonValidateResponse]
+      #
+      # @see Telnyx::Models::CallReasonValidateParams
+      def validate(params)
+        parsed, options = Telnyx::CallReasonValidateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "call_reasons/validate",
+          body: parsed[:body],
+          model: Telnyx::Models::CallReasonValidateResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Telnyx::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

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

@@ -349,7 +349,7 @@ module Telnyx
         #
         # @param voice [String] The voice to be used by the voice assistant. Currently we support ElevenLabs, Te
         #
-        # @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::RimeVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::XaiVoiceSettings] The settings associated with the voice selected
+        # @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::RimeVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::Calls::ActionGatherUsingAIParams::VoiceSettings::Xai] The settings associated with the voice selected
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -482,7 +482,7 @@ module Telnyx
         #
         # @param valid_digits [String] A list of all digits accepted as valid.
         #
-        # @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::RimeVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::Calls::ActionGatherUsingSpeakParams::VoiceSettings::Inworld, Telnyx::Models::XaiVoiceSettings] The settings associated with the voice selected
+        # @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::RimeVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::Calls::ActionGatherUsingSpeakParams::VoiceSettings::Inworld, Telnyx::Models::Calls::ActionGatherUsingSpeakParams::VoiceSettings::Xai] The settings associated with the voice selected
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -862,7 +862,7 @@ module Telnyx
         #
         # @param target_legs [Symbol, Telnyx::Models::Calls::ActionSpeakParams::TargetLegs] Specifies which legs of the call should receive the spoken audio.
         #
-        # @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::RimeVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::Calls::ActionSpeakParams::VoiceSettings::Inworld, Telnyx::Models::XaiVoiceSettings] The settings associated with the voice selected
+        # @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::RimeVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::Calls::ActionSpeakParams::VoiceSettings::Inworld, Telnyx::Models::Calls::ActionSpeakParams::VoiceSettings::Xai] The settings associated with the voice selected
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -914,7 +914,7 @@ module Telnyx
         #
         # @param voice [String] The voice to be used by the voice assistant. Currently we support ElevenLabs, Te
         #
-        # @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::RimeVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::XaiVoiceSettings] The settings associated with the voice selected
+        # @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::RimeVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::Calls::ActionStartAIAssistantParams::VoiceSettings::Xai] The settings associated with the voice selected
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -995,7 +995,7 @@ module Telnyx
         #
         # @param voice [String] The voice to be used by the voice assistant. Currently we support ElevenLabs, Te
         #
-        # @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::RimeVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::Calls::ActionStartConversationRelayParams::VoiceSettings::Inworld, Telnyx::Models::XaiVoiceSettings] The settings associated with the voice selected
+        # @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::RimeVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::Calls::ActionStartConversationRelayParams::VoiceSettings::Inworld, Telnyx::Models::Calls::ActionStartConversationRelayParams::VoiceSettings::Xai] The settings associated with the voice selected
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -1339,7 +1339,7 @@ module Telnyx
         #
         # @param transcription_engine [Symbol, Telnyx::Models::Calls::TranscriptionStartRequest::TranscriptionEngine] Engine to use for speech recognition. Legacy values `A` - `Google`, `B` - `Telny
         #
-        # @param transcription_engine_config [Telnyx::Models::Calls::TranscriptionEngineGoogleConfig, Telnyx::Models::Calls::TranscriptionEngineTelnyxConfig, Telnyx::Models::Calls::TranscriptionEngineAzureConfig, Telnyx::Models::Calls::TranscriptionEngineXaiConfig, Telnyx::Models::Calls::TranscriptionEngineAssemblyaiConfig, Telnyx::Models::Calls::TranscriptionStartRequest::TranscriptionEngineConfig::Speechmatics, Telnyx::Models::Calls::TranscriptionStartRequest::TranscriptionEngineConfig::Soniox, Telnyx::Models::Calls::TranscriptionEngineAConfig, Telnyx::Models::Calls::TranscriptionEngineBConfig, Telnyx::Models::Calls::DeepgramNova2Config, Telnyx::Models::Calls::DeepgramNova3Config]
+        # @param transcription_engine_config [Telnyx::Models::Calls::TranscriptionEngineGoogleConfig, Telnyx::Models::Calls::TranscriptionEngineTelnyxConfig, Telnyx::Models::Calls::TranscriptionEngineAzureConfig, Telnyx::Models::Calls::TranscriptionStartRequest::TranscriptionEngineConfig::XAI, Telnyx::Models::Calls::TranscriptionStartRequest::TranscriptionEngineConfig::AssemblyAI, Telnyx::Models::Calls::TranscriptionStartRequest::TranscriptionEngineConfig::Speechmatics, Telnyx::Models::Calls::TranscriptionStartRequest::TranscriptionEngineConfig::Soniox, Telnyx::Models::Calls::TranscriptionEngineAConfig, Telnyx::Models::Calls::TranscriptionEngineBConfig, Telnyx::Models::Calls::DeepgramNova2Config, Telnyx::Models::Calls::DeepgramNova3Config]
         #
         # @param transcription_tracks [String] Indicates which leg of the call will be transcribed. Use `inbound` for the leg t
         #

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

@@ -520,7 +520,7 @@ module Telnyx
         #
         # @param region [Symbol, Telnyx::Models::Conferences::ActionSpeakParams::Region] Region where the conference data is located. Defaults to the region defined in u
         #
-        # @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::RimeVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::Conferences::ActionSpeakParams::VoiceSettings::Inworld, Telnyx::Models::XaiVoiceSettings] The settings associated with the voice selected
+        # @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::RimeVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::Conferences::ActionSpeakParams::VoiceSettings::Inworld, Telnyx::Models::Conferences::ActionSpeakParams::VoiceSettings::Xai] The settings associated with the voice selected
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #

data/lib/telnyx/resources/dir/comments.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class Dir
+      # Read messages from the Telnyx vetting team and reply with clarifying
+      # information.
+      class Comments
+        # Post a customer comment on a DIR (for example, to respond to reviewer notes).
+        # Send only `content` (1–5000 chars) and an optional `parent_comment_id`; the
+        # server sets the comment type, visibility, and author automatically. The
+        # enterprise is resolved server-side from the DIR id.
+        #
+        # @overload create(dir_id, content:, parent_comment_id: nil, request_options: {})
+        #
+        # @param dir_id [String] The DIR id. Lowercase UUID.
+        #
+        # @param content [String] Comment body. 1–5000 characters.
+        #
+        # @param parent_comment_id [String] Optional parent comment id to thread this reply under.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::Dir::CommentCreateResponse]
+        #
+        # @see Telnyx::Models::Dir::CommentCreateParams
+        def create(dir_id, params)
+          parsed, options = Telnyx::Dir::CommentCreateParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: ["dir/%1$s/comments", dir_id],
+            body: parsed,
+            model: Telnyx::Models::Dir::CommentCreateResponse,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::Dir::CommentListParams} for more details.
+        #
+        # List the comments on a DIR. The enterprise is resolved server-side from the DIR
+        # id.
+        #
+        # @overload list(dir_id, comment_type: nil, page_number: nil, page_size: nil, request_options: {})
+        #
+        # @param dir_id [String] The DIR id. Lowercase UUID.
+        #
+        # @param comment_type [Symbol, Telnyx::Models::Dir::CommentListParams::CommentType] Restrict to comments of this category. Customer-visible categories only: interna
+        #
+        # @param page_number [Integer] 1-based page number. Out-of-range values return an empty page with correct meta.
+        #
+        # @param page_size [Integer] Items per page. Maximum 250; values above are clamped to 250.
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::Dir::CommentListResponse>]
+        #
+        # @see Telnyx::Models::Dir::CommentListParams
+        def list(dir_id, params = {})
+          parsed, options = Telnyx::Dir::CommentListParams.dump_request(params)
+          query = Telnyx::Internal::Util.encode_query_params(parsed)
+          @client.request(
+            method: :get,
+            path: ["dir/%1$s/comments", dir_id],
+            query: query.transform_keys(page_number: "page[number]", page_size: "page[size]"),
+            page: Telnyx::Internal::DefaultFlatPagination,
+            model: Telnyx::Models::Dir::CommentListResponse,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Telnyx::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end