telnyx 5.168.0 → 5.169.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 360829c3c2b34713bbae9a6a999389a66e6a7cd09004ba4a44c873472b407fe0
-  data.tar.gz: 6d3229995295c12147c3ebd8f8beb46d88fc855ab41098c89861316721ce1687
+  metadata.gz: 76b412afdb06cd9324668c45647f9f1ab4045cfe7e4661987dbb3399f7d0b5d6
+  data.tar.gz: 1506a292fecf24c7ce4d8126f65307ed8d86c95d44dd3defa42f793be424988a
 SHA512:
-  metadata.gz: 2c20e1e1b3c3c5776bf3c54b0d55eb4a37c26f2cb8bcb10a752fb2608f9c4ddad1c70bafbbc7364effec7693985dae05b44952e321226c66bacedd448ee7ccfe
-  data.tar.gz: 8812060e1369748da186af9db57e077df3eee3e04c9cc076f158ebe405e98a8442991a5ac2219d4a42687deed6ed110c5d4ff2e49657ba8606a6d9b5fc113565
+  metadata.gz: 50bc3aab30f7bac32f7eb71dcf6b7a7998a7f72413159faf3153282d4b2facf4228d8af53f5a459bcf28a07783c6f630bc8cfa7ff23bfe093c699c34b3f22d0e
+  data.tar.gz: 70985f4731b3c28bea7a97a8993f5c5af3c18e94f6a69424e55853742e9593b873379f2f43fbc5aca61a12cc9e500a8f55db44a6f7637a80a8a3f00007ac0f9f

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [5.169.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.168.0...v5.169.0) (2026-09-23)
+
+
+### Features
+
+* promote from staging 6f6d71d ([a11416d](https://github.com/team-telnyx/telnyx-ruby/commit/a11416d75ef0d775c45e8b94a7fd85e57a2a8df9))
+
 ## [5.168.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.167.0...v5.168.0) (2026-09-13)
 
 

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.168.0"
+gem "telnyx", "~> 5.169.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/telnyx/client.rb

@@ -738,6 +738,41 @@ module Telnyx
     # @return [Telnyx::Resources::Compute]
     attr_reader :compute
 
+    # Noise suppression engines that can be selected when configuring noise
+    # suppression on voice connections.
+    # @return [Telnyx::Resources::NoiseSuppressionEngines]
+    attr_reader :noise_suppression_engines
+
+    # Agentic (bot) signup for Telnyx accounts. An AI agent solves a reverse-CAPTCHA
+    # challenge designed to be easy for LLMs and hard for humans, registers an
+    # account, and signs in by consuming a magic link emailed to the account owner.
+    # All endpoints are public and unauthenticated; signup endpoints are additionally
+    # gated by the freemium feature flags and per-country availability.
+    # @return [Telnyx::Resources::BotChallenge]
+    attr_reader :bot_challenge
+
+    # Agentic (bot) signup for Telnyx accounts. An AI agent solves a reverse-CAPTCHA
+    # challenge designed to be easy for LLMs and hard for humans, registers an
+    # account, and signs in by consuming a magic link emailed to the account owner.
+    # All endpoints are public and unauthenticated; signup endpoints are additionally
+    # gated by the freemium feature flags and per-country availability.
+    # @return [Telnyx::Resources::BotSessions]
+    attr_reader :bot_sessions
+
+    # Agentic (bot) signup for Telnyx accounts. An AI agent solves a reverse-CAPTCHA
+    # challenge designed to be easy for LLMs and hard for humans, registers an
+    # account, and signs in by consuming a magic link emailed to the account owner.
+    # All endpoints are public and unauthenticated; signup endpoints are additionally
+    # gated by the freemium feature flags and per-country availability.
+    # @return [Telnyx::Resources::BotSignup]
+    attr_reader :bot_signup
+
+    # Machine payment (MPP) account-credit operations. Fund your Telnyx account
+    # programmatically from a machine or agent using the Machine Payment Protocol, an
+    # HTTP-402 flow settled via Stripe or Tempo.
+    # @return [Telnyx::Resources::MachinePayments]
+    attr_reader :machine_payments
+
     # @api private
     #
     # @return [Hash{String=>String}]
@@ -1030,6 +1065,11 @@ module Telnyx
       @meeting_sessions = Telnyx::Resources::MeetingSessions.new(client: self)
       @external_requirements = Telnyx::Resources::ExternalRequirements.new(client: self)
       @compute = Telnyx::Resources::Compute.new(client: self)
+      @noise_suppression_engines = Telnyx::Resources::NoiseSuppressionEngines.new(client: self)
+      @bot_challenge = Telnyx::Resources::BotChallenge.new(client: self)
+      @bot_sessions = Telnyx::Resources::BotSessions.new(client: self)
+      @bot_signup = Telnyx::Resources::BotSignup.new(client: self)
+      @machine_payments = Telnyx::Resources::MachinePayments.new(client: self)
     end
   end
 end

data/lib/telnyx/internal/type/union.rb

@@ -8,24 +8,24 @@ module Telnyx
       # @example
       #   # `assistant_tool` is a `Telnyx::AI::AssistantTool`
       #   case assistant_tool
+      #   when Telnyx::AI::AssistantTool::Function
+      #     puts(assistant_tool.function)
       #   when Telnyx::AI::InferenceEmbeddingWebhookToolParams
       #     puts(assistant_tool.type)
       #   when Telnyx::AI::AssistantTool::ClientSideTool
       #     puts(assistant_tool.client_side_tool)
-      #   when Telnyx::AI::RetrievalTool
-      #     puts(assistant_tool.retrieval)
       #   else
       #     puts(assistant_tool)
       #   end
       #
       # @example
       #   case assistant_tool
-      #   in {type: :webhook, webhook: webhook}
+      #   in {type: :function, function: function, shared: shared}
+      #     puts(function)
+      #   in {type: :webhook, webhook: webhook, shared: shared}
       #     puts(webhook)
-      #   in {type: :client_side_tool, client_side_tool: client_side_tool}
+      #   in {type: :client_side_tool, client_side_tool: client_side_tool, shared: shared}
       #     puts(client_side_tool)
-      #   in {type: :retrieval, retrieval: retrieval}
-      #     puts(retrieval)
       #   else
       #     puts(assistant_tool)
       #   end

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

@@ -168,10 +168,10 @@ module Telnyx
         # @!attribute post_conversation_settings
         #   Configuration for post-conversation processing. When enabled, the assistant
         #   receives one additional LLM turn after the conversation ends, allowing it to
-        #   execute tool calls such as logging to a CRM or sending a summary. The assistant
-        #   can execute multiple parallel or sequential tools during this phase.
-        #   Telephony-control tools (e.g. hangup, transfer) are unavailable
-        #   post-conversation. Beta feature.
+        #   execute final tool calls such as sending a summary or updating a record via
+        #   webhook or function tools. Integration and MCP server tools are not available
+        #   post-conversation; call-control tools (e.g. hangup, transfer) are also
+        #   unavailable. Beta feature.
         #
         #   @return [Telnyx::Models::AI::PostConversationSettingsReq, nil]
         optional :post_conversation_settings, -> { Telnyx::AI::PostConversationSettingsReq }
@@ -205,7 +205,7 @@ module Telnyx
         #   assistant. Prefer `tool_ids` to attach shared tools created with the AI Tools
         #   endpoints.
         #
-        #   @return [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, 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::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>, nil]
         optional :tools, -> { Telnyx::Internal::Type::ArrayOf[union: Telnyx::AI::AssistantTool] }
 
         # @!attribute transcription
@@ -283,7 +283,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::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, 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::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

@@ -11,6 +11,8 @@ module Telnyx
 
         discriminator :type
 
+        variant :function, -> { Telnyx::AI::AssistantTool::Function }
+
         variant :webhook, -> { Telnyx::AI::InferenceEmbeddingWebhookToolParams }
 
         variant :client_side_tool, -> { Telnyx::AI::AssistantTool::ClientSideTool }
@@ -20,7 +22,7 @@ module Telnyx
         # The handoff tool allows the assistant to hand off control of the conversation to another AI assistant. By default, this will happen transparently to the end user.
         variant :handoff, -> { Telnyx::AI::AssistantTool::Handoff }
 
-        variant :hangup, -> { Telnyx::AI::HangupTool }
+        variant :hangup, -> { Telnyx::AI::AssistantTool::Hangup }
 
         variant :transfer, -> { Telnyx::AI::AssistantTool::Transfer }
 
@@ -41,6 +43,42 @@ module Telnyx
         # The update_dynamic_variables tool lets the assistant write values into the conversation's dynamic-variables context during the call. Updated variables are available to later `{{variable}}` interpolation (prompts, speak nodes, message templates) and to flow edge conditions. Declare each variable the assistant is allowed to set under `updatable_variables`.
         variant :update_dynamic_variables, -> { Telnyx::AI::AssistantTool::UpdateDynamicVariables }
 
+        class Function < Telnyx::Internal::Type::BaseModel
+          # @!attribute function
+          #
+          #   @return [Telnyx::Models::AI::OpenAI::FunctionDefinition]
+          required :function, -> { Telnyx::AI::OpenAI::FunctionDefinition }
+
+          # @!attribute type
+          #
+          #   @return [Symbol, :function]
+          required :type, const: :function
+
+          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(function:, shared: nil, type: :function)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::AI::AssistantTool::Function} for more details.
+          #
+          #   @param function [Telnyx::Models::AI::OpenAI::FunctionDefinition]
+          #
+          #   @param shared [Boolean] Whether this tool comes from the shared Tools Library. Responses merge shared to
+          #
+          #   @param type [Symbol, :function]
+        end
+
         class ClientSideTool < Telnyx::Internal::Type::BaseModel
           # @!attribute client_side_tool
           #
@@ -52,8 +90,28 @@ module Telnyx
           #   @return [Symbol, :client_side_tool]
           required :type, const: :client_side_tool
 
-          # @!method initialize(client_side_tool:, type: :client_side_tool)
+          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(client_side_tool:, shared: nil, type: :client_side_tool)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::AI::AssistantTool::ClientSideTool} for more details.
+          #
           #   @param client_side_tool [Telnyx::Models::AI::AssistantTool::ClientSideTool::ClientSideTool]
+          #
+          #   @param shared [Boolean] Whether this tool comes from the shared Tools Library. Responses merge shared to
+          #
           #   @param type [Symbol, :client_side_tool]
 
           # @see Telnyx::Models::AI::AssistantTool::ClientSideTool#client_side_tool
@@ -143,12 +201,32 @@ module Telnyx
           #   @return [Symbol, :handoff]
           required :type, const: :handoff
 
-          # @!method initialize(handoff:, type: :handoff)
+          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(handoff:, shared: nil, type: :handoff)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::AI::AssistantTool::Handoff} for more details.
+          #
           #   The handoff tool allows the assistant to hand off control of the conversation to
           #   another AI assistant. By default, this will happen transparently to the end
           #   user.
           #
           #   @param handoff [Telnyx::Models::AI::AssistantTool::Handoff::Handoff]
+          #
+          #   @param shared [Boolean] Whether this tool comes from the shared Tools Library. Responses merge shared to
+          #
           #   @param type [Symbol, :handoff]
 
           # @see Telnyx::Models::AI::AssistantTool::Handoff#handoff
@@ -214,6 +292,42 @@ module Telnyx
           end
         end
 
+        class Hangup < Telnyx::Internal::Type::BaseModel
+          # @!attribute hangup
+          #
+          #   @return [Telnyx::Models::AI::HangupToolParams]
+          required :hangup, -> { Telnyx::AI::HangupToolParams }
+
+          # @!attribute type
+          #
+          #   @return [Symbol, :hangup]
+          required :type, const: :hangup
+
+          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(hangup:, shared: nil, type: :hangup)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::AI::AssistantTool::Hangup} for more details.
+          #
+          #   @param hangup [Telnyx::Models::AI::HangupToolParams]
+          #
+          #   @param shared [Boolean] Whether this tool comes from the shared Tools Library. Responses merge shared to
+          #
+          #   @param type [Symbol, :hangup]
+        end
+
         class Transfer < Telnyx::Internal::Type::BaseModel
           # @!attribute transfer
           #
@@ -225,8 +339,28 @@ module Telnyx
           #   @return [Symbol, :transfer]
           required :type, const: :transfer
 
-          # @!method initialize(transfer:, type: :transfer)
+          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(transfer:, shared: nil, type: :transfer)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::AI::AssistantTool::Transfer} for more details.
+          #
           #   @param transfer [Telnyx::Models::AI::AssistantTool::Transfer::Transfer]
+          #
+          #   @param shared [Boolean] Whether this tool comes from the shared Tools Library. Responses merge shared to
+          #
           #   @param type [Symbol, :transfer]
 
           # @see Telnyx::Models::AI::AssistantTool::Transfer#transfer
@@ -733,8 +867,28 @@ module Telnyx
           #   @return [Symbol, :invite]
           required :type, const: :invite
 
-          # @!method initialize(invite:, type: :invite)
+          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(invite:, shared: nil, type: :invite)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::AI::AssistantTool::Invite} for more details.
+          #
           #   @param invite [Telnyx::Models::AI::AssistantTool::Invite::Invite]
+          #
+          #   @param shared [Boolean] Whether this tool comes from the shared Tools Library. Responses merge shared to
+          #
           #   @param type [Symbol, :invite]
 
           # @see Telnyx::Models::AI::AssistantTool::Invite#invite
@@ -936,8 +1090,28 @@ module Telnyx
           #   @return [Symbol, :refer]
           required :type, const: :refer
 
-          # @!method initialize(refer:, type: :refer)
+          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(refer:, shared: nil, type: :refer)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::AI::AssistantTool::Refer} for more details.
+          #
           #   @param refer [Telnyx::Models::AI::AssistantTool::Refer::Refer]
+          #
+          #   @param shared [Boolean] Whether this tool comes from the shared Tools Library. Responses merge shared to
+          #
           #   @param type [Symbol, :refer]
 
           # @see Telnyx::Models::AI::AssistantTool::Refer#refer
@@ -1082,8 +1256,28 @@ module Telnyx
           #   @return [Symbol, :send_dtmf]
           required :type, const: :send_dtmf
 
-          # @!method initialize(send_dtmf:, type: :send_dtmf)
+          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(send_dtmf:, shared: nil, type: :send_dtmf)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::AI::AssistantTool::SendDtmf} for more details.
+          #
           #   @param send_dtmf [Hash{Symbol=>Object}]
+          #
+          #   @param shared [Boolean] Whether this tool comes from the shared Tools Library. Responses merge shared to
+          #
           #   @param type [Symbol, :send_dtmf]
         end
 
@@ -1098,13 +1292,33 @@ module Telnyx
           #   @return [Symbol, :send_message]
           required :type, const: :send_message
 
-          # @!method initialize(send_message:, type: :send_message)
+          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(send_message:, shared: nil, type: :send_message)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::AI::AssistantTool::SendMessage} for more details.
+          #
           #   The send_message tool allows the assistant to send SMS or MMS messages to the
           #   end user. The 'to' and 'from' addresses are automatically determined from the
           #   conversation context, and the message text is generated by the assistant unless
           #   a message_template is provided for runtime variable substitution.
           #
           #   @param send_message [Telnyx::Models::AI::AssistantTool::SendMessage::SendMessage]
+          #
+          #   @param shared [Boolean] Whether this tool comes from the shared Tools Library. Responses merge shared to
+          #
           #   @param type [Symbol, :send_message]
 
           # @see Telnyx::Models::AI::AssistantTool::SendMessage#send_message
@@ -1138,8 +1352,28 @@ module Telnyx
           #   @return [Symbol, :skip_turn]
           required :type, const: :skip_turn
 
-          # @!method initialize(skip_turn:, type: :skip_turn)
+          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(skip_turn:, shared: nil, type: :skip_turn)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::AI::AssistantTool::SkipTurn} for more details.
+          #
           #   @param skip_turn [Telnyx::Models::AI::AssistantTool::SkipTurn::SkipTurn]
+          #
+          #   @param shared [Boolean] Whether this tool comes from the shared Tools Library. Responses merge shared to
+          #
           #   @param type [Symbol, :skip_turn]
 
           # @see Telnyx::Models::AI::AssistantTool::SkipTurn#skip_turn
@@ -1166,13 +1400,33 @@ module Telnyx
           #   @return [Symbol, :pay]
           required :type, const: :pay
 
-          # @!method initialize(pay:, type: :pay)
+          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(pay:, shared: nil, type: :pay)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::AI::AssistantTool::Pay} for more details.
+          #
           #   (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.
           #
           #   @param pay [Telnyx::Models::AI::PayToolParams]
+          #
+          #   @param shared [Boolean] Whether this tool comes from the shared Tools Library. Responses merge shared to
+          #
           #   @param type [Symbol, :pay]
         end
 
@@ -1188,7 +1442,24 @@ module Telnyx
           #   @return [Telnyx::Models::AI::UpdateDynamicVariablesToolParams]
           required :update_dynamic_variables, -> { Telnyx::AI::UpdateDynamicVariablesToolParams }
 
-          # @!method initialize(update_dynamic_variables:, type: :update_dynamic_variables)
+          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(update_dynamic_variables:, shared: nil, type: :update_dynamic_variables)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables} for more details.
+          #
           #   The update_dynamic_variables tool lets the assistant write values into the
           #   conversation's dynamic-variables context during the call. Updated variables are
           #   available to later `{{variable}}` interpolation (prompts, speak nodes, message
@@ -1197,11 +1468,13 @@ module Telnyx
           #
           #   @param update_dynamic_variables [Telnyx::Models::AI::UpdateDynamicVariablesToolParams] Configuration for an update_dynamic_variables tool.
           #
+          #   @param shared [Boolean] Whether this tool comes from the shared Tools Library. Responses merge shared to
+          #
           #   @param type [Symbol, :update_dynamic_variables]
         end
 
         # @!method self.variants
-        #   @return [Array(Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, 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::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables)]
       end
     end
   end

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

@@ -174,10 +174,10 @@ module Telnyx
         # @!attribute post_conversation_settings
         #   Configuration for post-conversation processing. When enabled, the assistant
         #   receives one additional LLM turn after the conversation ends, allowing it to
-        #   execute tool calls such as logging to a CRM or sending a summary. The assistant
-        #   can execute multiple parallel or sequential tools during this phase.
-        #   Telephony-control tools (e.g. hangup, transfer) are unavailable
-        #   post-conversation. Beta feature.
+        #   execute final tool calls such as sending a summary or updating a record via
+        #   webhook or function tools. Integration and MCP server tools are not available
+        #   post-conversation; call-control tools (e.g. hangup, transfer) are also
+        #   unavailable. Beta feature.
         #
         #   @return [Telnyx::Models::AI::PostConversationSettingsReq, nil]
         optional :post_conversation_settings, -> { Telnyx::AI::PostConversationSettingsReq }
@@ -208,7 +208,11 @@ module Telnyx
 
         # @!attribute tool_ids
         #   IDs of shared tools to attach to the assistant. New integrations should prefer
-        #   `tool_ids` over inline `tools`.
+        #   `tool_ids` over inline `tools`. On update, a sent `tool_ids` array fully
+        #   replaces the assistant's attached shared tools; omit the field to leave them
+        #   unchanged. Single-instance tool types are counted across inline `tools` and
+        #   `tool_ids` combined, so attaching a shared tool of such a type when an instance
+        #   already exists returns HTTP 400 with error code 10015.
         #
         #   @return [Array<String>, nil]
         optional :tool_ids, Telnyx::Internal::Type::ArrayOf[String]
@@ -216,9 +220,16 @@ module Telnyx
         # @!attribute tools
         #   Deprecated for new integrations. Inline tool definitions available to the
         #   assistant. Prefer `tool_ids` to attach shared tools created with the AI Tools
-        #   endpoints.
-        #
-        #   @return [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, 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]
+        #   endpoints. On update, a sent `tools` array fully replaces the assistant's inline
+        #   tools; omit the field to leave the inline tools unchanged. Each tool type except
+        #   `function`, `webhook`, and `client_side_tool` allows at most one instance per
+        #   assistant, counted across inline `tools` and shared `tool_ids` combined —
+        #   sending a duplicate of such a type returns HTTP 400 with error code 10015.
+        #   Responses merge shared tools into `tools` with `shared: true`; when updating,
+        #   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]
         optional :tools, -> { Telnyx::Internal::Type::ArrayOf[union: Telnyx::AI::AssistantTool] }
 
         # @!attribute transcription
@@ -301,7 +312,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::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, 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::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>] Deprecated for new integrations. Inline tool definitions available to the assist
         #
         #   @param transcription [Telnyx::Models::AI::TranscriptionSettings]
         #