telnyx 5.171.0 → 5.173.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e1eabbc18cbdcb3524c61c95fe397dcb5494ddd06459ce4a5ed448a3106db8f2
-  data.tar.gz: 417b20a6222b040c3e32bc0b9c998fd49d868e2b2f70c692a74c5cb9f6ece6d6
+  metadata.gz: a8a0d9edaab7084b74be27c5c41e73fc0089a2ef12cddd59fb974320a0144439
+  data.tar.gz: 5657256ca67f97cade75834a3247666105fdb2e05853aed4a5e54d84f40fefe8
 SHA512:
-  metadata.gz: 8810ee7b9c133dbdad93e500f9201f5350b55a2ab98bb9ae6956051c3ab09faca197debaff9b79ad13075c28140d7ce5e655069a78e689c296bf61e04c9a510c
-  data.tar.gz: b281a7590d994e86acfbf3c2c59166040e2f1ba42cacb4789d08301f2496b2416becf64fa04c898e7c04314ebeb198c2b00ab9b836659ccf78ad9bdba2f02d29
+  metadata.gz: 9fae567fb853b28065d5791761ce257b840a971e8628c5b31930b74c7f45b21ee1e707903bf26921eff9f2538249dd55cca5f3c39b8550b038ffd9d33e011d51
+  data.tar.gz: 0073a20d3cf951262e622b5caf07990c4ee8e80085e0c18a6f9e3e6639d5d26cec68f7cb54883a0c48e8c9a2fea22e9a89f8ec9ad98e475cc3c299db27b47784

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [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.173.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,37 @@ module Telnyx
     # @return [Telnyx::Resources::SipRegistrationStatus]
     attr_reader :sip_registration_status
 
+    # Call information
+    # @return [Telnyx::Resources::DialMetrics]
+    attr_reader :dial_metrics
+
+    # @return [Telnyx::Resources::TtsIntegrations]
+    attr_reader :tts_integrations
+
+    # 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 +959,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 +1152,14 @@ 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)
+      @tts_integrations = Telnyx::Resources::TtsIntegrations.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/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]
         #

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

@@ -37,6 +37,9 @@ module Telnyx
 
         variant :skip_turn, -> { Telnyx::AI::AssistantTool::SkipTurn }
 
+        # (BETA) Lets the assistant look at recent image frames the client sent into the conversation (for example webcam or screen-share frames). Frames are sent with `conversation.item.create` and `item.buffer: true`; they never trigger a response on their own. The assistant decides when to look and which frames it needs. Requires a model that supports image input.
+        variant :vision, -> { Telnyx::AI::AssistantTool::Vision }
+
         # (BETA) The pay tool allows the assistant to collect card payments from the caller via DTMF during the conversation. Recording is automatically paused while the pay tool is active and resumes when the payment flow completes. The connector_name must reference a pay connector configured in the Telnyx API.
         variant :pay, -> { Telnyx::AI::AssistantTool::Pay }
 
@@ -380,6 +383,15 @@ module Telnyx
             #   @return [Array<Telnyx::Models::AI::AssistantTool::Transfer::Transfer::Targets::TargetsList>, String]
             required :targets, union: -> { Telnyx::AI::AssistantTool::Transfer::Transfer::Targets }
 
+            # @!attribute bridge_beep
+            #   Plays a short beep once the transfer completes and the calls are bridged, so the
+            #   transfer destination knows the caller is now on the line. The warm transfer
+            #   message plays before the bridge; this marks the moment the caller actually
+            #   joins. Works with and without `warm_transfer_acceptance`.
+            #
+            #   @return [Telnyx::Models::AI::AssistantTool::Transfer::Transfer::BridgeBeep, nil]
+            optional :bridge_beep, -> { Telnyx::AI::AssistantTool::Transfer::Transfer::BridgeBeep }
+
             # @!attribute custom_headers
             #   Custom headers to be added to the SIP INVITE for the transfer command.
             #
@@ -449,7 +461,7 @@ module Telnyx
             #   @return [String, nil]
             optional :warm_transfer_instructions, String
 
-            # @!method initialize(from:, targets:, custom_headers: nil, description: nil, diversion: nil, voicemail_detection: nil, warm_message_delay_ms: nil, warm_transfer_acceptance: nil, warm_transfer_instructions: nil)
+            # @!method initialize(from:, targets:, bridge_beep: nil, custom_headers: nil, description: nil, diversion: nil, voicemail_detection: nil, warm_message_delay_ms: nil, warm_transfer_acceptance: nil, warm_transfer_instructions: nil)
             #   Some parameter documentations has been truncated, see
             #   {Telnyx::Models::AI::AssistantTool::Transfer::Transfer} for more details.
             #
@@ -457,6 +469,8 @@ module Telnyx
             #
             #   @param targets [Array<Telnyx::Models::AI::AssistantTool::Transfer::Transfer::Targets::TargetsList>, String] The different possible targets of the transfer. The assistant will be able to ch
             #
+            #   @param bridge_beep [Telnyx::Models::AI::AssistantTool::Transfer::Transfer::BridgeBeep] Plays a short beep once the transfer completes and the calls are bridged, so the
+            #
             #   @param custom_headers [Array<Telnyx::Models::AI::AssistantTool::Transfer::Transfer::CustomHeader>] Custom headers to be added to the SIP INVITE for the transfer command.
             #
             #   @param description [String] A description of the transfer tool. By default, Telnyx generates this automatica
@@ -558,6 +572,50 @@ module Telnyx
                 }]
             end
 
+            # @see Telnyx::Models::AI::AssistantTool::Transfer::Transfer#bridge_beep
+            class BridgeBeep < Telnyx::Internal::Type::BaseModel
+              # @!attribute enabled
+              #   Whether to play the beep when the calls are bridged.
+              #
+              #   @return [Boolean, nil]
+              optional :enabled, Telnyx::Internal::Type::Boolean
+
+              # @!attribute target_legs
+              #   Who hears the beep. `self` plays it to the transfer destination only; `both`
+              #   plays it to the destination and the original caller.
+              #
+              #   @return [Symbol, Telnyx::Models::AI::AssistantTool::Transfer::Transfer::BridgeBeep::TargetLegs, nil]
+              optional :target_legs, enum: -> { Telnyx::AI::AssistantTool::Transfer::Transfer::BridgeBeep::TargetLegs }
+
+              # @!method initialize(enabled: nil, target_legs: nil)
+              #   Some parameter documentations has been truncated, see
+              #   {Telnyx::Models::AI::AssistantTool::Transfer::Transfer::BridgeBeep} for more
+              #   details.
+              #
+              #   Plays a short beep once the transfer completes and the calls are bridged, so the
+              #   transfer destination knows the caller is now on the line. The warm transfer
+              #   message plays before the bridge; this marks the moment the caller actually
+              #   joins. Works with and without `warm_transfer_acceptance`.
+              #
+              #   @param enabled [Boolean] Whether to play the beep when the calls are bridged.
+              #
+              #   @param target_legs [Symbol, Telnyx::Models::AI::AssistantTool::Transfer::Transfer::BridgeBeep::TargetLegs] Who hears the beep. `self` plays it to the transfer destination only; `both` pla
+
+              # Who hears the beep. `self` plays it to the transfer destination only; `both`
+              # plays it to the destination and the original caller.
+              #
+              # @see Telnyx::Models::AI::AssistantTool::Transfer::Transfer::BridgeBeep#target_legs
+              module TargetLegs
+                extend Telnyx::Internal::Type::Enum
+
+                SELF = :self
+                BOTH = :both
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+            end
+
             class CustomHeader < Telnyx::Internal::Type::BaseModel
               # @!attribute name
               #
@@ -845,7 +903,35 @@ module Telnyx
               optional :end_user_target_context_mode,
                        enum: -> { Telnyx::AI::AssistantTool::Transfer::Transfer::WarmTransferAcceptance::EndUserTargetContextMode }
 
-              # @!method initialize(enabled: nil, end_user_target_context_mode: nil)
+              # @!attribute require_acceptance
+              #   Fail closed when the acceptance consult cannot run. Off by default: if the
+              #   consult cannot be set up for any reason — including where acceptance is
+              #   unavailable at all (`gather_using_ai`, Conversation Relay or web calls, a
+              #   conference, or additional invited participants) — the transfer degrades to a
+              #   plain warm transfer (the warm transfer message is played to the destination as
+              #   audio and the calls are bridged anyway). Set to true to treat those paths as a
+              #   decline instead: the destination is disconnected without being asked, the
+              #   assistant returns to the caller, and no bridge happens without an acceptance.
+              #   Only consult-setup failures are affected; the destination must still explicitly
+              #   accept on every consult that does run.
+              #
+              #   @return [Boolean, nil]
+              optional :require_acceptance, Telnyx::Internal::Type::Boolean
+
+              # @!attribute timeout_secs
+              #   How long, in seconds, the destination has to accept the transfer, counted from
+              #   when the private consult starts (right after the destination answers, or after
+              #   `warm_message_delay_ms`). The caller keeps hearing ringback the whole time. If
+              #   no acceptance arrives in time, the destination is hung up and the assistant
+              #   returns to the caller (the transfer fails as a timeout). Raise it for
+              #   destinations that answer before a human is on the line, such as a call-center
+              #   queue/ACD or an IVR playing hold audio; keep it as short as practical, since the
+              #   caller waits on ringback until it expires.
+              #
+              #   @return [Integer, nil]
+              optional :timeout_secs, Integer
+
+              # @!method initialize(enabled: nil, end_user_target_context_mode: nil, require_acceptance: nil, timeout_secs: nil)
               #   Some parameter documentations has been truncated, see
               #   {Telnyx::Models::AI::AssistantTool::Transfer::Transfer::WarmTransferAcceptance}
               #   for more details.
@@ -865,6 +951,10 @@ module Telnyx
               #   @param enabled [Boolean] Whether the destination must accept the transfer before the calls are bridged.
               #
               #   @param end_user_target_context_mode [Symbol, Telnyx::Models::AI::AssistantTool::Transfer::Transfer::WarmTransferAcceptance::EndUserTargetContextMode] Controls whether the private exchange between the assistant and the transfer des
+              #
+              #   @param require_acceptance [Boolean] Fail closed when the acceptance consult cannot run. Off by default: if the consu
+              #
+              #   @param timeout_secs [Integer] How long, in seconds, the destination has to accept the transfer, counted from w
 
               # Controls whether the private exchange between the assistant and the transfer
               # destination is kept out of the conversation. With `private` (default) the
@@ -1419,6 +1509,48 @@ module Telnyx
           end
         end
 
+        class Vision < Telnyx::Internal::Type::BaseModel
+          # @!attribute type
+          #
+          #   @return [Symbol, :vision]
+          required :type, const: :vision
+
+          # @!attribute vision
+          #
+          #   @return [Telnyx::Models::AI::VisionToolParams, nil]
+          optional :vision, -> { Telnyx::AI::VisionToolParams }
+
+          response_only do
+            # @!attribute shared
+            #   Whether this tool comes from the shared Tools Library. Responses merge shared
+            #   tools into `tools` with `shared: true`; inline tools carry `shared: false`.
+            #   Read-only: set by the server, not accepted in requests. When updating an
+            #   assistant, omit `shared: true` tools from the request `tools` array and manage
+            #   them through `tool_ids` instead — re-sending their definitions creates an inline
+            #   duplicate (rejected with error code 10015 when the type allows only one instance
+            #   per assistant).
+            #
+            #   @return [Boolean, nil]
+            optional :shared, Telnyx::Internal::Type::Boolean
+          end
+
+          # @!method initialize(shared: nil, vision: nil, type: :vision)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::AI::AssistantTool::Vision} for more details.
+          #
+          #   (BETA) Lets the assistant look at recent image frames the client sent into the
+          #   conversation (for example webcam or screen-share frames). Frames are sent with
+          #   `conversation.item.create` and `item.buffer: true`; they never trigger a
+          #   response on their own. The assistant decides when to look and which frames it
+          #   needs. Requires a model that supports image input.
+          #
+          #   @param shared [Boolean] Whether this tool comes from the shared Tools Library. Responses merge shared to
+          #
+          #   @param vision [Telnyx::Models::AI::VisionToolParams]
+          #
+          #   @param type [Symbol, :vision]
+        end
+
         class Pay < Telnyx::Internal::Type::BaseModel
           # @!attribute pay
           #
@@ -1504,7 +1636,7 @@ module Telnyx
         end
 
         # @!method self.variants
-        #   @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)]
+        #   @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)]
       end
     end
   end

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

@@ -28,8 +28,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
@@ -248,7 +250,7 @@ module Telnyx
         #   omit those tools from the `tools` array and manage them through `tool_ids`
         #   instead.
         #
-        #   @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
@@ -291,7 +293,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).
         #
@@ -345,7 +347,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]
         #

data/lib/telnyx/models/ai/assistants/update_assistant.rb

@@ -20,8 +20,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
@@ -233,7 +235,7 @@ module Telnyx
           #   omit those tools from the `tools` array and manage them through `tool_ids`
           #   instead.
           #
-          #   @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
@@ -274,7 +276,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).
           #
@@ -326,7 +328,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]
           #