telnyx 5.171.0 → 5.174.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e1eabbc18cbdcb3524c61c95fe397dcb5494ddd06459ce4a5ed448a3106db8f2
-  data.tar.gz: 417b20a6222b040c3e32bc0b9c998fd49d868e2b2f70c692a74c5cb9f6ece6d6
+  metadata.gz: 3fac885ac7ccf74c3f9f991d7dca38d2155d645e1a24cbfb8fa849ff010f78b7
+  data.tar.gz: 75d6ae4f9f701214078d8c9e7a43258b677bb82a29074a26634beaa2c4628738
 SHA512:
-  metadata.gz: 8810ee7b9c133dbdad93e500f9201f5350b55a2ab98bb9ae6956051c3ab09faca197debaff9b79ad13075c28140d7ce5e655069a78e689c296bf61e04c9a510c
-  data.tar.gz: b281a7590d994e86acfbf3c2c59166040e2f1ba42cacb4789d08301f2496b2416becf64fa04c898e7c04314ebeb198c2b00ab9b836659ccf78ad9bdba2f02d29
+  metadata.gz: 137fadbbd6825fe3335c3dc2aad76145d5c9af2c693023ca98905d63ca5ffd87f71d2b3ea56ae6ba0a744cb5d5c09fd2bf6219aad7ae960ed9bd9e3712feaaf0
+  data.tar.gz: 5b42c035897d4698f6ae5c7e6c20ce6305d8dbd7227927305e5825cc5215c587d73b7c5825432c423ff0517943b71d1b804aa88e5d5bda93ed86fc560ae0f5c5

data/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## [5.174.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.173.0...v5.174.0) (2026-10-29)
+
+
+### Features
+
+* promote from staging 458522c ([15f8625](https://github.com/team-telnyx/telnyx-ruby/commit/15f86251ff7ccfc9ec222355907441ddc10b1b07))
+
+## [5.173.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.172.0...v5.173.0) (2026-10-28)
+
+
+### Features
+
+* promote from staging 6dcdded ([54c3e0b](https://github.com/team-telnyx/telnyx-ruby/commit/54c3e0b38f0b1d953bcb966787628c8e7313d451))
+
+## [5.172.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.171.0...v5.172.0) (2026-10-22)
+
+
+### Features
+
+* promote from staging e2b22f0 ([995efb3](https://github.com/team-telnyx/telnyx-ruby/commit/995efb3971f0bc50e755ae33d237f16b6eef5130))
+
 ## [5.171.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.170.0...v5.171.0) (2026-10-14)
 
 

data/README.md

@@ -24,7 +24,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "telnyx", "~> 5.171.0"
+gem "telnyx", "~> 5.174.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/telnyx/client.rb

@@ -27,6 +27,9 @@ module Telnyx
     # @return [String, nil]
     attr_reader :client_secret
 
+    # @return [Telnyx::Resources::BrowserSessions]
+    attr_reader :browser_sessions
+
     # @return [Telnyx::Resources::Legacy]
     attr_reader :legacy
 
@@ -735,6 +738,7 @@ module Telnyx
     # @return [Telnyx::Resources::ExternalRequirements]
     attr_reader :external_requirements
 
+    # Inspect Stateful Actor types
     # @return [Telnyx::Resources::Compute]
     attr_reader :compute
 
@@ -796,6 +800,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.
@@ -809,6 +820,34 @@ module Telnyx
     # @return [Telnyx::Resources::SipRegistrationStatus]
     attr_reader :sip_registration_status
 
+    # Call information
+    # @return [Telnyx::Resources::DialMetrics]
+    attr_reader :dial_metrics
+
+    # Tailscale Subnet Router operations
+    # @return [Telnyx::Resources::TailscaleSubnetRouters]
+    attr_reader :tailscale_subnet_routers
+
+    # Download screenshots and other artifacts.
+    # @return [Telnyx::Resources::ArtifactDownloads]
+    attr_reader :artifact_downloads
+
+    # @return [Telnyx::Resources::Email]
+    attr_reader :email
+
+    # Routes on a Network that send a CIDR to a next hop, such as a tunnel.
+    # @return [Telnyx::Resources::NetworkRoutes]
+    attr_reader :network_routes
+
+    # Generic payment connector configuration.
+    # @return [Telnyx::Resources::PayConnectors]
+    attr_reader :pay_connectors
+
+    # Tunnels connect a Network to hosts behind a tunnel process within the user's
+    # network.
+    # @return [Telnyx::Resources::Tunnels]
+    attr_reader :tunnels
+
     # @api private
     #
     # @return [Hash{String=>String}]
@@ -917,6 +956,7 @@ module Telnyx
         headers: headers
       )
 
+      @browser_sessions = Telnyx::Resources::BrowserSessions.new(client: self)
       @legacy = Telnyx::Resources::Legacy.new(client: self)
       @oauth = Telnyx::Resources::OAuth.new(client: self)
       @oauth_clients = Telnyx::Resources::OAuthClients.new(client: self)
@@ -1109,6 +1149,13 @@ module Telnyx
       @spend_limits = Telnyx::Resources::SpendLimits.new(client: self)
       @llm_token_gateway = Telnyx::Resources::LlmTokenGateway.new(client: self)
       @sip_registration_status = Telnyx::Resources::SipRegistrationStatus.new(client: self)
+      @dial_metrics = Telnyx::Resources::DialMetrics.new(client: self)
+      @tailscale_subnet_routers = Telnyx::Resources::TailscaleSubnetRouters.new(client: self)
+      @artifact_downloads = Telnyx::Resources::ArtifactDownloads.new(client: self)
+      @email = Telnyx::Resources::Email.new(client: self)
+      @network_routes = Telnyx::Resources::NetworkRoutes.new(client: self)
+      @pay_connectors = Telnyx::Resources::PayConnectors.new(client: self)
+      @tunnels = Telnyx::Resources::Tunnels.new(client: self)
     end
   end
 end

data/lib/telnyx/lib/access_token.rb

@@ -0,0 +1,141 @@
+# frozen_string_literal: true
+
+require "base64"
+require "json"
+require "openssl"
+
+module Telnyx
+  module Lib
+    # Mints a WebRTC login token for a telephony credential locally, with no
+    # request to Telnyx.
+    #
+    # The token has the same shape as the one `POST /v2/telephony_credentials/:id/token`
+    # (`client.telephony_credentials.create_token`) returns, so it is used the
+    # same way: pass it to the WebRTC SDK as `login_token`. Telnyx verifies it
+    # on login.
+    #
+    # The signing material comes from the credential: `token_material` is in the
+    # response of `POST /v2/telephony_credentials` and of
+    # `GET /v2/telephony_credentials/:id/token_material`. It is as sensitive as
+    # the SIP password, so keep it on the server; never ship it to a browser.
+    #
+    #   credential = client.telephony_credentials.create(connection_id: "123")
+    #   client.telephony_credentials.to_jwt(credential)            # 1 hour
+    #   client.telephony_credentials.to_jwt(credential, ttl: 600)  # 10 minutes
+    #
+    # Or from stored values, with no client at all:
+    #
+    #   Telnyx::Lib::AccessToken.new(
+    #     credential_id: "...", user_id: "...", identity: "gencred...",
+    #     expires_at: "2027-01-01T00:00:00Z",
+    #     token_material: {kid: "v1", tel_token: "...", signing_secret: "..."}
+    #   ).to_jwt
+    class AccessToken
+      DEFAULT_TTL = 3600
+      MAX_TTL = 86_400
+      CONTENT_TYPE = "telnyx-webrtc;v=1"
+      ALGORITHM = "HS256"
+      MATERIAL_FIELDS = [:kid, :tel_token, :signing_secret].freeze
+
+      # Raised by {AccessToken.decode} when the signature does not match.
+      class SignatureError < StandardError
+      end
+
+      attr_reader :credential_id, :user_id, :identity, :expires_at, :ttl
+
+      # @param credential_id [String] the telephony credential `id`
+      # @param user_id [String] the credential's `user_id`
+      # @param identity [String] the credential's `sip_username`
+      # @param token_material [Hash, Telnyx::Internal::Type::BaseModel] `kid`, `tel_token`, `signing_secret`
+      # @param expires_at [String, nil] the credential's `expires_at`, as the API returns it
+      # @param ttl [Integer] token lifetime in seconds, 1..86400; default one hour
+      def initialize(credential_id:, user_id:, identity:, token_material:, expires_at: nil, ttl: DEFAULT_TTL)
+        @credential_id = required(credential_id, "credential_id")
+        @user_id = required(user_id, "user_id")
+        @identity = required(identity, "identity")
+        @expires_at = expires_at
+        @material = normalize_material(token_material)
+        @ttl = Integer(ttl).clamp(1, MAX_TTL)
+      end
+
+      # The signed token, valid from `now` for `ttl` seconds.
+      #
+      # @param now [Time]
+      #
+      # @return [String]
+      def to_jwt(now: Time.now)
+        iat = now.to_i
+        header = {alg: ALGORITHM, typ: "JWT", cty: CONTENT_TYPE, kid: @material.fetch(:kid)}
+        payload = {
+          sub: credential_id,
+          user_id: user_id,
+          identity: identity,
+          cred_exp: expires_at,
+          tel_token: @material.fetch(:tel_token),
+          iat: iat,
+          nbf: iat,
+          exp: iat + ttl,
+          jti: "#{credential_id}-#{iat}"
+        }
+
+        signing_input = "#{encode(JSON.generate(header))}.#{encode(JSON.generate(payload))}"
+        "#{signing_input}.#{encode(self.class.sign(signing_input, @material.fetch(:signing_secret)))}"
+      end
+
+      alias_method :to_s, :to_jwt
+
+      class << self
+        # Decodes a token minted by this class and checks its signature against
+        # `signing_secret`. Meant for tests and debugging: Telnyx does the real
+        # verification on login.
+        #
+        # @param jwt [String]
+        # @param signing_secret [String] base64url, as in `token_material`
+        #
+        # @raise [Telnyx::Lib::AccessToken::SignatureError] if the signature does not match
+        # @return [Hash{String=>Object}] the claims
+        def decode(jwt, signing_secret:)
+          head, body, sig = jwt.to_s.split(".")
+          raise ArgumentError.new("not a JWT") if sig.nil?
+
+          expected = sign("#{head}.#{body}", signing_secret)
+          given = Base64.urlsafe_decode64(sig)
+          valid = given.bytesize == expected.bytesize && OpenSSL.fixed_length_secure_compare(given, expected)
+          raise SignatureError.new("signature does not match the payload") unless valid
+
+          JSON.parse(Base64.urlsafe_decode64(body))
+        end
+
+        # @param signing_input [String]
+        # @param signing_secret [String] base64url
+        #
+        # @return [String] raw HMAC-SHA256 bytes
+        def sign(signing_input, signing_secret)
+          OpenSSL::HMAC.digest("SHA256", Base64.urlsafe_decode64(signing_secret), signing_input)
+        end
+      end
+
+      private
+
+      def encode(bytes) = Base64.urlsafe_encode64(bytes, padding: false)
+
+      def required(value, name)
+        raise ArgumentError.new("#{name} is required to mint a token") if value.nil? || value.to_s.empty?
+
+        value.to_s
+      end
+
+      def normalize_material(material)
+        hash = material.respond_to?(:to_hash) ? material.to_hash : material
+        raise ArgumentError.new("token_material is required to mint a token") unless hash.is_a?(Hash)
+
+        MATERIAL_FIELDS.to_h do |field|
+          value = hash[field] || hash[field.to_s]
+          raise ArgumentError.new("token_material.#{field} is missing") if value.nil? || value.to_s.empty?
+
+          [field, value.to_s]
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/lib/telephony_credentials.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+require_relative "access_token"
+
+module Telnyx
+  module Lib
+    # Local WebRTC login tokens for `client.telephony_credentials`. Mixed into
+    # the generated {Telnyx::Resources::TelephonyCredentials} from `lib/telnyx/lib.rb`,
+    # so it survives codegen.
+    module TelephonyCredentials
+      # A WebRTC login token for a credential, minted locally with no request
+      # to Telnyx per token. Same use as `create_token`: hand it to the WebRTC
+      # SDK as `login_token`.
+      #
+      # The signing material (`kid`, `tel_token`, `signing_secret`) is read from
+      # the credential's `token_material`, present on the `create` response. A
+      # credential given by id, or one from `retrieve` or `list`, fetches it
+      # with {#fetch_token_material}. Pass `token_material:` to mint from values
+      # stored earlier, with no request at all.
+      #
+      # @param credential [String, Telnyx::Models::TelephonyCredential, Telnyx::Models::TelephonyCredentialCreateResponse, Telnyx::Models::TelephonyCredentialRetrieveResponse]
+      #   the credential id, the credential, or the `create` / `retrieve` response holding it
+      #
+      # @param ttl [Integer] token lifetime in seconds, 1..86400; default one hour
+      #
+      # @param token_material [Hash{Symbol=>String}, nil] `kid`, `tel_token`, `signing_secret` stored earlier
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [String]
+      def to_jwt(
+        credential,
+        ttl: Telnyx::Lib::AccessToken::DEFAULT_TTL,
+        token_material: nil,
+        request_options: {}
+      )
+        model = credential_model(credential, request_options: request_options)
+        material = token_material || model[:token_material] ||
+                   fetch_token_material(model.id, request_options: request_options)
+
+        Telnyx::Lib::AccessToken.new(
+          credential_id: model.id,
+          user_id: model.user_id,
+          identity: model.sip_username,
+          expires_at: model.expires_at,
+          token_material: material,
+          ttl: ttl
+        ).to_jwt
+      end
+
+      # `GET /v2/telephony_credentials/:id/token_material`. Treat the result
+      # like the SIP password: keep it on the server.
+      #
+      # @param id [String] Identifies the resource.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Hash{Symbol=>Object}] `kid`, `tel_token`, `signing_secret`
+      def fetch_token_material(id, request_options: {})
+        body = @client.request(
+          method: :get,
+          path: ["telephony_credentials/%1$s/token_material", id],
+          model: Telnyx::Internal::Type::Unknown,
+          options: request_options
+        )
+        body.is_a?(Hash) && body.key?(:data) ? body.fetch(:data) : body
+      end
+
+      private
+
+      # @return [Telnyx::Models::TelephonyCredential]
+      def credential_model(credential, request_options:)
+        model = credential.respond_to?(:data) ? credential.data : credential
+        model = retrieve(model, request_options: request_options).data if model.is_a?(String)
+        return model if model.is_a?(Telnyx::Models::TelephonyCredential)
+
+        raise ArgumentError.new("expected a telephony credential or its id, got #{credential.inspect}")
+      end
+    end
+  end
+
+  module Resources
+    class TelephonyCredentials
+      include Telnyx::Lib::TelephonyCredentials
+    end
+  end
+end

data/lib/telnyx/lib.rb

@@ -14,3 +14,5 @@
 require_relative "lib/webhook_verification_error"
 require_relative "lib/webhook_verification"
 require_relative "lib/websocket"
+require_relative "lib/access_token"
+require_relative "lib/telephony_credentials"

data/lib/telnyx/models/address.rb

@@ -127,7 +127,11 @@ module Telnyx
       #   have used the `/addresses/actions/validate` endpoint to validate the address
       #   separately prior to creation. If an address is not validated for emergency use
       #   upon creation and it is not valid, it will not be able to be used for emergency
-      #   services.
+      #   services. In an address record, this flag indicates whether emergency validation
+      #   was performed at creation: `true` means the record passed emergency validation
+      #   before it was created; `false` means validation was skipped during this creation
+      #   request, and the address may have been validated separately. This flag is not a
+      #   current validity status; emergency use still requires a valid address.
       #
       #   @return [Boolean, nil]
       optional :validate_address, Telnyx::Internal::Type::Boolean

data/lib/telnyx/models/address_create_params.rb

@@ -106,7 +106,11 @@ module Telnyx
       #   have used the `/addresses/actions/validate` endpoint to validate the address
       #   separately prior to creation. If an address is not validated for emergency use
       #   upon creation and it is not valid, it will not be able to be used for emergency
-      #   services.
+      #   services. In an address record, this flag indicates whether emergency validation
+      #   was performed at creation: `true` means the record passed emergency validation
+      #   before it was created; `false` means validation was skipped during this creation
+      #   request, and the address may have been validated separately. This flag is not a
+      #   current validity status; emergency use still requires a valid address.
       #
       #   @return [Boolean, nil]
       optional :validate_address, Telnyx::Internal::Type::Boolean

data/lib/telnyx/models/addresses/action_validate_response.rb

@@ -16,7 +16,6 @@ module Telnyx
         # @see Telnyx::Models::Addresses::ActionValidateResponse#data
         class Data < Telnyx::Internal::Type::BaseModel
           # @!attribute result
-          #   Indicates whether an address is valid or invalid.
           #
           #   @return [Symbol, Telnyx::Models::Addresses::ActionValidateResponse::Data::Result]
           required :result, enum: -> { Telnyx::Models::Addresses::ActionValidateResponse::Data::Result }
@@ -39,7 +38,7 @@ module Telnyx
           optional :record_type, String
 
           # @!method initialize(result:, suggested:, errors: nil, record_type: nil)
-          #   @param result [Symbol, Telnyx::Models::Addresses::ActionValidateResponse::Data::Result] Indicates whether an address is valid or invalid.
+          #   @param result [Symbol, Telnyx::Models::Addresses::ActionValidateResponse::Data::Result]
           #
           #   @param suggested [Telnyx::Models::Addresses::ActionValidateResponse::Data::Suggested] Provides normalized address when available.
           #
@@ -47,14 +46,11 @@ module Telnyx
           #
           #   @param record_type [String] Identifies the type of the resource.
 
-          # Indicates whether an address is valid or invalid.
-          #
           # @see Telnyx::Models::Addresses::ActionValidateResponse::Data#result
           module Result
             extend Telnyx::Internal::Type::Enum
 
             VALID = :valid
-            INVALID = :invalid
 
             # @!method self.values
             #   @return [Array<Symbol>]
@@ -69,6 +65,13 @@ module Telnyx
             #   @return [String, nil]
             optional :administrative_area, String
 
+            # @!attribute borough
+            #   The borough of the address. This field is not used for addresses in the US but
+            #   is used for some international addresses.
+            #
+            #   @return [String, nil]
+            optional :borough, String
+
             # @!attribute country_code
             #   The two-character (ISO 3166-1 alpha-2) country code of the address.
             #
@@ -82,6 +85,12 @@ module Telnyx
             #   @return [String, nil]
             optional :extended_address, String
 
+            # @!attribute latitude
+            #   Latitude of the suggested address, when available.
+            #
+            #   @return [Float, nil]
+            optional :latitude, Float, nil?: true
+
             # @!attribute locality
             #   The locality of the address. For US addresses, this corresponds to the city of
             #   the address.
@@ -89,6 +98,19 @@ module Telnyx
             #   @return [String, nil]
             optional :locality, String
 
+            # @!attribute longitude
+            #   Longitude of the suggested address, when available.
+            #
+            #   @return [Float, nil]
+            optional :longitude, Float, nil?: true
+
+            # @!attribute neighborhood
+            #   The neighborhood of the address. This field is not used for addresses in the US
+            #   but is used for some international addresses.
+            #
+            #   @return [String, nil]
+            optional :neighborhood, String
+
             # @!attribute postal_code
             #   The postal code of the address.
             #
@@ -101,7 +123,7 @@ module Telnyx
             #   @return [String, nil]
             optional :street_address, String
 
-            # @!method initialize(administrative_area: nil, country_code: nil, extended_address: nil, locality: nil, postal_code: nil, street_address: nil)
+            # @!method initialize(administrative_area: nil, borough: nil, country_code: nil, extended_address: nil, latitude: nil, locality: nil, longitude: nil, neighborhood: nil, postal_code: nil, street_address: nil)
             #   Some parameter documentations has been truncated, see
             #   {Telnyx::Models::Addresses::ActionValidateResponse::Data::Suggested} for more
             #   details.
@@ -110,12 +132,20 @@ module Telnyx
             #
             #   @param administrative_area [String] The locality of the address. For US addresses, this corresponds to the state of
             #
+            #   @param borough [String] The borough of the address. This field is not used for addresses in the US but i
+            #
             #   @param country_code [String] The two-character (ISO 3166-1 alpha-2) country code of the address.
             #
             #   @param extended_address [String] Additional street address information about the address such as, but not limited
             #
+            #   @param latitude [Float, nil] Latitude of the suggested address, when available.
+            #
             #   @param locality [String] The locality of the address. For US addresses, this corresponds to the city of t
             #
+            #   @param longitude [Float, nil] Longitude of the suggested address, when available.
+            #
+            #   @param neighborhood [String] The neighborhood of the address. This field is not used for addresses in the US
+            #
             #   @param postal_code [String] The postal code of the address.
             #
             #   @param street_address [String] The primary street address information about the address.

data/lib/telnyx/models/ai/assistant_create_params.rb

@@ -34,8 +34,10 @@ module Telnyx
         optional :a2a_agents, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::AI::AssistantA2AAgent] }
 
         # @!attribute avatar_settings
-        #   **Beta:** Configuration for the Telnyx open-source avatar provider. The launch
-        #   catalog supports six avatars and office, studio, or reception backgrounds.
+        #   **Beta:** Configuration for the Telnyx open-source avatar provider. Use a stock
+        #   avatar or an organization-owned custom avatar returned by the Avatars API.
+        #   Discover the available stock catalog with GET /v2/ai/avatars and
+        #   filter[avatar_type]=stock; follow meta.total_pages to load every page.
         #
         #   @return [Telnyx::Models::AI::AvatarSettingsRequest, nil]
         optional :avatar_settings, -> { Telnyx::AI::AvatarSettingsRequest }, nil?: true
@@ -224,7 +226,7 @@ module Telnyx
         #   assistant. Prefer `tool_ids` to attach shared tools created with the AI Tools
         #   endpoints.
         #
-        #   @return [Array<Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>, nil]
+        #   @return [Array<Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Vision, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>, nil]
         optional :tools, -> { Telnyx::Internal::Type::ArrayOf[union: Telnyx::AI::AssistantTool] }
 
         # @!attribute transcription
@@ -268,7 +270,7 @@ module Telnyx
         #
         #   @param a2a_agents [Array<Telnyx::Models::AI::AssistantA2AAgent>] A2A agents this assistant can delegate to. Tools are not stored here: at the sta
         #
-        #   @param avatar_settings [Telnyx::Models::AI::AvatarSettingsRequest, nil] **Beta:** Configuration for the Telnyx open-source avatar provider. The launch c
+        #   @param avatar_settings [Telnyx::Models::AI::AvatarSettingsRequest, nil] **Beta:** Configuration for the Telnyx open-source avatar provider. Use a stock
         #
         #   @param conversation_flow [Telnyx::Models::AI::ConversationFlowReq] Conversation flow as supplied by API clients (create / update).
         #
@@ -316,7 +318,7 @@ module Telnyx
         #
         #   @param tool_ids [Array<String>] IDs of shared tools to attach to the assistant. New integrations should prefer `
         #
-        #   @param tools [Array<Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>] Deprecated for new integrations. Inline tool definitions available to the assist
+        #   @param tools [Array<Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Vision, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>] Deprecated for new integrations. Inline tool definitions available to the assist
         #
         #   @param transcription [Telnyx::Models::AI::TranscriptionSettings]
         #