telnyx 5.170.0 → 5.173.0

data/rbi/telnyx/resources/calls/actions.rbi

@@ -47,9 +47,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
@@ -118,9 +142,11 @@ module Telnyx
         def answer(
           # Unique identifier and token for controlling the call
           call_control_id,
-          # AI Assistant configuration. All fields except `id` are optional — the
-          # assistant's stored configuration will be used as fallback for any omitted
-          # fields.
+          # AI Assistant configuration and per-call overrides. All fields except `id` are
+          # optional. Omitted assistant fields use the stored configuration. Supplied
+          # `voice_settings` and `transcription` objects replace their stored objects rather
+          # than merging individual settings; include every setting you want to retain.
+          # `dynamic_variables` are merged, with request values taking precedence.
           assistant: nil,
           # Use this field to set the Billing Group ID for the call. Must be a valid and
           # existing Billing Group ID.
@@ -196,7 +222,9 @@ module Telnyx
           stream_track: nil,
           # The destination WebSocket address where the stream is going to be delivered.
           stream_url: nil,
-          # Enable transcription upon call answer. The default value is false.
+          # Enable standalone call transcription upon call answer. The default value is
+          # false. Configure this feature with `transcription_config`. To configure speech
+          # recognition for an AI assistant, use `assistant.transcription` instead.
           transcription: nil,
           transcription_config: nil,
           # A map of event types to retry policies. Each retry policy contains an array of
@@ -435,6 +463,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`)
@@ -530,10 +560,10 @@ module Telnyx
           #   the `VoiceId` (e.g., `AWS.Polly.Joanna-Neural`). Check the
           #   [available voices](https://docs.aws.amazon.com/polly/latest/dg/available-voices.html)
           #   for compatibility.
-          # - **Azure:** Use `Azure.<VoiceId>. (e.g. Azure.en-CA-ClaraNeural,
-          #   Azure.en-CA-LiamNeural, Azure.en-US-BrianMultilingualNeural,
-          #   Azure.en-US-Ava:DragonHDLatestNeural. For a complete list of voices, go to
-          #   [Azure Voice Gallery](https://speech.microsoft.com/portal/voicegallery).)
+          # - **Azure:** Use `Azure.<VoiceId>` (e.g., `Azure.en-CA-ClaraNeural`,
+          #   `Azure.en-CA-LiamNeural`, `Azure.en-US-BrianMultilingualNeural`,
+          #   `Azure.en-US-Ava:DragonHDLatestNeural`). For a complete list of voices, go to
+          #   [Azure Voice Gallery](https://speech.microsoft.com/portal/voicegallery).
           # - **ElevenLabs:** Use `ElevenLabs.<ModelId>.<VoiceId>` (e.g.,
           #   `ElevenLabs.BaseModel.John`). The `ModelId` part is optional. To use
           #   ElevenLabs, you must provide your ElevenLabs API key as an integration secret
@@ -738,8 +768,9 @@ module Telnyx
           #   `Minimax.speech-02-hd.Wise_Woman`). Supported models: `speech-02-turbo`,
           #   `speech-02-hd`, `speech-2.6-turbo`, `speech-2.8-turbo`. Use `voice_settings`
           #   to configure speed, volume, pitch, and language_boost.
-          # - **Resemble:** Use `Resemble.Turbo.<voice_id>` (e.g.,
-          #   `Resemble.Turbo.my_voice`). Only `Turbo` model is supported. Use
+          # - **Resemble:** Use `Resemble.<ModelId>.<VoiceId>` (e.g.,
+          #   `Resemble.Turbo.Aaron_en-US`). Supported models: `Pro`, `Turbo`, `Urdu`.
+          #   `<VoiceId>` is a stock voice name or the ID of a Resemble voice clone. Use
           #   `voice_settings` to configure precision, sample_rate, and format.
           # - **Inworld:** Use `Inworld.<ModelId>.<VoiceId>` (e.g., `Inworld.Mini.Loretta`,
           #   `Inworld.Max.Oliver`, `Inworld.TTS2.Loretta`). Supported models: `Mini`,
@@ -820,6 +851,7 @@ module Telnyx
             client_state: String,
             command_id: String,
             custom_headers: T::Array[Telnyx::CustomSipHeader::OrHash],
+            reason: String,
             request_options: Telnyx::RequestOptions::OrHash
           ).returns(Telnyx::Models::Calls::ActionHangupResponse)
         end
@@ -834,6 +866,15 @@ module Telnyx
           command_id: nil,
           # Custom headers to be added to the SIP BYE message.
           custom_headers: nil,
+          # Text for the SIP `Reason` header (RFC 3326) sent when cancelling an unanswered
+          # outbound leg. The SIP CANCEL carries `Reason: SIP;cause=200;text="<reason>"`;
+          # phones such as Poly and Yealink use it to suppress the missed-call entry for a
+          # call answered elsewhere. Has no effect on an answered leg or an inbound leg. A
+          # hangup sent before the leg's `call.initiated` webhook still hangs up the leg,
+          # but without the `Reason` header. Must not contain `"`, `\`, control characters,
+          # or characters outside the Basic Multilingual Plane (such as emoji); invalid
+          # values are rejected with a 422.
+          reason: nil,
           request_options: {}
         )
         end
@@ -950,10 +991,12 @@ module Telnyx
             language: String,
             max_attempts: Integer,
             metadata: T::Hash[Symbol, T.anything],
+            min_postal_code_length: Integer,
             parameters: T::Hash[Symbol, T.anything],
             payment_method:
               Telnyx::Calls::ActionPayParams::PaymentMethod::OrSymbol,
             payment_token: String,
+            postal_code: Telnyx::Calls::ActionPayParams::PostalCode::Variants,
             prompts: Telnyx::Calls::ActionPayParams::Prompts::OrHash,
             service_level: String,
             timeout_millis: Integer,
@@ -989,12 +1032,27 @@ module Telnyx
           max_attempts: nil,
           # Metadata forwarded to the Pay connector.
           metadata: nil,
+          # Minimum number of digits the caller must enter when collecting a credit-card
+          # billing postal code. Applies only when `postal_code` is `true` or `"true"` and
+          # no `payment_token` is supplied. The default is 1. The maximum number of digits
+          # collected is the greater of 10 and this value. This does not validate the length
+          # of a postal code supplied directly in `postal_code`.
+          min_postal_code_length: nil,
           # Additional parameters forwarded to the Pay connector.
           parameters: nil,
           # Payment method to collect.
           payment_method: nil,
           # Existing payment token. When supplied, payment-detail collection is skipped.
           payment_token: nil,
+          # Controls billing postal code collection for credit-card payments when no
+          # `payment_token` is supplied. Set to `true` or the string `"true"` (the default)
+          # to prompt the caller for a postal code. Set to `false` or the string `"false"`
+          # to skip the postal code prompt without supplying a postal code to the payment
+          # connector. Supply any other non-empty string, such as `"90210"`, to use that
+          # postal code without prompting. Empty or whitespace-only strings are rejected.
+          # This option does not affect ACH debit payments or payments using an existing
+          # token.
+          postal_code: nil,
           # Custom text-to-speech prompts keyed by payment collection step.
           prompts: nil,
           # Speech synthesis service level used for payment prompts. Pay defaults to
@@ -1081,7 +1139,10 @@ module Telnyx
         def reject(
           # Unique identifier and token for controlling the call
           call_control_id,
-          # Cause for call rejection.
+          # Cause for call rejection. The cause sets the SIP response the caller receives:
+          # `USER_BUSY` sends 486 User Busy, `CALL_REJECTED` sends 603 Decline, `NOT_FOUND`
+          # sends 404 Not Found, and `TEMPORARILY_UNAVAILABLE` sends 480 Temporarily
+          # Unavailable.
           cause:,
           # Use this field to add state to every subsequent webhook. It must be a valid
           # Base-64 encoded string.
@@ -1267,8 +1328,9 @@ module Telnyx
           #   `Minimax.speech-02-hd.Wise_Woman`). Supported models: `speech-02-turbo`,
           #   `speech-02-hd`, `speech-2.6-turbo`, `speech-2.8-turbo`. Use `voice_settings`
           #   to configure speed, volume, pitch, and language_boost.
-          # - **Resemble:** Use `Resemble.Turbo.<voice_id>` (e.g.,
-          #   `Resemble.Turbo.my_voice`). Only `Turbo` model is supported. Use
+          # - **Resemble:** Use `Resemble.<ModelId>.<VoiceId>` (e.g.,
+          #   `Resemble.Turbo.Aaron_en-US`). Supported models: `Pro`, `Turbo`, `Urdu`.
+          #   `<VoiceId>` is a stock voice name or the ID of a Resemble voice clone. Use
           #   `voice_settings` to configure precision, sample_rate, and format.
           # - **Inworld:** Use `Inworld.<ModelId>.<VoiceId>` (e.g., `Inworld.Mini.Loretta`,
           #   `Inworld.Max.Oliver`, `Inworld.TTS2.Loretta`). Supported models: `Mini`,
@@ -1328,6 +1390,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`
         sig do
@@ -1358,9 +1422,11 @@ module Telnyx
         def start_ai_assistant(
           # Unique identifier and token for controlling the call
           call_control_id,
-          # AI Assistant configuration. All fields except `id` are optional — the
-          # assistant's stored configuration will be used as fallback for any omitted
-          # fields.
+          # AI Assistant configuration and per-call overrides. All fields except `id` are
+          # optional. Omitted assistant fields use the stored configuration. Supplied
+          # `voice_settings` and `transcription` objects replace their stored objects rather
+          # than merging individual settings; include every setting you want to retain.
+          # `dynamic_variables` are merged, with request values taking precedence.
           assistant: nil,
           # Use this field to add state to every subsequent webhook. It must be a valid
           # Base-64 encoded string.
@@ -1431,7 +1497,8 @@ module Telnyx
             transcription: T::Hash[Symbol, T.anything],
             transcription_engine:
               Telnyx::Calls::ActionStartConversationRelayParams::TranscriptionEngine::OrSymbol,
-            transcription_engine_config: T::Hash[Symbol, T.anything],
+            transcription_engine_config:
+              Telnyx::Calls::ConversationRelayTranscriptionEngineConfig::OrHash,
             tts_provider: String,
             url: String,
             voice: String,
@@ -1512,7 +1579,10 @@ module Telnyx
           # Engine-specific transcription settings for Conversation Relay. This accepts the
           # same provider-specific options used by the Call Transcription Start command,
           # such as `transcription_model`, without requiring the engine discriminator to be
-          # repeated inside this object.
+          # repeated inside this object. With Deepgram Flux (`deepgram/flux`),
+          # `interim_results`, `eot_threshold` and `eager_eot_threshold` control the interim
+          # prompts and the `eagerEndOfTurn` and `turnResumed` frames sent to your WebSocket
+          # server.
           transcription_engine_config: nil,
           # Text-to-speech provider. If omitted, Telnyx derives it from `voice` or
           # `provider`.
@@ -1530,10 +1600,10 @@ module Telnyx
           #   the `VoiceId` (e.g., `AWS.Polly.Joanna-Neural`). Check the
           #   [available voices](https://docs.aws.amazon.com/polly/latest/dg/available-voices.html)
           #   for compatibility.
-          # - **Azure:** Use `Azure.<VoiceId>. (e.g. Azure.en-CA-ClaraNeural,
-          #   Azure.en-CA-LiamNeural, Azure.en-US-BrianMultilingualNeural,
-          #   Azure.en-US-Ava:DragonHDLatestNeural. For a complete list of voices, go to
-          #   [Azure Voice Gallery](https://speech.microsoft.com/portal/voicegallery).)
+          # - **Azure:** Use `Azure.<VoiceId>` (e.g., `Azure.en-CA-ClaraNeural`,
+          #   `Azure.en-CA-LiamNeural`, `Azure.en-US-BrianMultilingualNeural`,
+          #   `Azure.en-US-Ava:DragonHDLatestNeural`). For a complete list of voices, go to
+          #   [Azure Voice Gallery](https://speech.microsoft.com/portal/voicegallery).
           # - **ElevenLabs:** Use `ElevenLabs.<ModelId>.<VoiceId>` (e.g.,
           #   `ElevenLabs.BaseModel.John`). The `ModelId` part is optional. To use
           #   ElevenLabs, you must provide your ElevenLabs API key as an integration secret
@@ -2302,6 +2372,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
         sig do
           params(
             call_control_id: String,
@@ -2383,12 +2456,22 @@ module Telnyx
           # 'greeting_end' or 'detect_words' is used and a 'machine' is detected, you will
           # receive another 'call.machine.greeting.ended' webhook when the answering machine
           # greeting ends with a beep or silence. If `detect_beep` is used, you will only
-          # receive 'call.machine.greeting.ended' if a beep is detected.
+          # receive 'call.machine.greeting.ended' if a beep is detected. If
+          # `answering_machine_detection` is set to `premium_ios_call_screening_detection`,
+          # Premium AMD runs with iOS Call Screening support: after an initial `machine`
+          # result, Telnyx listens for the iOS call-screening prompt to end or for an Apple
+          # Call Screening tone, sends `call.machine.premium.greeting.ended` with
+          # `result=prompt_ended` or `call.machine.premium.call_screening.detected` with
+          # `result=screening` respectively. When the Apple Call Screening tone is detected,
+          # Premium AMD is restarted on the screened call and a
+          # `call.machine.premium.detection.ended` webhook with the post-screening
+          # classification follows.
           answering_machine_detection: nil,
           # Optional configuration parameters to modify 'answering_machine_detection'
           # performance. Only `total_analysis_time_millis` and `greeting_duration_millis`
           # parameters are applicable when `premium` is selected as
-          # answering_machine_detection.
+          # answering_machine_detection. `prompt_end_timeout_millis` is additionally
+          # applicable when `premium_ios_call_screening_detection` is selected.
           answering_machine_detection_config: nil,
           # The URL of a file to be played back when the transfer destination answers before
           # bridging the call. The URL can point to either a WAV or MP3 file. media_name and

data/rbi/telnyx/resources/calls.rbi

@@ -11,10 +11,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
@@ -23,6 +31,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
@@ -150,16 +161,28 @@ module Telnyx
         # `greeting_end` or `detect_words` is used and a `machine` is detected, you will
         # receive another `call.machine.greeting.ended` webhook when the answering machine
         # greeting ends with a beep or silence. If `detect_beep` is used, you will only
-        # receive `call.machine.greeting.ended` if a beep is detected.
+        # receive `call.machine.greeting.ended` if a beep is detected. If
+        # `answering_machine_detection` is set to `premium_ios_call_screening_detection`,
+        # Premium AMD runs with iOS Call Screening support: after an initial `machine`
+        # result, Telnyx listens for the iOS call-screening prompt to end or for an Apple
+        # Call Screening tone, sends `call.machine.premium.greeting.ended` with
+        # `result=prompt_ended` or `call.machine.premium.call_screening.detected` with
+        # `result=screening` respectively. When the Apple Call Screening tone is detected,
+        # Premium AMD is restarted on the screened call and a
+        # `call.machine.premium.detection.ended` webhook with the post-screening
+        # classification follows.
         answering_machine_detection: nil,
         # Optional configuration parameters to modify 'answering_machine_detection'
         # performance. Only `total_analysis_time_millis` and `greeting_duration_millis`
         # parameters are applicable when `premium` is selected as
-        # answering_machine_detection.
+        # answering_machine_detection. `prompt_end_timeout_millis` is additionally
+        # applicable when `premium_ios_call_screening_detection` is selected.
         answering_machine_detection_config: nil,
-        # AI Assistant configuration. All fields except `id` are optional — the
-        # assistant's stored configuration will be used as fallback for any omitted
-        # fields.
+        # AI Assistant configuration and per-call overrides. All fields except `id` are
+        # optional. Omitted assistant fields use the stored configuration. Supplied
+        # `voice_settings` and `transcription` objects replace their stored objects rather
+        # than merging individual settings; include every setting you want to retain.
+        # `dynamic_variables` are merged, with request values taking precedence.
         assistant: nil,
         # The URL of a file to be played back to the callee when the call is answered. The
         # URL can point to either a WAV or MP3 file. media_name and audio_url cannot be

data/rbi/telnyx/resources/compute/funcs/export.rbi

@@ -4,6 +4,7 @@ module Telnyx
   module Resources
     class Compute
       class Funcs
+        # Manage Edge Compute functions
         class Export
           # Configures the external OTLP endpoint a function's runtime and/or invocation
           # logs are pushed to as they happen. This operation is a **full replace, not a

data/rbi/telnyx/resources/compute/funcs.rbi

@@ -3,10 +3,36 @@
 module Telnyx
   module Resources
     class Compute
+      # Manage Edge Compute functions
       class Funcs
+        # Manage Edge Compute functions
         sig { returns(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.
+        sig do
+          params(
+            page_number: Integer,
+            page_size: Integer,
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(
+            Telnyx::Internal::DefaultFlatPagination[
+              Telnyx::Models::Compute::FuncListResponse
+            ]
+          )
+        end
+        def list(
+          # Page number
+          page_number: nil,
+          # Page size (maximum 250)
+          page_size: nil,
+          request_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/rbi/telnyx/resources/compute.rbi

@@ -2,10 +2,28 @@
 
 module Telnyx
   module Resources
+    # Inspect Stateful Actor types
     class Compute
+      # Manage Edge Compute functions
       sig { returns(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.
+      sig do
+        params(
+          id: String,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(Telnyx::Models::ComputeRetrieveResponse)
+      end
+      def retrieve(
+        # Actor type ID
+        id,
+        request_options: {}
+      )
+      end
+
       # @api private
       sig { params(client: Telnyx::Client).returns(T.attached_class) }
       def self.new(client:)

data/rbi/telnyx/resources/conferences/actions.rbi

@@ -579,8 +579,9 @@ module Telnyx
           #   `Minimax.speech-02-hd.Wise_Woman`). Supported models: `speech-02-turbo`,
           #   `speech-02-hd`, `speech-2.6-turbo`, `speech-2.8-turbo`. Use `voice_settings`
           #   to configure speed, volume, pitch, and language_boost.
-          # - **Resemble:** Use `Resemble.Turbo.<voice_id>` (e.g.,
-          #   `Resemble.Turbo.my_voice`). Only `Turbo` model is supported. Use
+          # - **Resemble:** Use `Resemble.<ModelId>.<VoiceId>` (e.g.,
+          #   `Resemble.Turbo.Aaron_en-US`). Supported models: `Pro`, `Turbo`, `Urdu`.
+          #   `<VoiceId>` is a stock voice name or the ID of a Resemble voice clone. Use
           #   `voice_settings` to configure precision, sample_rate, and format.
           # - **Inworld:** Use `Inworld.<ModelId>.<VoiceId>` (e.g., `Inworld.Mini.Loretta`,
           #   `Inworld.Max.Oliver`, `Inworld.TTS2.Loretta`). Supported models: `Mini`,

data/rbi/telnyx/resources/credential_connections.rbi

@@ -18,6 +18,7 @@ module Telnyx
           active: T::Boolean,
           anchorsite_override: Telnyx::AnchorsiteOverride::OrSymbol,
           android_push_credential_id: T.nilable(String),
+          bridge_generate_comfort_noise_on_cn: T::Boolean,
           call_cost_in_webhooks: T::Boolean,
           default_on_hold_comfort_noise_enabled: T::Boolean,
           dtmf_type: Telnyx::DtmfType::OrSymbol,
@@ -60,6 +61,14 @@ module Telnyx
         anchorsite_override: nil,
         # The uuid of the push credential for Android
         android_push_credential_id: nil,
+        # Stores the connection preference for generating silent RTP toward the opposite
+        # call leg when comfort-noise packets (CN, payload type 13) are received during
+        # hold. Optional; defaults to false when omitted on creation. Only JSON true and
+        # false are accepted; null and non-boolean values are rejected. This preference is
+        # independent of default_on_hold_comfort_noise_enabled and does not modify that
+        # setting. This API provisions the preference; call-processing behavior is
+        # implemented separately.
+        bridge_generate_comfort_noise_on_cn: nil,
         # Specifies if call cost webhooks should be sent for this connection.
         call_cost_in_webhooks: nil,
         # When enabled, Telnyx will generate comfort noise when you place the call on
@@ -72,8 +81,8 @@ module Telnyx
         # Encode the SIP contact header sent by Telnyx to avoid issues for NAT or ALG
         # scenarios.
         encode_contact_header_enabled: nil,
-        # Enable use of SRTP for encryption. Cannot be set if the transport_portocol is
-        # TLS.
+        # Enable use of SRTP for encryption. Can only be set when the SIP signaling
+        # transport protocol is TLS.
         encrypted_media: nil,
         inbound: nil,
         # The uuid of the push credential for Ios
@@ -145,6 +154,7 @@ module Telnyx
           active: T::Boolean,
           anchorsite_override: Telnyx::AnchorsiteOverride::OrSymbol,
           android_push_credential_id: T.nilable(String),
+          bridge_generate_comfort_noise_on_cn: T::Boolean,
           call_cost_in_webhooks: T::Boolean,
           connection_name: String,
           conversation_persistence: T::Boolean,
@@ -185,6 +195,14 @@ module Telnyx
         anchorsite_override: nil,
         # The uuid of the push credential for Android
         android_push_credential_id: nil,
+        # Stores the connection preference for generating silent RTP toward the opposite
+        # call leg when comfort-noise packets (CN, payload type 13) are received during
+        # hold. Optional; omitting this field preserves the saved value. Only JSON true
+        # and false are accepted; null and non-boolean values are rejected. This
+        # preference is independent of default_on_hold_comfort_noise_enabled and does not
+        # modify that setting. This API provisions the preference; call-processing
+        # behavior is implemented separately.
+        bridge_generate_comfort_noise_on_cn: nil,
         # Specifies if call cost webhooks should be sent for this connection.
         call_cost_in_webhooks: nil,
         # A user-assigned name to help manage the connection.
@@ -203,8 +221,8 @@ module Telnyx
         # Encode the SIP contact header sent by Telnyx to avoid issues for NAT or ALG
         # scenarios.
         encode_contact_header_enabled: nil,
-        # Enable use of SRTP for encryption. Cannot be set if the transport_portocol is
-        # TLS.
+        # Enable use of SRTP for encryption. Can only be set when the SIP signaling
+        # transport protocol is TLS.
         encrypted_media: nil,
         inbound: nil,
         # The uuid of the push credential for Ios

data/rbi/telnyx/resources/dial_metrics.rbi

@@ -0,0 +1,80 @@
+# typed: strong
+
+module Telnyx
+  module Resources
+    # Call information
+    class DialMetrics
+      # 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.
+      sig do
+        params(
+          end_time: Time,
+          granularity: Telnyx::DialMetricListParams::Granularity::OrSymbol,
+          start_time: Time,
+          page_after: String,
+          page_limit: Integer,
+          sort: Telnyx::DialMetricListParams::Sort::OrSymbol,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(
+          Telnyx::Internal::CloudfsCursorPagination[
+            Telnyx::Models::DialMetricListResponse
+          ]
+        )
+      end
+      def list(
+        # Exclusive end of the range, ISO 8601. Must be after `start_time`. Buckets that
+        # start before this time are returned.
+        end_time:,
+        # Bucket size. `second` returns 5-second buckets (the finest resolution) and is
+        # kept for the last 48 hours. `minute` and `hour` are kept for the last 30 days.
+        granularity:,
+        # Inclusive start of the range, ISO 8601 (for example `2026-09-29T12:00:00.000Z`).
+        # Buckets that start at or after this time are returned. A `start_time` older than
+        # the retention window of the chosen `granularity` is moved forward to the start
+        # of that window, and `meta.start_time` returns the start actually used.
+        start_time:,
+        # Opaque cursor from `meta.cursors.after` of the previous page. Do not parse or
+        # construct it. A cursor that matches no records returns an empty page whose
+        # `meta.cursors.after` and `meta.cursors.before` both echo the given cursor.
+        page_after: nil,
+        # Maximum number of buckets per page. Values outside the range are clamped to
+        # 1-10,000.
+        page_limit: nil,
+        # Sort order of the buckets by `start_time`. `-start_time` (default) returns the
+        # newest first, `start_time` the oldest first. `region` follows the same direction
+        # for buckets with the same `start_time`. To read the live rate, use
+        # `granularity=second` and `sort=-start_time`, then take the first record of each
+        # `region`.
+        sort: nil,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: Telnyx::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/telnyx/resources/dir/phone_numbers.rbi

@@ -13,7 +13,6 @@ module Telnyx
             dir_id: String,
             page_number: Integer,
             page_size: Integer,
-            status: Telnyx::Dir::DirPhoneNumberStatus::OrSymbol,
             request_options: Telnyx::RequestOptions::OrHash
           ).returns(
             Telnyx::Internal::DefaultFlatPagination[Telnyx::Dir::DirPhoneNumber]
@@ -26,18 +25,16 @@ module Telnyx
           page_number: nil,
           # Items per page. Maximum 250; values above are clamped to 250.
           page_size: nil,
-          # Filter by phone-number status.
-          status: nil,
           request_options: {}
         )
         end
 
         # Register phone numbers under a DIR. The enterprise is resolved server-side from
-        # the DIR id. Same body, failure modes, and batch semantics whichever path form
-        # you use.
+        # the DIR id.
         #
-        # **Pricing:** This is a billable action. See https://telnyx.com/pricing/numbers
-        # for current pricing.
+        # **Pricing:** Adding phone numbers is free. Branded Calling fees are charged per
+        # DIR and per branded call. See https://telnyx.com/pricing/branded-calling for
+        # current pricing.
         sig do
           params(
             dir_id: String,
@@ -74,6 +71,8 @@ module Telnyx
         def remove(
           # The DIR id. Lowercase UUID.
           dir_id,
+          # The phone numbers to remove from this brand, in E.164 format, up to 100 per
+          # request. They must currently be attached to this brand.
           phone_numbers:,
           request_options: {}
         )