telnyx 5.170.0 → 5.173.0

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

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class BrowserSessions
+      # Execute browser actions: navigate, observe, click, fill, select, press, scroll,
+      # wait_for, screenshot, batch.
+      class Actions
+        # Some parameter documentations has been truncated, see
+        # {Telnyx::Models::BrowserSessions::ActionCreateParams} for more details.
+        #
+        # Executes a browser action on the session. Returns 200 if completed within
+        # wait_seconds, 202 if still in-flight.
+        #
+        # Action types: navigate, observe, click, fill, select, press, scroll, wait_for,
+        # screenshot, batch.
+        #
+        # @overload create(id, body:, wait_seconds: nil, request_options: {})
+        #
+        # @param id [String] Path param
+        #
+        # @param body [Telnyx::Models::BrowserSessions::NavigateAction, Telnyx::Models::BrowserSessions::ObserveAction, Telnyx::Models::BrowserSessions::ClickAction, Telnyx::Models::BrowserSessions::FillAction, Telnyx::Models::BrowserSessions::SelectAction, Telnyx::Models::BrowserSessions::PressAction, Telnyx::Models::BrowserSessions::ScrollAction, Telnyx::Models::BrowserSessions::ScreenshotAction, Telnyx::Models::BrowserSessions::WaitForAction, Telnyx::Models::BrowserSessions::ActionCreateParams::Body::BatchAction] Body param: Discriminated union on type. Variants are strict: unknown fields are
+        #
+        # @param wait_seconds [Integer] Query param: Maximum seconds the submission request waits for completion, not an
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::BrowserSessions::ActionCreateResponse]
+        #
+        # @see Telnyx::Models::BrowserSessions::ActionCreateParams
+        def create(id, params)
+          parsed, options = Telnyx::BrowserSessions::ActionCreateParams.dump_request(params)
+          query = Telnyx::Internal::Util.encode_query_params(parsed.except(:body))
+          @client.request(
+            method: :post,
+            path: ["browser_sessions/%1$s/actions", id],
+            query: query,
+            body: parsed[:body],
+            model: Telnyx::Models::BrowserSessions::ActionCreateResponse,
+            options: options
+          )
+        end
+
+        # Returns the stored status and result of an action. Use this to poll actions that
+        # returned 202; HTTP 200 can contain any action status. Stored observations
+        # contain metadata with empty tree and refs, not the full snapshot; submit a fresh
+        # observe action to obtain current refs.
+        #
+        # @overload retrieve(action_id, id:, request_options: {})
+        #
+        # @param action_id [String]
+        # @param id [String]
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Models::BrowserSessions::ActionRetrieveResponse]
+        #
+        # @see Telnyx::Models::BrowserSessions::ActionRetrieveParams
+        def retrieve(action_id, params)
+          parsed, options = Telnyx::BrowserSessions::ActionRetrieveParams.dump_request(params)
+          id =
+            parsed.delete(:id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :get,
+            path: ["browser_sessions/%1$s/actions/%2$s", id, action_id],
+            model: Telnyx::Models::BrowserSessions::ActionRetrieveResponse,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Telnyx::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/resources/browser_sessions.rb

@@ -0,0 +1,140 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class BrowserSessions
+      # Execute browser actions: navigate, observe, click, fill, select, press, scroll,
+      # wait_for, screenshot, batch.
+      # @return [Telnyx::Resources::BrowserSessions::Actions]
+      attr_reader :actions
+
+      # Some parameter documentations has been truncated, see
+      # {Telnyx::Models::BrowserSessionCreateParams} for more details.
+      #
+      # Creates an isolated browser session with network access restricted to the
+      # domains you allow.
+      #
+      # @overload create(policy:, idempotency_key: nil, limits: nil, metadata: nil, request_options: {})
+      #
+      # @param policy [Telnyx::Models::BrowserSessionCreateParams::Policy]
+      #
+      # @param idempotency_key [String] Scoped to the organization. The same key and identical normalized policy, limits
+      #
+      # @param limits [Telnyx::Models::BrowserSessionCreateParams::Limits]
+      #
+      # @param metadata [Object] Arbitrary key-value metadata.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::BrowserSessionCreateResponse]
+      #
+      # @see Telnyx::Models::BrowserSessionCreateParams
+      def create(params)
+        parsed, options = Telnyx::BrowserSessionCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "browser_sessions",
+          body: parsed,
+          model: Telnyx::Models::BrowserSessionCreateResponse,
+          options: options
+        )
+      end
+
+      # Returns the current status of a browser session.
+      #
+      # @overload retrieve(id, request_options: {})
+      #
+      # @param id [String]
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::BrowserSessionRetrieveResponse]
+      #
+      # @see Telnyx::Models::BrowserSessionRetrieveParams
+      def retrieve(id, params = {})
+        @client.request(
+          method: :get,
+          path: ["browser_sessions/%1$s", id],
+          model: Telnyx::Models::BrowserSessionRetrieveResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Lists sessions for the authenticated org. Optional status filter.
+      #
+      # @overload list(status: nil, request_options: {})
+      #
+      # @param status [Symbol, Telnyx::Models::BrowserSessionListParams::Status]
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::BrowserSessionListResponse]
+      #
+      # @see Telnyx::Models::BrowserSessionListParams
+      def list(params = {})
+        parsed, options = Telnyx::BrowserSessionListParams.dump_request(params)
+        query = Telnyx::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "browser_sessions",
+          query: query,
+          model: Telnyx::Models::BrowserSessionListResponse,
+          options: options
+        )
+      end
+
+      # Closes a ready session and releases its resources. An already closed, failed, or
+      # expired session is returned unchanged; a provisioning session returns 409
+      # session_not_ready.
+      #
+      # @overload delete(id, request_options: {})
+      #
+      # @param id [String]
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::BrowserSessionDeleteResponse]
+      #
+      # @see Telnyx::Models::BrowserSessionDeleteParams
+      def delete(id, params = {})
+        @client.request(
+          method: :delete,
+          path: ["browser_sessions/%1$s", id],
+          model: Telnyx::Models::BrowserSessionDeleteResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Returns artifact metadata and a signed download URL. The download URL requires
+      # Bearer auth.
+      #
+      # @overload retrieve_artifact(artifact_id, id:, request_options: {})
+      #
+      # @param artifact_id [String]
+      # @param id [String]
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::BrowserSessionRetrieveArtifactResponse]
+      #
+      # @see Telnyx::Models::BrowserSessionRetrieveArtifactParams
+      def retrieve_artifact(artifact_id, params)
+        parsed, options = Telnyx::BrowserSessionRetrieveArtifactParams.dump_request(params)
+        id =
+          parsed.delete(:id) do
+            raise ArgumentError.new("missing required path argument #{_1}")
+          end
+        @client.request(
+          method: :get,
+          path: ["browser_sessions/%1$s/artifacts/%2$s", id, artifact_id],
+          model: Telnyx::Models::BrowserSessionRetrieveArtifactResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Telnyx::Client]
+      def initialize(client:)
+        @client = client
+        @actions = Telnyx::Resources::BrowserSessions::Actions.new(client: client)
+      end
+    end
+  end
+end

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

@@ -44,9 +44,33 @@ module Telnyx
         # Answer an incoming call. You must issue this command before executing subsequent
         # commands on an incoming call.
         #
+        # To answer with an AI assistant, include `assistant.id` and any per-call
+        # overrides in the `assistant` object. Telnyx attempts to warm up the assistant
+        # before answering the call, then starts the assistant automatically when the call
+        # is answered. Do not also send `ai_assistant_start` for this flow. The HTTP
+        # success response can arrive before the call is answered; use the `call.answered`
+        # webhook to track the answer. If warm-up fails, Telnyx falls back to starting the
+        # assistant after answering.
+        #
+        # When `assistant.id` is supplied, obtain the conversation ID from
+        # `data.payload.conversation_id` in the
+        # [call.conversation.created](/api-reference/callbacks/call-conversation-created)
+        # webhook and correlate it using `data.payload.call_control_id`. The `answer` HTTP
+        # response does not include `conversation_id`. The created event is emitted during
+        # assistant startup and does not indicate that the assistant is ready to speak.
+        #
+        # Set the assistant voice with `assistant.voice_settings.voice` and speech-to-text
+        # settings with `assistant.transcription`. You can reuse one stored assistant with
+        # different per-call settings. Warm-up prepares assistant configuration and
+        # dependencies; it does not wait for the greeting audio to be ready or guarantee
+        # zero silence after answer. A plain `answer` followed by `ai_assistant_start`
+        # performs assistant startup after the call has already been answered.
+        #
         # **Expected Webhooks:**
         #
         # - `call.answered`
+        # - `call.conversation.created` when the requested assistant conversation is
+        #   created
         # - `call.hold` and `call.unhold` if the call is held/unheld
         # - `call.deepfake_detection.result` if `deepfake_detection` was enabled
         # - `call.deepfake_detection.error` if `deepfake_detection` was enabled and an
@@ -61,7 +85,7 @@ module Telnyx
         #
         # @param call_control_id [String] Unique identifier and token for controlling the call
         #
-        # @param assistant [Telnyx::Models::CallAssistantRequest] AI Assistant configuration. All fields except `id` are optional — the assistant'
+        # @param assistant [Telnyx::Models::CallAssistantRequest] AI Assistant configuration and per-call overrides. All fields except `id` are op
         #
         # @param billing_group_id [String] Use this field to set the Billing Group ID for the call. Must be a valid and exi
         #
@@ -112,7 +136,7 @@ module Telnyx
         #
         # @param stream_url [String] The destination WebSocket address where the stream is going to be delivered.
         #
-        # @param transcription [Boolean] Enable transcription upon call answer. The default value is false.
+        # @param transcription [Boolean] Enable standalone call transcription upon call answer. The default value is fals
         #
         # @param transcription_config [Telnyx::Models::Calls::TranscriptionStartRequest]
         #
@@ -314,6 +338,8 @@ module Telnyx
         #
         # **Expected Webhooks:**
         #
+        # - [`call.conversation.created`](/api-reference/callbacks/call-conversation-created)
+        #   includes `conversation_id` during startup
         # - `call.ai_gather.ended`
         # - `call.conversation.ended`
         # - `call.ai_gather.partial_results` (if `send_partial_results` is set to `true`)
@@ -513,7 +539,7 @@ module Telnyx
         # - `call.hangup`
         # - `call.recording.saved`
         #
-        # @overload hangup(call_control_id, client_state: nil, command_id: nil, custom_headers: nil, request_options: {})
+        # @overload hangup(call_control_id, client_state: nil, command_id: nil, custom_headers: nil, reason: nil, request_options: {})
         #
         # @param call_control_id [String] Unique identifier and token for controlling the call
         #
@@ -523,6 +549,8 @@ module Telnyx
         #
         # @param custom_headers [Array<Telnyx::Models::CustomSipHeader>] Custom headers to be added to the SIP BYE message.
         #
+        # @param reason [String] Text for the SIP `Reason` header (RFC 3326) sent when cancelling an unanswered o
+        #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Telnyx::Models::Calls::ActionHangupResponse]
@@ -661,7 +689,7 @@ module Telnyx
         # The UnionPay and Maestro numbers are accepted for processor testing, but Pay
         # currently does not emit a card type for them.
         #
-        # @overload pay(call_control_id, amount: nil, client_state: nil, command_id: nil, connector_name: nil, currency: nil, description: nil, inter_digit_timeout_millis: nil, language: nil, max_attempts: nil, metadata: nil, parameters: nil, payment_method: nil, payment_token: nil, prompts: nil, service_level: nil, timeout_millis: nil, transaction_type: nil, valid_card_types: nil, voice: nil, request_options: {})
+        # @overload pay(call_control_id, amount: nil, client_state: nil, command_id: nil, connector_name: nil, currency: nil, description: nil, inter_digit_timeout_millis: nil, language: nil, max_attempts: nil, metadata: nil, min_postal_code_length: nil, parameters: nil, payment_method: nil, payment_token: nil, postal_code: nil, prompts: nil, service_level: nil, timeout_millis: nil, transaction_type: nil, valid_card_types: nil, voice: nil, request_options: {})
         #
         # @param call_control_id [String] Unique identifier and token for controlling the call
         #
@@ -685,12 +713,16 @@ module Telnyx
         #
         # @param metadata [Hash{Symbol=>Object}] Metadata forwarded to the Pay connector.
         #
+        # @param min_postal_code_length [Integer] Minimum number of digits the caller must enter when collecting a credit-card bil
+        #
         # @param parameters [Hash{Symbol=>Object}] Additional parameters forwarded to the Pay connector.
         #
         # @param payment_method [Symbol, Telnyx::Models::Calls::ActionPayParams::PaymentMethod] Payment method to collect.
         #
         # @param payment_token [String] Existing payment token. When supplied, payment-detail collection is skipped.
         #
+        # @param postal_code [String, Boolean] Controls billing postal code collection for credit-card payments when no `paymen
+        #
         # @param prompts [Telnyx::Models::Calls::ActionPayParams::Prompts] Custom text-to-speech prompts keyed by payment collection step.
         #
         # @param service_level [String] Speech synthesis service level used for payment prompts. Pay defaults to `premiu
@@ -778,7 +810,7 @@ module Telnyx
         #
         # @param call_control_id [String] Unique identifier and token for controlling the call
         #
-        # @param cause [Symbol, Telnyx::Models::Calls::ActionRejectParams::Cause] Cause for call rejection.
+        # @param cause [Symbol, Telnyx::Models::Calls::ActionRejectParams::Cause] Cause for call rejection. The cause sets the SIP response the caller receives: `
         #
         # @param client_state [String] Use this field to add state to every subsequent webhook. It must be a valid Base
         #
@@ -972,6 +1004,8 @@ module Telnyx
         #
         # **Expected Webhooks:**
         #
+        # - [`call.conversation.created`](/api-reference/callbacks/call-conversation-created)
+        #   includes `conversation_id` during startup
         # - `call.conversation.ended`
         # - `call.conversation_insights.generated`
         #
@@ -979,7 +1013,7 @@ module Telnyx
         #
         # @param call_control_id [String] Unique identifier and token for controlling the call
         #
-        # @param assistant [Telnyx::Models::CallAssistantRequest] AI Assistant configuration. All fields except `id` are optional — the assistant'
+        # @param assistant [Telnyx::Models::CallAssistantRequest] AI Assistant configuration and per-call overrides. All fields except `id` are op
         #
         # @param client_state [String] Use this field to add state to every subsequent webhook. It must be a valid Base
         #
@@ -1068,7 +1102,7 @@ module Telnyx
         #
         # @param transcription_engine [Symbol, Telnyx::Models::Calls::ActionStartConversationRelayParams::TranscriptionEngine] Engine to use for speech recognition. Legacy values `A` - `Google`, `B` - `Telny
         #
-        # @param transcription_engine_config [Hash{Symbol=>Object}] Engine-specific transcription settings for Conversation Relay. This accepts the
+        # @param transcription_engine_config [Telnyx::Models::Calls::ConversationRelayTranscriptionEngineConfig] Engine-specific transcription settings for Conversation Relay. This accepts the
         #
         # @param tts_provider [String] Text-to-speech provider. If omitted, Telnyx derives it from `voice` or `provider
         #
@@ -1817,6 +1851,9 @@ module Telnyx
         #   `answering_machine_detection=premium` was requested
         # - `call.machine.premium.greeting.ended` if `answering_machine_detection=premium`
         #   was requested and a beep was detected
+        # - `call.machine.premium.call_screening.detected` if
+        #   `answering_machine_detection=premium_ios_call_screening_detection` was
+        #   requested and an Apple Call Screening tone was detected
         #
         # @overload transfer(call_control_id, to:, answering_machine_detection: nil, answering_machine_detection_config: nil, audio_url: nil, client_state: nil, command_id: nil, custom_headers: nil, diversion: nil, early_media: nil, from: nil, from_display_name: nil, media_encryption: nil, media_name: nil, mute_dtmf: nil, park_after_unbridge: nil, preferred_codecs: nil, privacy: nil, record: nil, record_channels: nil, record_custom_file_name: nil, record_format: nil, record_max_length: nil, record_timeout_secs: nil, record_track: nil, record_trim: nil, route_to_mobile: nil, send_digits_on_answer: nil, sip_auth_password: nil, sip_auth_username: nil, sip_headers: nil, sip_region: nil, sip_transport_protocol: nil, sound_modifications: nil, target_leg_client_state: nil, time_limit_secs: nil, timeout_secs: nil, webhook_retries_policies: nil, webhook_url: nil, webhook_url_method: nil, webhook_urls: nil, webhook_urls_method: nil, request_options: {})
         #

data/lib/telnyx/resources/calls.rb

@@ -14,10 +14,18 @@ module Telnyx
       # include a `call_leg_id` which can be used to correlate the command with
       # subsequent webhooks.
       #
+      # To place the call with an AI assistant from the start, include `assistant.id`
+      # and any per-call overrides in the `assistant` object; Telnyx attempts to warm up
+      # the assistant before placing the call and starts it automatically when the
+      # called party answers.
+      #
       # **Expected Webhooks:**
       #
       # - `call.initiated`
       # - `call.answered` or `call.hangup`
+      # - `call.conversation.created` when the requested assistant conversation is
+      #   created, or `call.conversation.start_failed` when it could not be started
+      #   after the called party answered
       # - `call.hold` and `call.unhold` if the call is held/unheld
       # - `call.machine.detection.ended` if `answering_machine_detection` was requested
       # - `call.machine.greeting.ended` if `answering_machine_detection` was requested
@@ -26,6 +34,9 @@ module Telnyx
       #   `answering_machine_detection=premium` was requested
       # - `call.machine.premium.greeting.ended` if `answering_machine_detection=premium`
       #   was requested and a beep was detected
+      # - `call.machine.premium.call_screening.detected` if
+      #   `answering_machine_detection=premium_ios_call_screening_detection` was
+      #   requested and an Apple Call Screening tone was detected
       # - `call.deepfake_detection.result` if `deepfake_detection` was enabled
       # - `call.deepfake_detection.error` if `deepfake_detection` was enabled and an
       #   error occurred
@@ -47,7 +58,7 @@ module Telnyx
       #
       # @param answering_machine_detection_config [Telnyx::Models::CallDialParams::AnsweringMachineDetectionConfig] Optional configuration parameters to modify 'answering_machine_detection' perfor
       #
-      # @param assistant [Telnyx::Models::CallAssistantRequest] AI Assistant configuration. All fields except `id` are optional — the assistant'
+      # @param assistant [Telnyx::Models::CallAssistantRequest] AI Assistant configuration and per-call overrides. All fields except `id` are op
       #
       # @param audio_url [String] The URL of a file to be played back to the callee when the call is answered. The
       #

data/lib/telnyx/resources/compute/funcs/export.rb

@@ -4,6 +4,7 @@ module Telnyx
   module Resources
     class Compute
       class Funcs
+        # Manage Edge Compute functions
         class Export
           # Some parameter documentations has been truncated, see
           # {Telnyx::Models::Compute::Funcs::ExportCreateParams} for more details.

data/lib/telnyx/resources/compute/funcs.rb

@@ -3,10 +3,41 @@
 module Telnyx
   module Resources
     class Compute
+      # Manage Edge Compute functions
       class Funcs
+        # Manage Edge Compute functions
         # @return [Telnyx::Resources::Compute::Funcs::Export]
         attr_reader :export
 
+        # List functions for the authenticated organization. Each function includes its
+        # persisted function-scoped bindings. Actor bindings expose actor_type and
+        # env_name, allowing clients to identify every function attached to a Stateful
+        # Actor type.
+        #
+        # @overload list(page_number: nil, page_size: nil, request_options: {})
+        #
+        # @param page_number [Integer] Page number
+        #
+        # @param page_size [Integer] Page size (maximum 250)
+        #
+        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::Compute::FuncListResponse>]
+        #
+        # @see Telnyx::Models::Compute::FuncListParams
+        def list(params = {})
+          parsed, options = Telnyx::Compute::FuncListParams.dump_request(params)
+          query = Telnyx::Internal::Util.encode_query_params(parsed)
+          @client.request(
+            method: :get,
+            path: "compute/funcs",
+            query: query.transform_keys(page_number: "page[number]", page_size: "page[size]"),
+            page: Telnyx::Internal::DefaultFlatPagination,
+            model: Telnyx::Models::Compute::FuncListResponse,
+            options: options
+          )
+        end
+
         # Returns logs oldest first. `type=runtime` (default) returns function
         # stdout/stderr. `type=invocations` returns one platform-generated record per HTTP
         # request served.

data/lib/telnyx/resources/compute.rb

@@ -2,10 +2,34 @@
 
 module Telnyx
   module Resources
+    # Inspect Stateful Actor types
     class Compute
+      # Manage Edge Compute functions
       # @return [Telnyx::Resources::Compute::Funcs]
       attr_reader :funcs
 
+      # Retrieve one account-scoped Stateful Actor type. owner_function_id identifies
+      # the function that owns and ships the actor class; other functions may reference
+      # the same actor type through actor bindings.
+      #
+      # @overload retrieve(id, request_options: {})
+      #
+      # @param id [String] Actor type ID
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::ComputeRetrieveResponse]
+      #
+      # @see Telnyx::Models::ComputeRetrieveParams
+      def retrieve(id, params = {})
+        @client.request(
+          method: :get,
+          path: ["compute/actors/%1$s", id],
+          model: Telnyx::Models::ComputeRetrieveResponse,
+          options: params[:request_options]
+        )
+      end
+
       # @api private
       #
       # @param client [Telnyx::Client]

data/lib/telnyx/resources/credential_connections.rb

@@ -14,7 +14,7 @@ module Telnyx
       # Creates a new credential-based SIP connection. Credential connections
       # authenticate with a username and password rather than by IP address.
       #
-      # @overload create(connection_name:, password:, user_name:, active: nil, anchorsite_override: nil, android_push_credential_id: nil, call_cost_in_webhooks: nil, default_on_hold_comfort_noise_enabled: nil, dtmf_type: nil, encode_contact_header_enabled: nil, encrypted_media: nil, inbound: nil, ios_push_credential_id: nil, jitter_buffer: nil, noise_suppression: nil, noise_suppression_details: nil, onnet_t38_passthrough_enabled: nil, outbound: nil, rtcp_settings: nil, sip_uri_calling_preference: nil, tags: nil, webhook_api_version: nil, webhook_event_failover_url: nil, webhook_event_url: nil, webhook_timeout_secs: nil, request_options: {})
+      # @overload create(connection_name:, password:, user_name:, active: nil, anchorsite_override: nil, android_push_credential_id: nil, bridge_generate_comfort_noise_on_cn: nil, call_cost_in_webhooks: nil, default_on_hold_comfort_noise_enabled: nil, dtmf_type: nil, encode_contact_header_enabled: nil, encrypted_media: nil, inbound: nil, ios_push_credential_id: nil, jitter_buffer: nil, noise_suppression: nil, noise_suppression_details: nil, onnet_t38_passthrough_enabled: nil, outbound: nil, rtcp_settings: nil, sip_uri_calling_preference: nil, tags: nil, webhook_api_version: nil, webhook_event_failover_url: nil, webhook_event_url: nil, webhook_timeout_secs: nil, request_options: {})
       #
       # @param connection_name [String] A user-assigned name to help manage the connection.
       #
@@ -28,6 +28,8 @@ module Telnyx
       #
       # @param android_push_credential_id [String, nil] The uuid of the push credential for Android
       #
+      # @param bridge_generate_comfort_noise_on_cn [Boolean] Stores the connection preference for generating silent RTP toward the opposite c
+      #
       # @param call_cost_in_webhooks [Boolean] Specifies if call cost webhooks should be sent for this connection.
       #
       # @param default_on_hold_comfort_noise_enabled [Boolean] When enabled, Telnyx will generate comfort noise when you place the call on hold
@@ -36,7 +38,7 @@ module Telnyx
       #
       # @param encode_contact_header_enabled [Boolean] Encode the SIP contact header sent by Telnyx to avoid issues for NAT or ALG scen
       #
-      # @param encrypted_media [Symbol, Telnyx::Models::EncryptedMedia, nil] Enable use of SRTP for encryption. Cannot be set if the transport_portocol is TL
+      # @param encrypted_media [Symbol, Telnyx::Models::EncryptedMedia, nil] Enable use of SRTP for encryption. Can only be set when the SIP signaling transp
       #
       # @param inbound [Telnyx::Models::CredentialInbound]
       #
@@ -107,7 +109,7 @@ module Telnyx
       #
       # Updates settings of an existing credential connection.
       #
-      # @overload update(id, active: nil, anchorsite_override: nil, android_push_credential_id: nil, call_cost_in_webhooks: nil, connection_name: nil, conversation_persistence: nil, default_on_hold_comfort_noise_enabled: nil, dtmf_type: nil, encode_contact_header_enabled: nil, encrypted_media: nil, inbound: nil, ios_push_credential_id: nil, jitter_buffer: nil, noise_suppression: nil, noise_suppression_details: nil, onnet_t38_passthrough_enabled: nil, outbound: nil, password: nil, rtcp_settings: nil, sip_uri_calling_preference: nil, tags: nil, user_name: nil, webhook_api_version: nil, webhook_event_failover_url: nil, webhook_event_url: nil, webhook_timeout_secs: nil, request_options: {})
+      # @overload update(id, active: nil, anchorsite_override: nil, android_push_credential_id: nil, bridge_generate_comfort_noise_on_cn: nil, call_cost_in_webhooks: nil, connection_name: nil, conversation_persistence: nil, default_on_hold_comfort_noise_enabled: nil, dtmf_type: nil, encode_contact_header_enabled: nil, encrypted_media: nil, inbound: nil, ios_push_credential_id: nil, jitter_buffer: nil, noise_suppression: nil, noise_suppression_details: nil, onnet_t38_passthrough_enabled: nil, outbound: nil, password: nil, rtcp_settings: nil, sip_uri_calling_preference: nil, tags: nil, user_name: nil, webhook_api_version: nil, webhook_event_failover_url: nil, webhook_event_url: nil, webhook_timeout_secs: nil, request_options: {})
       #
       # @param id [String] Identifies the resource.
       #
@@ -117,6 +119,8 @@ module Telnyx
       #
       # @param android_push_credential_id [String, nil] The uuid of the push credential for Android
       #
+      # @param bridge_generate_comfort_noise_on_cn [Boolean] Stores the connection preference for generating silent RTP toward the opposite c
+      #
       # @param call_cost_in_webhooks [Boolean] Specifies if call cost webhooks should be sent for this connection.
       #
       # @param connection_name [String] A user-assigned name to help manage the connection.
@@ -129,7 +133,7 @@ module Telnyx
       #
       # @param encode_contact_header_enabled [Boolean] Encode the SIP contact header sent by Telnyx to avoid issues for NAT or ALG scen
       #
-      # @param encrypted_media [Symbol, Telnyx::Models::EncryptedMedia, nil] Enable use of SRTP for encryption. Cannot be set if the transport_portocol is TL
+      # @param encrypted_media [Symbol, Telnyx::Models::EncryptedMedia, nil] Enable use of SRTP for encryption. Can only be set when the SIP signaling transp
       #
       # @param inbound [Telnyx::Models::CredentialInbound]
       #

data/lib/telnyx/resources/dial_metrics.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    # Call information
+    class DialMetrics
+      # Some parameter documentations has been truncated, see
+      # {Telnyx::Models::DialMetricListParams} for more details.
+      #
+      # Returns dials-per-second (DPS) metrics for your account's outbound dials made
+      # with the Call Control `Dial` command and TeXML, as time buckets with dial
+      # counts, accepted and rejected dials, average and peak DPS, and the DPS limit in
+      # force.
+      #
+      # The result has one record per region per bucket, ordered by `start_time` and
+      # then `region`, newest first unless `sort=start_time`. Regions are never summed:
+      # the DPS limit is enforced per region, so a cross-region total cannot be compared
+      # with it.
+      #
+      # Only buckets that saw dials are returned. Treat a missing bucket as zero dials.
+      #
+      # Only complete 5-second windows are counted, and a window is counted about 15
+      # seconds after it closes. The newest `granularity=second` record is therefore
+      # your live DPS, about 20 seconds old. Request the last minute or two with
+      # `sort=-start_time`; the first record of each `region` is that region's live rate
+      # (`page[limit]=1` would hide every region but one). If no recent record exists,
+      # the live rate is zero.
+      #
+      # Results are cursor paginated. Follow `meta.next`, or pass `meta.cursors.after`
+      # as `page[after]`, until `meta.next` is absent. No total count is returned.
+      #
+      # This endpoint is in development and can change before general availability.
+      #
+      # @overload list(end_time:, granularity:, start_time:, page_after: nil, page_limit: nil, sort: nil, request_options: {})
+      #
+      # @param end_time [Time] Exclusive end of the range, ISO 8601. Must be after `start_time`. Buckets that s
+      #
+      # @param granularity [Symbol, Telnyx::Models::DialMetricListParams::Granularity] Bucket size. `second` returns 5-second buckets (the finest resolution) and is ke
+      #
+      # @param start_time [Time] Inclusive start of the range, ISO 8601 (for example `2026-09-29T12:00:00.000Z`).
+      #
+      # @param page_after [String] Opaque cursor from `meta.cursors.after` of the previous page. Do not parse or co
+      #
+      # @param page_limit [Integer] Maximum number of buckets per page. Values outside the range are clamped to 1-10
+      #
+      # @param sort [Symbol, Telnyx::Models::DialMetricListParams::Sort] Sort order of the buckets by `start_time`. `-start_time` (default) returns the n
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Internal::CloudfsCursorPagination<Telnyx::Models::DialMetricListResponse>]
+      #
+      # @see Telnyx::Models::DialMetricListParams
+      def list(params)
+        parsed, options = Telnyx::DialMetricListParams.dump_request(params)
+        query = Telnyx::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "dial_metrics",
+          query: query.transform_keys(page_after: "page[after]", page_limit: "page[limit]"),
+          page: Telnyx::Internal::CloudfsCursorPagination,
+          model: Telnyx::Models::DialMetricListResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Telnyx::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end