telnyx 5.171.0 → 5.173.0

data/rbi/telnyx/resources/ai/tests/test_framework/v1.rbi

@@ -0,0 +1,63 @@
+# typed: strong
+
+module Telnyx
+  module Resources
+    class AI
+      class Tests
+        class TestFramework
+          # Test agents, evaluator scenarios, metrics, and run results for the AI test
+          # framework.
+          class V1
+            # Test agents, evaluator scenarios, metrics, and run results for the AI test
+            # framework.
+            sig do
+              returns(Telnyx::Resources::AI::Tests::TestFramework::V1::Aiagents)
+            end
+            attr_reader :aiagents
+
+            # Test agents, evaluator scenarios, metrics, and run results for the AI test
+            # framework.
+            sig do
+              returns(Telnyx::Resources::AI::Tests::TestFramework::V1::Metrics)
+            end
+            attr_reader :metrics
+
+            # Test agents, evaluator scenarios, metrics, and run results for the AI test
+            # framework.
+            sig do
+              returns(Telnyx::Resources::AI::Tests::TestFramework::V1::Results)
+            end
+            attr_reader :results
+
+            # Test agents, evaluator scenarios, metrics, and run results for the AI test
+            # framework.
+            sig do
+              returns(
+                Telnyx::Resources::AI::Tests::TestFramework::V1::Scenarios
+              )
+            end
+            attr_reader :scenarios
+
+            # Returns the catalogue of test personalities available to your organization. A
+            # personality describes how a simulated caller speaks: prompt, language, accent,
+            # voice, interruption level, and call-behaviour settings.
+            sig do
+              params(request_options: Telnyx::RequestOptions::OrHash).returns(
+                T::Array[
+                  Telnyx::Models::AI::Tests::TestFramework::V1RetrievePersonalitiesResponseItem
+                ]
+              )
+            end
+            def retrieve_personalities(request_options: {})
+            end
+
+            # @api private
+            sig { params(client: Telnyx::Client).returns(T.attached_class) }
+            def self.new(client:)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/resources/ai/tests/test_framework.rbi

@@ -0,0 +1,21 @@
+# typed: strong
+
+module Telnyx
+  module Resources
+    class AI
+      class Tests
+        class TestFramework
+          # Test agents, evaluator scenarios, metrics, and run results for the AI test
+          # framework.
+          sig { returns(Telnyx::Resources::AI::Tests::TestFramework::V1) }
+          attr_reader :v1
+
+          # @api private
+          sig { params(client: Telnyx::Client).returns(T.attached_class) }
+          def self.new(client:)
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/resources/ai/tests.rbi

@@ -0,0 +1,20 @@
+# typed: strong
+
+module Telnyx
+  module Resources
+    class AI
+      class Tests
+        sig { returns(Telnyx::Resources::AI::Tests::Schedules) }
+        attr_reader :schedules
+
+        sig { returns(Telnyx::Resources::AI::Tests::TestFramework) }
+        attr_reader :test_framework
+
+        # @api private
+        sig { params(client: Telnyx::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/resources/ai/tools.rbi

@@ -19,6 +19,7 @@ module Telnyx
             timeout_ms: Integer,
             update_dynamic_variables:
               Telnyx::AI::UpdateDynamicVariablesToolParams::OrHash,
+            vision: Telnyx::AI::VisionToolParams::OrHash,
             webhook: T::Hash[Symbol, T.anything],
             idempotency_key: String,
             request_options: Telnyx::RequestOptions::OrHash
@@ -46,6 +47,8 @@ module Telnyx
           # Body param: Configuration for an update_dynamic_variables tool.
           update_dynamic_variables: nil,
           # Body param
+          vision: nil,
+          # Body param
           webhook: nil,
           # Header param: Optional opaque, unquoted key for safely retrying the same logical
           # request. Keys must contain 1 to 255 letters, numbers, hyphens, or underscores.
@@ -89,6 +92,7 @@ module Telnyx
             type: String,
             update_dynamic_variables:
               Telnyx::AI::UpdateDynamicVariablesToolParams::OrHash,
+            vision: Telnyx::AI::VisionToolParams::OrHash,
             webhook: T::Hash[Symbol, T.anything],
             request_options: Telnyx::RequestOptions::OrHash
           ).returns(Telnyx::AI::SharedToolResponse)
@@ -107,6 +111,7 @@ module Telnyx
           type: nil,
           # Configuration for an update_dynamic_variables tool.
           update_dynamic_variables: nil,
+          vision: nil,
           webhook: nil,
           request_options: {}
         )

data/rbi/telnyx/resources/ai.rbi

@@ -61,6 +61,13 @@ module Telnyx
       sig { returns(Telnyx::Resources::AI::Memory) }
       attr_reader :memory
 
+      # Create and manage real-time AI avatars
+      sig { returns(Telnyx::Resources::AI::Avatars) }
+      attr_reader :avatars
+
+      sig { returns(Telnyx::Resources::AI::Tests) }
+      attr_reader :tests
+
       # Performs semantic vector search across conversation history records.
       #
       # **How it works:**

data/rbi/telnyx/resources/artifact_downloads.rbi

@@ -0,0 +1,26 @@
+# typed: strong
+
+module Telnyx
+  module Resources
+    # Download screenshots and other artifacts.
+    class ArtifactDownloads
+      # Downloads the artifact content. The signed URL (with expires and sig query
+      # params) is obtained from the artifact metadata endpoint.
+      sig do
+        params(
+          artifact_id: String,
+          expires: String,
+          sig_: String,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(StringIO)
+      end
+      def retrieve(artifact_id, expires:, sig_:, 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/browser_sessions/actions.rbi

@@ -0,0 +1,71 @@
+# typed: strong
+
+module Telnyx
+  module Resources
+    class BrowserSessions
+      # Execute browser actions: navigate, observe, click, fill, select, press, scroll,
+      # wait_for, screenshot, batch.
+      class Actions
+        # 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.
+        sig do
+          params(
+            id: String,
+            body:
+              T.any(
+                Telnyx::BrowserSessions::NavigateAction::OrHash,
+                Telnyx::BrowserSessions::ObserveAction::OrHash,
+                Telnyx::BrowserSessions::ClickAction::OrHash,
+                Telnyx::BrowserSessions::FillAction::OrHash,
+                Telnyx::BrowserSessions::SelectAction::OrHash,
+                Telnyx::BrowserSessions::PressAction::OrHash,
+                Telnyx::BrowserSessions::ScrollAction::OrHash,
+                Telnyx::BrowserSessions::ScreenshotAction::OrHash,
+                Telnyx::BrowserSessions::WaitForAction::OrHash,
+                Telnyx::BrowserSessions::ActionCreateParams::Body::BatchAction::OrHash
+              ),
+            wait_seconds: Integer,
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(Telnyx::Models::BrowserSessions::ActionCreateResponse)
+        end
+        def create(
+          # Path param
+          id,
+          # Body param: Discriminated union on type. Variants are strict: unknown fields are
+          # rejected with 400. Reusing an idempotency_key with an identical request replays
+          # the original resource; with a different request it returns 409
+          # idempotency_conflict.
+          body:,
+          # Query param: Maximum seconds the submission request waits for completion, not an
+          # execution timeout. If still queued or running, returns 202 without cancelling
+          # execution; poll the returned action ID.
+          wait_seconds: nil,
+          request_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.
+        sig do
+          params(
+            action_id: String,
+            id: String,
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(Telnyx::Models::BrowserSessions::ActionRetrieveResponse)
+        end
+        def retrieve(action_id, id:, request_options: {})
+        end
+
+        # @api private
+        sig { params(client: Telnyx::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/resources/browser_sessions.rbi

@@ -0,0 +1,85 @@
+# typed: strong
+
+module Telnyx
+  module Resources
+    class BrowserSessions
+      # Execute browser actions: navigate, observe, click, fill, select, press, scroll,
+      # wait_for, screenshot, batch.
+      sig { returns(Telnyx::Resources::BrowserSessions::Actions) }
+      attr_reader :actions
+
+      # Creates an isolated browser session with network access restricted to the
+      # domains you allow.
+      sig do
+        params(
+          policy: Telnyx::BrowserSessionCreateParams::Policy::OrHash,
+          idempotency_key: String,
+          limits: Telnyx::BrowserSessionCreateParams::Limits::OrHash,
+          metadata: T.anything,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(Telnyx::Models::BrowserSessionCreateResponse)
+      end
+      def create(
+        policy:,
+        # Scoped to the organization. The same key and identical normalized policy,
+        # limits, and metadata replay the existing session (HTTP 201); a different request
+        # returns 409 idempotency_conflict. Replays do not restart terminal sessions.
+        idempotency_key: nil,
+        limits: nil,
+        # Arbitrary key-value metadata.
+        metadata: nil,
+        request_options: {}
+      )
+      end
+
+      # Returns the current status of a browser session.
+      sig do
+        params(
+          id: String,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(Telnyx::Models::BrowserSessionRetrieveResponse)
+      end
+      def retrieve(id, request_options: {})
+      end
+
+      # Lists sessions for the authenticated org. Optional status filter.
+      sig do
+        params(
+          status: Telnyx::BrowserSessionListParams::Status::OrSymbol,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(Telnyx::Models::BrowserSessionListResponse)
+      end
+      def list(status: nil, request_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.
+      sig do
+        params(
+          id: String,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(Telnyx::Models::BrowserSessionDeleteResponse)
+      end
+      def delete(id, request_options: {})
+      end
+
+      # Returns artifact metadata and a signed download URL. The download URL requires
+      # Bearer auth.
+      sig do
+        params(
+          artifact_id: String,
+          id: String,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(Telnyx::Models::BrowserSessionRetrieveArtifactResponse)
+      end
+      def retrieve_artifact(artifact_id, id:, 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/calls/actions.rbi

@@ -768,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`,
@@ -850,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
@@ -864,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
@@ -1317,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`,

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/references.rbi

@@ -6,24 +6,35 @@ module Telnyx
       # Submit and manage the two business references and one financial reference that
       # vouch for a DIR. References are contacted to confirm the business identity
       # during vetting.
+      #
+      # References (two business references and one financial reference) are needed only
+      # if the documents uploaded with the DIR don't already prove the business is
+      # legitimate and financially stable. Any one of these is enough proof: audited or
+      # certified financial statements (uploaded as `other`, with a description), a
+      # commercial credit report (uploaded as `business_credit_report`), or references.
+      # Telnyx reviewers decide during vetting whether your documents are enough.
       class References
         # Submit the two business references and one financial reference for a DIR.
         #
-        # The DIR's authorizer email must be verified first (see the email-verification
-        # endpoint). Until it is, this returns `409` and no references are stored.
+        # References (two business references and one financial reference) are needed only
+        # if the documents uploaded with the DIR don't already prove the business is
+        # legitimate and financially stable. Any one of these is enough proof: audited or
+        # certified financial statements (uploaded as `other`, with a description), a
+        # commercial credit report (uploaded as `business_credit_report`), or references.
+        # Telnyx reviewers decide during vetting whether your documents are enough.
+        #
+        # References can't be changed while the DIR is `verified`. Update the DIR first,
+        # which returns it to draft.
         #
         # The request body carries exactly two business references plus one financial
         # reference. The first submission stores them and returns `201`. Resubmitting
         # returns `200`: identical values are simply confirmed and nothing is written,
         # while changed values replace those references.
         #
-        # Replacing a reference is allowed only while the DIR itself is still editable,
-        # the same window in which a single reference may be updated; once the DIR has
-        # been submitted for vetting this returns `400`. A replaced reference's pending
-        # verification call is cancelled and its dial-in code stops working, and the
-        # replacement contact is emailed fresh scheduling details. References whose
-        # details did not change keep their existing call, code, and the notice already
-        # sent to them.
+        # A replaced reference's pending verification call is cancelled and its dial-in
+        # code stops working, and the replacement contact is emailed fresh scheduling
+        # details. References whose details did not change keep their existing call, code,
+        # and the notice already sent to them.
         #
         # The response always echoes the stored references in the same shape as the GET.
         #