telnyx 5.170.0 → 5.173.0

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:,

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

@@ -36,7 +36,12 @@ module Telnyx
           def retrieve(
             # 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: {}
           )
@@ -64,7 +69,12 @@ module Telnyx
           def update(
             # 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: HTTP request type used for `FallbackUrl`.
             fallback_method: nil,
@@ -91,7 +101,7 @@ module Telnyx
           end
 
           # Initiate an outbound TeXML call. Telnyx will request TeXML from the XML Request
-          # URL configured for the connection in the Mission Control Portal.
+          # URL configured for the TeXML Application in the Mission Control Portal.
           sig do
             params(
               account_sid: String,
@@ -105,7 +115,12 @@ module Telnyx
             ).returns(Telnyx::Models::Texml::Accounts::CallCallsResponse)
           end
           def calls(
-            # 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,
             body:,
             request_options: {}
@@ -136,7 +151,12 @@ module Telnyx
             )
           end
           def retrieve_calls(
-            # 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,
             # Filters calls by their end date. Expected format is YYYY-MM-DD
             end_time: nil,
@@ -193,7 +213,12 @@ module Telnyx
           def siprec_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: The name of the connector to use for the SIPREC session.
             connector_name: nil,
@@ -247,7 +272,12 @@ module Telnyx
           def streams_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: Indicates codec for bidirectional streaming RTP payloads. Used only
             # with stream_bidirectional_mode=rtp. Case sensitive.

data/rbi/telnyx/resources/texml/accounts/conferences/participants.rbi

@@ -22,7 +22,12 @@ module Telnyx
             def retrieve(
               # CallSid or Label of the Participant to update.
               call_sid_or_participant_label,
-              # 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:,
               # The ConferenceSid that uniquely identifies a conference.
               conference_sid:,
@@ -58,7 +63,12 @@ module Telnyx
             def update(
               # Path param: CallSid or Label of the Participant to update.
               call_sid_or_participant_label,
-              # 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 ConferenceSid that uniquely identifies a conference.
               conference_sid:,
@@ -111,7 +121,12 @@ module Telnyx
             def delete(
               # CallSid or Label of the Participant to update.
               call_sid_or_participant_label,
-              # 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:,
               # The ConferenceSid that uniquely identifies a conference.
               conference_sid:,
@@ -205,7 +220,12 @@ module Telnyx
             def participants(
               # Path param: The ConferenceSid that uniquely identifies a conference.
               conference_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: The URL the result of answering machine detection will be sent to.
               amd_status_callback: nil,
@@ -403,7 +423,12 @@ module Telnyx
             def retrieve_participants(
               # The ConferenceSid that uniquely identifies a conference.
               conference_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/conferences.rbi

@@ -25,7 +25,12 @@ module Telnyx
           def retrieve(
             # The ConferenceSid that uniquely identifies a conference.
             conference_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: {}
           )
@@ -47,7 +52,12 @@ module Telnyx
           def update(
             # Path param: The ConferenceSid that uniquely identifies a conference.
             conference_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: The HTTP method used to call the `AnnounceUrl`. Defaults to `POST`.
             announce_method: nil,
@@ -81,7 +91,12 @@ module Telnyx
             )
           end
           def retrieve_conferences(
-            # 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,
             # Filters conferences by the creation date. Expected format is YYYY-MM-DD. Also
             # accepts inequality operators, e.g. DateCreated>=2023-05-22.
@@ -117,7 +132,12 @@ module Telnyx
           def retrieve_recordings(
             # The ConferenceSid that uniquely identifies a conference.
             conference_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: {}
           )
@@ -136,7 +156,12 @@ module Telnyx
           def retrieve_recordings_json(
             # The ConferenceSid that uniquely identifies a conference.
             conference_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/queues.rbi

@@ -17,7 +17,12 @@ module Telnyx
             ).returns(Telnyx::Texml::Accounts::QueueResource)
           end
           def create(
-            # 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,
             # A human readable name for the queue.
             friendly_name: nil,
@@ -38,7 +43,12 @@ module Telnyx
           def retrieve(
             # The QueueSid that identifies the call queue.
             queue_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: {}
           )
@@ -56,7 +66,12 @@ module Telnyx
           def update(
             # Path param: The QueueSid that identifies the call queue.
             queue_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: The maximum size of the queue.
             max_size: nil,
@@ -82,7 +97,12 @@ module Telnyx
             )
           end
           def list(
-            # 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,
             # Filters conferences by the creation date. Expected format is YYYY-MM-DD. Also
             # accepts inequality operators, e.g. DateCreated>=2023-05-22.
@@ -112,7 +132,12 @@ module Telnyx
           def delete(
             # The QueueSid that identifies the call queue.
             queue_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/recordings/json.rbi

@@ -18,7 +18,12 @@ module Telnyx
             def delete_recording_sid_json(
               # Uniquely identifies the recording by id.
               recording_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: {}
             )
@@ -35,7 +40,12 @@ module Telnyx
             def retrieve_recording_sid_json(
               # Uniquely identifies the recording by id.
               recording_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/transcriptions/json.rbi

@@ -18,7 +18,12 @@ module Telnyx
             def delete_recording_transcription_sid_json(
               # Uniquely identifies the recording transcription by id.
               recording_transcription_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: {}
             )
@@ -37,7 +42,12 @@ module Telnyx
             def retrieve_recording_transcription_sid_json(
               # Uniquely identifies the recording transcription by id.
               recording_transcription_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.rbi

@@ -36,7 +36,12 @@ module Telnyx
           )
         end
         def retrieve_recordings_json(
-          # 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,
           # Filters recording by the creation date. Expected format is ISO8601 date or
           # date-time, ie. {YYYY}-{MM}-{DD} or {YYYY}-{MM}-{DD}T{hh}:{mm}:{ss}Z. Also
@@ -63,7 +68,12 @@ module Telnyx
           )
         end
         def retrieve_transcriptions_json(
-          # 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,
           # The number of records to be displayed on a page
           page_size: nil,

data/rbi/telnyx/resources/texml.rbi

@@ -12,8 +12,10 @@ module Telnyx
       sig { returns(Telnyx::Resources::Texml::Accounts) }
       attr_reader :accounts
 
-      # Initiate an outbound AI call with warm-up support. Validates parameters, builds
-      # an internal TeXML with an AI Assistant configuration, encodes instructions into
+      # Initiate an outbound AI call with warm-up support: Telnyx attempts to warm up
+      # the assistant identified by `AIAssistantId` before placing the call and starts
+      # it automatically when the called party answers. Validates parameters, builds an
+      # internal TeXML with an AI Assistant configuration, encodes instructions into
       # client state, and calls the dial API. The Twiml, Texml, and Url parameters are
       # not allowed and will result in a 422 error.
       #
@@ -94,7 +96,9 @@ module Telnyx
       def initiate_ai_call(
         # The ID of the TeXML connection to use for the call.
         connection_id,
-        # The ID of the AI assistant to use for the call.
+        # The ID of the AI assistant to use for the call. Telnyx attempts to warm up this
+        # assistant before the call is placed and starts it automatically when the called
+        # party answers.
         ai_assistant_id:,
         # The phone number of the party initiating the call. Phone numbers are formatted
         # with a `+` and country code.