telnyx 5.171.0 → 5.173.0

data/rbi/telnyx/resources/pay_connectors.rbi

@@ -0,0 +1,191 @@
+# typed: strong
+
+module Telnyx
+  module Resources
+    # Generic payment connector configuration.
+    class PayConnectors
+      # Create a generic payment connector in the authenticated organization. The name
+      # must be unique in that organization. Authentication supplies ownership; do not
+      # send user_id or organization_id. Config is encrypted at rest; passwords and
+      # tokens are omitted from responses. This operation stores configuration and does
+      # not initiate a payment. See the
+      # [processor contract](/docs/voice/programmable-voice/pay#request-sent-to-the-payment-processor).
+      sig do
+        params(
+          config:
+            T.any(
+              Telnyx::GenericPayConnectorConfig::BasicAuthenticationAlsoTheValidationDefault::OrHash,
+              Telnyx::GenericPayConnectorConfig::BearerAuthentication::OrHash,
+              Telnyx::GenericPayConnectorConfig::NoProcessorAuthentication::OrHash
+            ),
+          name: String,
+          mode: Telnyx::PayConnectorCreateParams::Mode::OrSymbol,
+          type: Telnyx::PayConnectorCreateParams::Type::OrSymbol,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(Telnyx::PayConnectorResponse)
+      end
+      def create(
+        # Configuration for a generic connector. A config update replaces the complete
+        # object, not individual keys. Unknown config keys are discarded. Authentication
+        # credentials must be nonblank strings when required by the selected auth_type.
+        config:,
+        # Unique within the authenticated organization. Used in resource paths and as
+        # connector_name in the Call Control Pay request. Cannot be renamed by update.
+        name:,
+        # Defaults to test on creation. Test restricts collected card numbers but still
+        # contacts the configured processor; use a processor sandbox URL and sandbox
+        # credentials. Live removes the test-card restriction. Neither mode locks API
+        # updates.
+        mode: nil,
+        # Connector type covered by this reference.
+        type: nil,
+        request_options: {}
+      )
+      end
+
+      # Retrieve a connector by name within the authenticated organization. Password and
+      # token are omitted. A missing name or a connector owned by another organization
+      # returns 404.
+      sig do
+        params(
+          name: String,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(Telnyx::PayConnectorResponse)
+      end
+      def retrieve(
+        # Connector name, not its UUID. URL-encode the name as a path segment.
+        name,
+        request_options: {}
+      )
+      end
+
+      # Update a generic connector by name in the authenticated organization. Both test
+      # and live connectors can be updated through the API. Omitted fields remain
+      # unchanged. Supplying config replaces the entire config; it does not merge keys.
+      # Include endpoint_url and the credentials required for the selected auth_type on
+      # every config replacement. Omitting config preserves existing credentials,
+      # allowing a mode-only update. The path name cannot be renamed. Public updates use
+      # PATCH.
+      sig do
+        params(
+          name: String,
+          config:
+            T.any(
+              Telnyx::GenericPayConnectorConfig::BasicAuthenticationAlsoTheValidationDefault::OrHash,
+              Telnyx::GenericPayConnectorConfig::BearerAuthentication::OrHash,
+              Telnyx::GenericPayConnectorConfig::NoProcessorAuthentication::OrHash
+            ),
+          mode: Telnyx::PayConnectorUpdateParams::Mode::OrSymbol,
+          type: Telnyx::PayConnectorUpdateParams::Type::OrSymbol,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(Telnyx::PayConnectorResponse)
+      end
+      def update(
+        # Connector name, not its UUID. URL-encode the name as a path segment.
+        name,
+        # Configuration for a generic connector. A config update replaces the complete
+        # object, not individual keys. Unknown config keys are discarded. Authentication
+        # credentials must be nonblank strings when required by the selected auth_type.
+        config: nil,
+        # Omit to preserve the existing mode. Use an explicit test or live value.
+        mode: nil,
+        # Generic connector type. Omit to preserve the existing value.
+        type: nil,
+        request_options: {}
+      )
+      end
+
+      # List connectors belonging to the authenticated organization, including
+      # connectors created by other users in that organization. Set filter[type]=generic
+      # to restrict results to the type covered here. Results default to newest
+      # created_at first. Use meta.end_cursor as page[after] for the next page, or
+      # meta.start_cursor as page[before] for the preceding page. Omit both cursors for
+      # the first page; if both are supplied, page[after] takes precedence. Responses
+      # omit passwords and tokens.
+      sig do
+        params(
+          filter_created_at_eq: String,
+          filter_created_at_gt: String,
+          filter_created_at_gte: String,
+          filter_created_at_lt: String,
+          filter_created_at_lte: String,
+          filter_mode: String,
+          filter_name: String,
+          filter_type: String,
+          filter_updated_at_eq: String,
+          filter_updated_at_gt: String,
+          filter_updated_at_gte: String,
+          filter_updated_at_lt: String,
+          filter_updated_at_lte: String,
+          page_after: String,
+          page_before: String,
+          page_size: Integer,
+          sort: String,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(
+          Telnyx::Internal::EmailBracketCursorPagination[Telnyx::PayConnector]
+        )
+      end
+      def list(
+        # Equal to this created_at timestamp.
+        filter_created_at_eq: nil,
+        # After this created_at timestamp.
+        filter_created_at_gt: nil,
+        # At or after this created_at timestamp.
+        filter_created_at_gte: nil,
+        # Before this created_at timestamp.
+        filter_created_at_lt: nil,
+        # At or before this created_at timestamp.
+        filter_created_at_lte: nil,
+        # Exact match on mode.
+        filter_mode: nil,
+        # Exact match on name.
+        filter_name: nil,
+        # Exact match on type.
+        filter_type: nil,
+        # Equal to this updated_at timestamp.
+        filter_updated_at_eq: nil,
+        # After this updated_at timestamp.
+        filter_updated_at_gt: nil,
+        # At or after this updated_at timestamp.
+        filter_updated_at_gte: nil,
+        # Before this updated_at timestamp.
+        filter_updated_at_lt: nil,
+        # At or before this updated_at timestamp.
+        filter_updated_at_lte: nil,
+        # Opaque cursor from meta.end_cursor.
+        page_after: nil,
+        # Opaque cursor from meta.start_cursor.
+        page_before: nil,
+        # Number of records per page.
+        page_size: nil,
+        # Comma-separated created_at or updated_at fields, optionally prefixed with - for
+        # descending order.
+        sort: nil,
+        request_options: {}
+      )
+      end
+
+      # Delete a connector by name in the authenticated organization. Both test and live
+      # connectors can be deleted. Returns no response body on success; a missing name
+      # or a connector in another organization returns 404.
+      sig do
+        params(
+          name: String,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).void
+      end
+      def delete(
+        # Connector name, not its UUID. URL-encode the name as a path segment.
+        name,
+        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/phone_numbers/csv_downloads.rbi

@@ -13,6 +13,7 @@ module Telnyx
               Telnyx::PhoneNumbers::CsvDownloadCreateParams::CsvFormat::OrSymbol,
             filter:
               Telnyx::PhoneNumbers::CsvDownloadCreateParams::Filter::OrHash,
+            include_managed_accounts: T::Boolean,
             request_options: Telnyx::RequestOptions::OrHash
           ).returns(Telnyx::Models::PhoneNumbers::CsvDownloadCreateResponse)
         end
@@ -26,6 +27,13 @@ module Telnyx
           # filter[voice.usage_payment_method], filter[billing_group_id],
           # filter[emergency_address_id], filter[customer_reference]
           filter: nil,
+          # When true, the CSV includes phone numbers from all managed accounts in addition
+          # to the requesting account's own numbers. Only applies to V2 format; ignored for
+          # V1. The export appends `user_id` and `email` columns identifying the account
+          # that owns each number. When a filter is provided, it applies to the combined set
+          # of numbers. Requires access to managed accounts; requests without that access
+          # are rejected.
+          include_managed_accounts: nil,
           request_options: {}
         )
         end

data/rbi/telnyx/resources/phone_numbers/jobs.rbi

@@ -34,7 +34,7 @@ module Telnyx
             request_options: Telnyx::RequestOptions::OrHash
           ).returns(
             Telnyx::Internal::DefaultFlatPagination[
-              Telnyx::PhoneNumbers::PhoneNumbersJob
+              Telnyx::PhoneNumbers::NumbersPhoneNumbersJob
             ]
           )
         end
@@ -104,7 +104,12 @@ module Telnyx
           billing_group_id: nil,
           # Body param: Identifies the connection associated with the phone number.
           connection_id: nil,
-          # Body param: A customer reference string for customer look ups.
+          # Body param: Sets the customer reference on the selected phone numbers and
+          # retains the supplied value on the job. Recover the job without its ID using GET
+          # /phone_numbers/jobs with filter[customer_reference] within 90 days of job
+          # creation. This body field updates the numbers; the separate
+          # filter[customer_reference] query parameter selects numbers by their current
+          # reference.
           customer_reference: nil,
           # Body param: Indicates whether to enable or disable the deletion lock on each
           # phone number. When enabled, this prevents the phone number from being deleted

data/rbi/telnyx/resources/speech_to_text.rbi

@@ -85,9 +85,10 @@ module Telnyx
         transcription_engine:,
         # Silence duration (in milliseconds) that triggers end-of-speech detection. When
         # set, the engine uses this value to determine when a speaker has stopped talking.
-        # Supported by `xAI`, `Deepgram`, `Google`, `Speechmatics`, and `Soniox`. `Soniox`
-        # accepts values between 500 and 3000. Other engines may not support this
-        # parameter.
+        # Supported by `xAI`, `Deepgram`, `Google`, `Speechmatics`
+        # (`speechmatics/standard` only; `speechmatics/linden-1` uses fixed service-side
+        # voice activity detection and ignores it), and `Soniox`. `Soniox` accepts values
+        # between 500 and 3000. Other engines may not support this parameter.
         endpointing: nil,
         # Whether to receive interim transcription results.
         interim_results: nil,
@@ -99,7 +100,12 @@ module Telnyx
         keywords: nil,
         # The language spoken in the audio stream. For `cohere/ar-stt`, this must be `ar`
         # or `en` — unlike other engines, Cohere does not auto-detect the language, and
-        # rejects unsupported values including `auto`; omitting it defaults to `ar`.
+        # rejects unsupported values including `auto`; omitting it defaults to `ar`. For
+        # `speechmatics/linden-1`, omitting it defaults to `en`; `auto`, `auto_beta`,
+        # `multi`, or a language outside its supported list is rejected when the
+        # connection is established. `speechmatics/linden-1` also accepts `en-US`,
+        # `en-GB`, `en-AU`, `cmn-Hans`, and `cmn-Hant`, which select the spelling or
+        # script variant (`en` alone uses the default spelling).
         language: nil,
         # The specific model to use within the selected transcription engine.
         model: nil,
@@ -109,6 +115,7 @@ module Telnyx
         # Audio sample rate in Hz. Required when `input_format` is a raw encoding
         # (`linear16`, `linear32`) — those formats carry no header metadata. Ignored for
         # container formats (`mp3`, `wav`), which self-describe their rate.
+        # `speechmatics/linden-1` accepts only `16000`.
         sample_rate: nil,
         request_options: {}
       )

data/rbi/telnyx/resources/spend_limits.rbi

@@ -25,6 +25,13 @@ module Telnyx
     #   completions, Responses, Anthropic Messages and classification requests;
     #   requests already running finish normally. Take the list of products from the
     #   list operation.
+    # - **API key limits.** For `inference`, a limit can also apply to one API key,
+    #   named by `credential_id`: the key's identifier as recorded on usage, never its
+    #   secret. When the key's spend goes above its own limit, only that key is
+    #   blocked, with the error title `API key spend limit reached` (code `10039`);
+    #   the account's other keys keep working. The API key limits of a period cannot
+    #   add up to more than the total limit when the total has an amount. Only
+    #   language-model requests authenticated with an API key count toward its limit.
     # - **Limits set by Telnyx.** Telnyx support can also set a limit on your account.
     #   It is listed with `origin: operator` and you can update or delete it like your
     #   own.
@@ -33,7 +40,9 @@ module Telnyx
       # `amount` and `unlimited: true`. The period's spend is checked at once: if it is
       # already above the new limit, the product is blocked immediately
       # (`evaluation.blocked_now`). Returns 409 when a limit already exists for the
-      # product and period; update it instead.
+      # product and period; update it instead. With `credential_id`, the limit applies
+      # to that API key only: it needs an `amount`, and the period's API key limits
+      # cannot add up to more than the total limit when the total has an amount.
       sig do
         params(
           body:
@@ -56,6 +65,9 @@ module Telnyx
       # once: raising the limit above the spend lifts the period's block
       # (`evaluation.released`), and lowering it below the spend blocks the product
       # (`evaluation.blocked_now`). Returns 404 when no limit is set; create it instead.
+      # With the `credential_id` query parameter, the request changes that API key's
+      # limit; it needs an `amount`, and it can be at most the period's total limit.
+      # Lowering the total limit below the period's highest API key limit is refused.
       sig do
         params(
           product: String,
@@ -64,6 +76,7 @@ module Telnyx
               Telnyx::SpendLimitUpdateParams::Body::UpdateSpendLimitWithAmount::OrHash,
               Telnyx::SpendLimitUpdateParams::Body::UpdateSpendLimitUnlimited::OrHash
             ),
+          credential_id: String,
           period: Telnyx::SpendLimitPeriod::OrSymbol,
           request_options: Telnyx::RequestOptions::OrHash
         ).returns(Telnyx::SpendLimitResponse)
@@ -74,6 +87,10 @@ module Telnyx
         product,
         # Body param: Send exactly one of `amount` and `unlimited: true`.
         body:,
+        # Query param: Identifier of one API key as recorded on usage, never the key's
+        # secret, percent-encoded: the request is then about that key's limit. Absent
+        # means the total limit; present but blank is refused.
+        credential_id: nil,
         # Query param: Limit period. Defaults to `daily`; send it explicitly.
         period: nil,
         request_options: {}
@@ -84,7 +101,9 @@ module Telnyx
       # the spend so far in the period and whether the product is blocked. An entry
       # without a limit is still listed (`limit: null`). When the spend cannot be read,
       # the entry is returned with `spend_usd: null` and `spend_error` set. The list is
-      # not paginated.
+      # not paginated. Each entry also lists the API key limits of its product and
+      # period in `credential_limits`, with each key's spend and block. Each API key
+      # limit can be at most the total limit; together they may add up to more than it.
       sig do
         params(request_options: Telnyx::RequestOptions::OrHash).returns(
           Telnyx::Models::SpendLimitListResponse
@@ -97,10 +116,15 @@ module Telnyx
       # default limit, the product becomes unlimited for the period and the period's
       # block is lifted (`evaluation.released`). The response carries `limit: null` and
       # the `effective_limit_usd` that applies after the removal. Returns 404 when no
-      # limit is set.
+      # limit is set. With the `credential_id` query parameter, the request removes that
+      # API key's limit for the period and lifts the key's block in that period at once.
+      # A block under the key's limit in the other period stays
+      # (`evaluation.still_blocked_other_period`). Removing the total limit leaves the
+      # API key limits in place.
       sig do
         params(
           product: String,
+          credential_id: String,
           period: Telnyx::SpendLimitPeriod::OrSymbol,
           reason: String,
           request_options: Telnyx::RequestOptions::OrHash
@@ -109,6 +133,10 @@ module Telnyx
       def delete(
         # Product the limit applies to, as returned in `product` by the list operation.
         product,
+        # Identifier of one API key as recorded on usage, never the key's secret,
+        # percent-encoded: the request is then about that key's limit. Absent means the
+        # total limit; present but blank is refused.
+        credential_id: nil,
         # Limit period. Defaults to `daily`; send it explicitly.
         period: nil,
         # Why the limit is removed, kept for audit. At most 500 characters.

data/rbi/telnyx/resources/tailscale_subnet_routers.rbi

@@ -0,0 +1,134 @@
+# typed: strong
+
+module Telnyx
+  module Resources
+    # Tailscale Subnet Router operations
+    class TailscaleSubnetRouters
+      # Creates a Tailscale Subnet Router on a Network and enrolls it in the user's
+      # tailnet with the auth key. The response returns the router with `status`
+      # `provisioning`. Poll `GET /tailscale_subnet_routers/{id}` until it is
+      # `provisioned`. Then approve its routes in the tailnet, unless an auto-approver
+      # covers them.
+      sig do
+        params(
+          advertised_routes: T::Array[String],
+          auth_key: String,
+          name: String,
+          network_id: String,
+          region_code: String,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(Telnyx::Models::TailscaleSubnetRouterCreateResponse)
+      end
+      def create(
+        # IPv4 subnets of the Network that the router advertises to the tailnet. Each
+        # entry is a canonical CIDR that the Network routes. Default, loopback,
+        # link-local, multicast, and Tailscale (`100.64.0.0/10`) ranges are rejected. So
+        # are ranges that overlap the router's own, `172.27.254.0/24` and `198.18.0.0/20`.
+        advertised_routes:,
+        # A Tailscale auth key that enrolls the router in the user's tailnet: reusable,
+        # pre-approved, tagged, and not ephemeral. Telnyx stores it encrypted until
+        # enrollment succeeds, then discards it. It is never returned.
+        auth_key:,
+        # A user specified name for the router.
+        name:,
+        # The id of the Network to attach the router to.
+        network_id:,
+        # The code of the region to create the router in. `GET /network_coverage` lists
+        # the regions whose `available_services` include `tailscale_subnet_router`.
+        region_code:,
+        request_options: {}
+      )
+      end
+
+      # Returns the details of a single Tailscale Subnet Router by its identifier,
+      # including its enrollment state.
+      sig do
+        params(
+          id: String,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(Telnyx::Models::TailscaleSubnetRouterRetrieveResponse)
+      end
+      def retrieve(
+        # Identifies the resource.
+        id,
+        request_options: {}
+      )
+      end
+
+      # Renames the router, changes its advertised routes, or retries a failed
+      # enrollment. Any change queues a new provisioning run and returns the router with
+      # `status` `provisioning`. The router keeps its machine identity on the tailnet.
+      # Send an empty object to retry a `failed` router with its stored auth key.
+      # Include a new `auth_key` only while the router has never enrolled. The router's
+      # Network and region cannot change: create a new router instead.
+      sig do
+        params(
+          id: String,
+          advertised_routes: T::Array[String],
+          auth_key: String,
+          name: String,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(Telnyx::Models::TailscaleSubnetRouterUpdateResponse)
+      end
+      def update(
+        # Identifies the resource.
+        id,
+        # IPv4 subnets of the Network that the router advertises to the tailnet. Each
+        # entry is a canonical CIDR that the Network routes. Default, loopback,
+        # link-local, multicast, and Tailscale (`100.64.0.0/10`) ranges are rejected. So
+        # are ranges that overlap the router's own, `172.27.254.0/24` and `198.18.0.0/20`.
+        advertised_routes: nil,
+        # A replacement Tailscale auth key. Accepted only while the router has never
+        # enrolled, for example after a `failed` enrollment. Never returned.
+        auth_key: nil,
+        # A user specified name for the router.
+        name: nil,
+        request_options: {}
+      )
+      end
+
+      # Returns a paginated list of the Tailscale Subnet Routers on the account, with
+      # support for filtering by Network.
+      sig do
+        params(
+          filter: Telnyx::TailscaleSubnetRouterListParams::Filter::OrHash,
+          page_number: Integer,
+          page_size: Integer,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(
+          Telnyx::Internal::DefaultFlatPagination[Telnyx::TailscaleSubnetRouter]
+        )
+      end
+      def list(
+        # Consolidated filter parameter (deepObject style). Originally: filter[network_id]
+        filter: nil,
+        page_number: nil,
+        page_size: nil,
+        request_options: {}
+      )
+      end
+
+      # Removes the router from the Network and logs it out of the tailnet. The response
+      # returns the router with `status` `deleting`. The record disappears once removal
+      # completes. A machine entry can remain in the tailnet's admin console until it is
+      # removed there.
+      sig do
+        params(
+          id: String,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(Telnyx::Models::TailscaleSubnetRouterDeleteResponse)
+      end
+      def delete(
+        # Identifies the resource.
+        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/telephony_credentials.rbi

@@ -106,12 +106,18 @@ module Telnyx
       sig do
         params(
           id: String,
+          idempotency_key: String,
           request_options: Telnyx::RequestOptions::OrHash
         ).returns(String)
       end
       def create_token(
         # Identifies the resource.
         id,
+        # Unique key for safely retrying the same logical request. Generate a UUID v4 for
+        # each operation and reuse it only when retrying that operation with the same
+        # request body. Valid characters: A-Z, a-z, 0-9, -, and \_. Length: 1-255
+        # characters. Do not include sensitive data in the key.
+        idempotency_key: nil,
         request_options: {}
       )
       end

data/rbi/telnyx/resources/texml/accounts/calls/recordings.rbi

@@ -23,7 +23,12 @@ module Telnyx
             def recording_sid_json(
               # Path param: Uniquely identifies the recording by id.
               recording_sid,
-              # Path param: The id of the account the resource belongs to.
+              # Path param: The UUID of the Telnyx account that owns the resource, for example
+              # `f5586561-8ff0-4291-a51b-c7dfe4139ff9`. The `account_sid` path segment is kept
+              # for Twilio API compatibility, but the value is a Telnyx account UUID, not a
+              # Twilio `AC...` SID. It must match the account that owns the API key used to
+              # authenticate the request, otherwise the endpoint returns `404`. The same value
+              # is sent as `AccountSid` in TeXML webhooks.
               account_sid:,
               # Path param: The CallSid that identifies the call to update.
               call_sid:,

data/rbi/telnyx/resources/texml/accounts/calls/recordings_json.rbi

@@ -30,7 +30,12 @@ module Telnyx
             def recordings_json(
               # Path param: The CallSid that identifies the call to update.
               call_sid,
-              # Path param: The id of the account the resource belongs to.
+              # Path param: The UUID of the Telnyx account that owns the resource, for example
+              # `f5586561-8ff0-4291-a51b-c7dfe4139ff9`. The `account_sid` path segment is kept
+              # for Twilio API compatibility, but the value is a Telnyx account UUID, not a
+              # Twilio `AC...` SID. It must match the account that owns the API key used to
+              # authenticate the request, otherwise the endpoint returns `404`. The same value
+              # is sent as `AccountSid` in TeXML webhooks.
               account_sid:,
               # Body param: Whether to play a beep when recording is started.
               play_beep: nil,
@@ -66,7 +71,12 @@ module Telnyx
             def retrieve_recordings_json(
               # The CallSid that identifies the call to update.
               call_sid,
-              # The id of the account the resource belongs to.
+              # The UUID of the Telnyx account that owns the resource, for example
+              # `f5586561-8ff0-4291-a51b-c7dfe4139ff9`. The `account_sid` path segment is kept
+              # for Twilio API compatibility, but the value is a Telnyx account UUID, not a
+              # Twilio `AC...` SID. It must match the account that owns the API key used to
+              # authenticate the request, otherwise the endpoint returns `404`. The same value
+              # is sent as `AccountSid` in TeXML webhooks.
               account_sid:,
               request_options: {}
             )

data/rbi/telnyx/resources/texml/accounts/calls/siprec.rbi

@@ -23,7 +23,12 @@ module Telnyx
             def siprec_sid_json(
               # Path param: The SiprecSid that uniquely identifies the Sip Recording.
               siprec_sid,
-              # Path param: The id of the account the resource belongs to.
+              # Path param: The UUID of the Telnyx account that owns the resource, for example
+              # `f5586561-8ff0-4291-a51b-c7dfe4139ff9`. The `account_sid` path segment is kept
+              # for Twilio API compatibility, but the value is a Telnyx account UUID, not a
+              # Twilio `AC...` SID. It must match the account that owns the API key used to
+              # authenticate the request, otherwise the endpoint returns `404`. The same value
+              # is sent as `AccountSid` in TeXML webhooks.
               account_sid:,
               # Path param: The CallSid that identifies the call to update.
               call_sid:,

data/rbi/telnyx/resources/texml/accounts/calls/streams.rbi

@@ -23,7 +23,12 @@ module Telnyx
             def streaming_sid_json(
               # Path param: Uniquely identifies the streaming by id.
               streaming_sid,
-              # Path param: The id of the account the resource belongs to.
+              # Path param: The UUID of the Telnyx account that owns the resource, for example
+              # `f5586561-8ff0-4291-a51b-c7dfe4139ff9`. The `account_sid` path segment is kept
+              # for Twilio API compatibility, but the value is a Telnyx account UUID, not a
+              # Twilio `AC...` SID. It must match the account that owns the API key used to
+              # authenticate the request, otherwise the endpoint returns `404`. The same value
+              # is sent as `AccountSid` in TeXML webhooks.
               account_sid:,
               # Path param: The CallSid that identifies the call to update.
               call_sid:,