telnyx 5.68.1 → 5.69.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f34b351e46a139b2d8217472217b09e421a8d04aee53e3597ab260cb8e6ab9cc
-  data.tar.gz: 17836f25c4cbcdab85c8c6c093806b0772eb3f4b036fed47804e702fb603a6a1
+  metadata.gz: 1acb28734cb5b652f6aa6cd7242b7bd6b89cfd0c41e044a16946a607b8797d52
+  data.tar.gz: 8202e48caa11f4357ab68b9f605ceddc3083989cb5c6eaff943655c87ab85401
 SHA512:
-  metadata.gz: f83976ff044d8e994a43a5fe1a3f5f38367e427f91bb3918c892025967c40eeba308d751a961a2006f41c6e39d920a2e77701ba65ad45b0b5534bb274ac6c869
-  data.tar.gz: 8251c6427f0ba4b6c5a244558157315163f08c943848d943e377e2cb40885fd55da15a36fd7f3aa09df191ada92912b0ff3713959f8de5e4760465b03c99aa3d
+  metadata.gz: 0f98808e691b61e96aaa0fe8395c80d8b6d262287d186b5a9603aa8f3b6cda92b0dd2f0333470d1e4e2ab9b98099c03121ab7050e8ed0e53ce2575ba8d5a18cb
+  data.tar.gz: 5ba5fa1a40066e1c73e848ed539b3955be3ee6b08d1976198f6899ec76de14153558b5a87b371d62f3e1657eba26d9caf1eee9eef52fa808eca5f7698405ab91

data/CHANGELOG.md

@@ -1,5 +1,44 @@
 # Changelog
 
+## 5.69.0 (2026-04-08)
+
+Full Changelog: [v5.68.2...v5.69.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.68.2...v5.69.0)
+
+### Features
+
+* Add ai_calls endpoint documentation to OpenAPI spec ([c8acb50](https://github.com/team-telnyx/telnyx-ruby/commit/c8acb50e7e89bba2f6314fe1ad3a81547a172f63))
+* add enabled boolean to recording_settings [AI-2178] ([8f21b10](https://github.com/team-telnyx/telnyx-ruby/commit/8f21b10753325c2792b0aabecd97633c51b410a0))
+* Add oneOf constraint for Url/Texml mutual exclusivity in InitiateCallRequest ([5cd6954](https://github.com/team-telnyx/telnyx-ruby/commit/5cd6954637cf297313fb31668c82424e959ecb27))
+* AI-2180: Add message_template to SendMessageTool schema ([6dcb74b](https://github.com/team-telnyx/telnyx-ruby/commit/6dcb74b30bc33245d83809f5f5e05a3a27ca13aa))
+* **api:** manual updates ([4933749](https://github.com/team-telnyx/telnyx-ruby/commit/4933749dbde30b5ad5ec3d3914d49cf071367662))
+* **api:** Merge pull request [#39](https://github.com/team-telnyx/telnyx-ruby/issues/39) from stainless-sdks/revert-a988c49-stainless-changes ([2286831](https://github.com/team-telnyx/telnyx-ruby/commit/2286831469bf7527df9b5caa6d57f788744e66b2))
+* Assistants: add observability ([88c203f](https://github.com/team-telnyx/telnyx-ruby/commit/88c203faad93be1670c56ed331dfc6816b562ed9))
+* CW-3815 fix PATCH /wirelss_blocklists/{id} endpoint ([4cf00e9](https://github.com/team-telnyx/telnyx-ruby/commit/4cf00e94bb333207285db020723792bddf3c6b2d))
+* MSG-6666: Add template and text properties to WhatsApp send message schema ([7dac0d6](https://github.com/team-telnyx/telnyx-ruby/commit/7dac0d6aca0d853ec56309dd3fdca67a204f3446))
+* MSG-6673: Add WhatsApp verification endpoint and profile settings ([00f25ab](https://github.com/team-telnyx/telnyx-ruby/commit/00f25abe49dca4f75852119df52da915567bd459))
+* TELAPPS-5689: Pronunciation dictionaries API docs ([716d0a0](https://github.com/team-telnyx/telnyx-ruby/commit/716d0a0d2d7973b998902932f7b9d0965acc8ee9))
+
+
+### Bug Fixes
+
+* add missing VoiceCloneCreateFromDesignParams and VoiceCloneCreateFromDesignResponse constant aliases ([1cef321](https://github.com/team-telnyx/telnyx-ruby/commit/1cef3216c8b5a0ac54db0f919df8ac305f154e86))
+* align path encoding with RFC 3986 section 3.3 ([cb36e56](https://github.com/team-telnyx/telnyx-ruby/commit/cb36e56e938d6fd5498f860d29c788644bb4d753))
+* variable name typo ([49b527d](https://github.com/team-telnyx/telnyx-ruby/commit/49b527df7eed567656f1d149cb4c9af3d9b29693))
+
+
+### Reverts
+
+* restore stainless.yml SDK generation fixes ([2286831](https://github.com/team-telnyx/telnyx-ruby/commit/2286831469bf7527df9b5caa6d57f788744e66b2))
+
+
+### Chores
+
+* remove legacy GEM_HOST_API_KEY check (now using OIDC) ([b20bdd2](https://github.com/team-telnyx/telnyx-ruby/commit/b20bdd2ac232901e0e0106575afa8c470b5feb9b))
+
+## 5.68.2 (2026-03-31)
+
+Full Changelog: [v5.68.1...v5.68.2](https://github.com/team-telnyx/telnyx-ruby/compare/v5.68.1...v5.68.2)
+
 ## 5.68.1 (2026-03-31)
 
 Full Changelog: [v5.68.0...v5.68.1](https://github.com/team-telnyx/telnyx-ruby/compare/v5.68.0...v5.68.1)

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

data/lib/telnyx/client.rb

@@ -653,6 +653,12 @@ module Telnyx
     # @return [Telnyx::Resources::TermsOfService]
     attr_reader :terms_of_service
 
+    # Manage pronunciation dictionaries for text-to-speech synthesis. Dictionaries
+    # contain alias items (text replacement) and phoneme items (IPA pronunciation
+    # notation) that control how specific words are spoken.
+    # @return [Telnyx::Resources::PronunciationDicts]
+    attr_reader :pronunciation_dicts
+
     # @api private
     #
     # @return [Hash{String=>String}]
@@ -910,6 +916,7 @@ module Telnyx
       @enterprises = Telnyx::Resources::Enterprises.new(client: self)
       @reputation = Telnyx::Resources::Reputation.new(client: self)
       @terms_of_service = Telnyx::Resources::TermsOfService.new(client: self)
+      @pronunciation_dicts = Telnyx::Resources::PronunciationDicts.new(client: self)
     end
   end
 end

data/lib/telnyx/internal/util.rb

@@ -157,7 +157,7 @@ module Telnyx
           in Hash | nil => coerced
             coerced
           else
-            message = "Expected a #{Hash} or #{Telnyx::Internal::Type::BaseModel}, got #{data.inspect}"
+            message = "Expected a #{Hash} or #{Telnyx::Internal::Type::BaseModel}, got #{input.inspect}"
             raise ArgumentError.new(message)
           end
         end
@@ -237,6 +237,11 @@ module Telnyx
         end
       end
 
+      # @type [Regexp]
+      #
+      # https://www.rfc-editor.org/rfc/rfc3986.html#section-3.3
+      RFC_3986_NOT_PCHARS = /[^A-Za-z0-9\-._~!$&'()*+,;=:@]+/
+
       class << self
         # @api private
         #
@@ -247,6 +252,15 @@ module Telnyx
           "#{uri.scheme}://#{uri.host}#{":#{uri.port}" unless uri.port == uri.default_port}"
         end
 
+        # @api private
+        #
+        # @param path [String, Integer]
+        #
+        # @return [String]
+        def encode_path(path)
+          path.to_s.gsub(Telnyx::Internal::Util::RFC_3986_NOT_PCHARS) { ERB::Util.url_encode(_1) }
+        end
+
         # @api private
         #
         # @param path [String, Array<String>]
@@ -259,7 +273,7 @@ module Telnyx
           in []
             ""
           in [String => p, *interpolations]
-            encoded = interpolations.map { ERB::Util.url_encode(_1) }
+            encoded = interpolations.map { encode_path(_1) }
             format(p, *encoded)
           end
         end
@@ -576,10 +590,10 @@ module Telnyx
 
           case val
           in Telnyx::FilePart unless val.filename.nil?
-            filename = ERB::Util.url_encode(val.filename)
+            filename = encode_path(val.filename)
             y << "; filename=\"#{filename}\""
           in Pathname | IO
-            filename = ERB::Util.url_encode(::File.basename(val.to_path))
+            filename = encode_path(::File.basename(val.to_path))
             y << "; filename=\"#{filename}\""
           else
           end

data/lib/telnyx/lib/webhook_verification.rb

@@ -2,6 +2,7 @@
 
 require "base64"
 require "openssl"
+require_relative "webhook_verification_error"
 
 module Telnyx
   module Lib

data/lib/telnyx/lib/webhook_verification_error.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Errors
+    # Error raised when webhook signature verification fails.
+    #
+    # This error is raised by the webhook verification module when:
+    # - No public key is configured
+    # - Required headers are missing (telnyx-signature-ed25519, telnyx-timestamp)
+    # - Timestamp is too old or too new (outside 5-minute tolerance)
+    # - Signature verification fails
+    # - Public key or signature format is invalid
+    #
+    # @example Handling verification errors
+    #   begin
+    #     client.webhooks.verify!(payload, headers)
+    #   rescue Telnyx::Errors::WebhookVerificationError => e
+    #     puts "Webhook verification failed: #{e.message}"
+    #   end
+    class WebhookVerificationError < StandardError
+      # @param message [String] The error message describing the verification failure
+      def initialize(message:)
+        super(message)
+      end
+    end
+  end
+end

data/lib/telnyx/lib/webhooks_ed25519.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require_relative "webhook_verification"
+require_relative "webhook_verification_error"
+
+module Telnyx
+  module Resources
+    # Extends the generated Webhooks class with ED25519 signature verification.
+    #
+    # This reopens the Webhooks class to include the WebhookVerification module,
+    # which adds ED25519 signature verification matching Python, Node, Go, and Java SDKs.
+    #
+    # Usage:
+    #
+    #   require "telnyx"
+    #   require "telnyx/lib/webhooks_ed25519"
+    #
+    #   client = Telnyx::Client.new(
+    #     api_key: ENV["TELNYX_API_KEY"],
+    #     public_key: ENV["TELNYX_PUBLIC_KEY"]  # Base64 from Mission Control
+    #   )
+    #
+    #   # Verify signature only (raises WebhookVerificationError on failure)
+    #   client.webhooks.verify!(payload, headers)
+    #
+    #   # Verify and parse (ED25519 verification, then parse)
+    #   event = client.webhooks.unwrap(payload, headers: headers)
+    #
+    class Webhooks
+      include Telnyx::Lib::WebhookVerification
+
+      # Override unwrap to use ED25519 verification instead of StandardWebhooks.
+      #
+      # @param payload [String] The raw webhook payload as a string
+      # @param headers [Hash{String=>String}] The raw HTTP headers
+      # @param key [String, nil] Optional public key override (base64-encoded ED25519)
+      #
+      # @return [Telnyx::Models::UnwrapWebhookEvent]
+      # @raise [Telnyx::Errors::WebhookVerificationError] If verification fails
+      def unwrap(payload, headers:, key: nil)
+        # Use ED25519 verification
+        do_verify_signature(payload, headers, key || @client.public_key)
+
+        # Parse the payload
+        parsed = JSON.parse(payload, symbolize_names: true)
+        Telnyx::Internal::Type::Converter.coerce(Telnyx::Models::UnwrapWebhookEvent, parsed)
+      end
+    end
+  end
+end

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

@@ -84,6 +84,11 @@ module Telnyx
         #   @return [Telnyx::Models::AI::MessagingSettings, nil]
         optional :messaging_settings, -> { Telnyx::AI::MessagingSettings }
 
+        # @!attribute observability_settings
+        #
+        #   @return [Telnyx::Models::AI::AssistantCreateParams::ObservabilitySettings, nil]
+        optional :observability_settings, -> { Telnyx::AI::AssistantCreateParams::ObservabilitySettings }
+
         # @!attribute privacy_settings
         #
         #   @return [Telnyx::Models::AI::PrivacySettings, nil]
@@ -122,7 +127,7 @@ module Telnyx
         #   @return [Telnyx::Models::AI::WidgetSettings, nil]
         optional :widget_settings, -> { Telnyx::AI::WidgetSettings }
 
-        # @!method initialize(instructions:, model:, name:, description: nil, dynamic_variables: nil, dynamic_variables_webhook_url: nil, enabled_features: nil, greeting: nil, insight_settings: nil, llm_api_key_ref: nil, messaging_settings: nil, privacy_settings: nil, telephony_settings: nil, tool_ids: nil, tools: nil, transcription: nil, voice_settings: nil, widget_settings: nil, request_options: {})
+        # @!method initialize(instructions:, model:, name:, description: nil, dynamic_variables: nil, dynamic_variables_webhook_url: nil, enabled_features: nil, greeting: nil, insight_settings: nil, llm_api_key_ref: nil, messaging_settings: nil, observability_settings: nil, privacy_settings: nil, telephony_settings: nil, tool_ids: nil, tools: nil, transcription: nil, voice_settings: nil, widget_settings: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::AssistantCreateParams} for more details.
         #
@@ -148,6 +153,8 @@ module Telnyx
         #
         #   @param messaging_settings [Telnyx::Models::AI::MessagingSettings]
         #
+        #   @param observability_settings [Telnyx::Models::AI::AssistantCreateParams::ObservabilitySettings]
+        #
         #   @param privacy_settings [Telnyx::Models::AI::PrivacySettings]
         #
         #   @param telephony_settings [Telnyx::Models::AI::TelephonySettings]
@@ -163,6 +170,45 @@ module Telnyx
         #   @param widget_settings [Telnyx::Models::AI::WidgetSettings] Configuration settings for the assistant's web widget.
         #
         #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+
+        class ObservabilitySettings < Telnyx::Internal::Type::BaseModel
+          # @!attribute host
+          #
+          #   @return [String, nil]
+          optional :host, String
+
+          # @!attribute public_key_ref
+          #
+          #   @return [String, nil]
+          optional :public_key_ref, String
+
+          # @!attribute secret_key_ref
+          #
+          #   @return [String, nil]
+          optional :secret_key_ref, String
+
+          # @!attribute status
+          #
+          #   @return [Symbol, Telnyx::Models::AI::AssistantCreateParams::ObservabilitySettings::Status, nil]
+          optional :status, enum: -> { Telnyx::AI::AssistantCreateParams::ObservabilitySettings::Status }
+
+          # @!method initialize(host: nil, public_key_ref: nil, secret_key_ref: nil, status: nil)
+          #   @param host [String]
+          #   @param public_key_ref [String]
+          #   @param secret_key_ref [String]
+          #   @param status [Symbol, Telnyx::Models::AI::AssistantCreateParams::ObservabilitySettings::Status]
+
+          # @see Telnyx::Models::AI::AssistantCreateParams::ObservabilitySettings#status
+          module Status
+            extend Telnyx::Internal::Type::Enum
+
+            ENABLED = :enabled
+            DISABLED = :disabled
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
       end
     end
   end

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

@@ -28,7 +28,7 @@ module Telnyx
 
         variant :send_dtmf, -> { Telnyx::AI::AssistantTool::SendDtmf }
 
-        # 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.
+        # 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.
         variant :send_message, -> { Telnyx::AI::AssistantTool::SendMessage }
 
         variant :skip_turn, -> { Telnyx::AI::AssistantTool::SkipTurn }
@@ -792,8 +792,8 @@ module Telnyx
         class SendMessage < Telnyx::Internal::Type::BaseModel
           # @!attribute send_message
           #
-          #   @return [Hash{Symbol=>Object}]
-          required :send_message, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+          #   @return [Telnyx::Models::AI::AssistantTool::SendMessage::SendMessage]
+          required :send_message, -> { Telnyx::AI::AssistantTool::SendMessage::SendMessage }
 
           # @!attribute type
           #
@@ -803,10 +803,30 @@ module Telnyx
           # @!method initialize(send_message:, type: :send_message)
           #   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.
+          #   conversation context, and the message text is generated by the assistant unless
+          #   a message_template is provided for runtime variable substitution.
           #
-          #   @param send_message [Hash{Symbol=>Object}]
+          #   @param send_message [Telnyx::Models::AI::AssistantTool::SendMessage::SendMessage]
           #   @param type [Symbol, :send_message]
+
+          # @see Telnyx::Models::AI::AssistantTool::SendMessage#send_message
+          class SendMessage < Telnyx::Internal::Type::BaseModel
+            # @!attribute message_template
+            #   Optional message template with dynamic variable support using mustache syntax
+            #   (e.g., {{variable_name}}). When set, the assistant will use this template for
+            #   the SMS body instead of generating one. Dynamic variables like
+            #   {{telnyx_end_user_target}}, {{telnyx_agent_target}}, and custom webhook-provided
+            #   variables will be resolved at runtime.
+            #
+            #   @return [String, nil]
+            optional :message_template, String, nil?: true
+
+            # @!method initialize(message_template: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {Telnyx::Models::AI::AssistantTool::SendMessage::SendMessage} for more details.
+            #
+            #   @param message_template [String, nil] Optional message template with dynamic variable support using mustache syntax (e
+          end
         end
 
         class SkipTurn < Telnyx::Internal::Type::BaseModel

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

@@ -89,6 +89,11 @@ module Telnyx
         #   @return [String, nil]
         optional :name, String
 
+        # @!attribute observability_settings
+        #
+        #   @return [Telnyx::Models::AI::AssistantUpdateParams::ObservabilitySettings, nil]
+        optional :observability_settings, -> { Telnyx::AI::AssistantUpdateParams::ObservabilitySettings }
+
         # @!attribute privacy_settings
         #
         #   @return [Telnyx::Models::AI::PrivacySettings, nil]
@@ -134,7 +139,7 @@ module Telnyx
         #   @return [Telnyx::Models::AI::WidgetSettings, nil]
         optional :widget_settings, -> { Telnyx::AI::WidgetSettings }
 
-        # @!method initialize(assistant_id:, description: nil, dynamic_variables: nil, dynamic_variables_webhook_url: nil, enabled_features: nil, greeting: nil, insight_settings: nil, instructions: nil, llm_api_key_ref: nil, messaging_settings: nil, model: nil, name: nil, privacy_settings: nil, promote_to_main: nil, telephony_settings: nil, tool_ids: nil, tools: nil, transcription: nil, voice_settings: nil, widget_settings: nil, request_options: {})
+        # @!method initialize(assistant_id:, description: nil, dynamic_variables: nil, dynamic_variables_webhook_url: nil, enabled_features: nil, greeting: nil, insight_settings: nil, instructions: nil, llm_api_key_ref: nil, messaging_settings: nil, model: nil, name: nil, observability_settings: nil, privacy_settings: nil, promote_to_main: nil, telephony_settings: nil, tool_ids: nil, tools: nil, transcription: nil, voice_settings: nil, widget_settings: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::AssistantUpdateParams} for more details.
         #
@@ -162,6 +167,8 @@ module Telnyx
         #
         #   @param name [String]
         #
+        #   @param observability_settings [Telnyx::Models::AI::AssistantUpdateParams::ObservabilitySettings]
+        #
         #   @param privacy_settings [Telnyx::Models::AI::PrivacySettings]
         #
         #   @param promote_to_main [Boolean] Indicates whether the assistant should be promoted to the main version. Defaults
@@ -179,6 +186,45 @@ module Telnyx
         #   @param widget_settings [Telnyx::Models::AI::WidgetSettings] Configuration settings for the assistant's web widget.
         #
         #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+
+        class ObservabilitySettings < Telnyx::Internal::Type::BaseModel
+          # @!attribute host
+          #
+          #   @return [String, nil]
+          optional :host, String
+
+          # @!attribute public_key_ref
+          #
+          #   @return [String, nil]
+          optional :public_key_ref, String
+
+          # @!attribute secret_key_ref
+          #
+          #   @return [String, nil]
+          optional :secret_key_ref, String
+
+          # @!attribute status
+          #
+          #   @return [Symbol, Telnyx::Models::AI::AssistantUpdateParams::ObservabilitySettings::Status, nil]
+          optional :status, enum: -> { Telnyx::AI::AssistantUpdateParams::ObservabilitySettings::Status }
+
+          # @!method initialize(host: nil, public_key_ref: nil, secret_key_ref: nil, status: nil)
+          #   @param host [String]
+          #   @param public_key_ref [String]
+          #   @param secret_key_ref [String]
+          #   @param status [Symbol, Telnyx::Models::AI::AssistantUpdateParams::ObservabilitySettings::Status]
+
+          # @see Telnyx::Models::AI::AssistantUpdateParams::ObservabilitySettings#status
+          module Status
+            extend Telnyx::Internal::Type::Enum
+
+            ENABLED = :enabled
+            DISABLED = :disabled
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
       end
     end
   end

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

@@ -81,6 +81,11 @@ module Telnyx
           #   @return [String, nil]
           optional :name, String
 
+          # @!attribute observability_settings
+          #
+          #   @return [Telnyx::Models::AI::Assistants::UpdateAssistant::ObservabilitySettings, nil]
+          optional :observability_settings, -> { Telnyx::AI::Assistants::UpdateAssistant::ObservabilitySettings }
+
           # @!attribute privacy_settings
           #
           #   @return [Telnyx::Models::AI::PrivacySettings, nil]
@@ -119,7 +124,7 @@ module Telnyx
           #   @return [Telnyx::Models::AI::WidgetSettings, nil]
           optional :widget_settings, -> { Telnyx::AI::WidgetSettings }
 
-          # @!method initialize(description: nil, dynamic_variables: nil, dynamic_variables_webhook_url: nil, enabled_features: nil, greeting: nil, insight_settings: nil, instructions: nil, llm_api_key_ref: nil, messaging_settings: nil, model: nil, name: nil, privacy_settings: nil, telephony_settings: nil, tool_ids: nil, tools: nil, transcription: nil, voice_settings: nil, widget_settings: nil)
+          # @!method initialize(description: nil, dynamic_variables: nil, dynamic_variables_webhook_url: nil, enabled_features: nil, greeting: nil, insight_settings: nil, instructions: nil, llm_api_key_ref: nil, messaging_settings: nil, model: nil, name: nil, observability_settings: nil, privacy_settings: nil, telephony_settings: nil, tool_ids: nil, tools: nil, transcription: nil, voice_settings: nil, widget_settings: nil)
           #   Some parameter documentations has been truncated, see
           #   {Telnyx::Models::AI::Assistants::UpdateAssistant} for more details.
           #
@@ -145,6 +150,8 @@ module Telnyx
           #
           #   @param name [String]
           #
+          #   @param observability_settings [Telnyx::Models::AI::Assistants::UpdateAssistant::ObservabilitySettings]
+          #
           #   @param privacy_settings [Telnyx::Models::AI::PrivacySettings]
           #
           #   @param telephony_settings [Telnyx::Models::AI::TelephonySettings]
@@ -158,6 +165,46 @@ module Telnyx
           #   @param voice_settings [Telnyx::Models::AI::VoiceSettings]
           #
           #   @param widget_settings [Telnyx::Models::AI::WidgetSettings] Configuration settings for the assistant's web widget.
+
+          # @see Telnyx::Models::AI::Assistants::UpdateAssistant#observability_settings
+          class ObservabilitySettings < Telnyx::Internal::Type::BaseModel
+            # @!attribute host
+            #
+            #   @return [String, nil]
+            optional :host, String
+
+            # @!attribute public_key_ref
+            #
+            #   @return [String, nil]
+            optional :public_key_ref, String
+
+            # @!attribute secret_key_ref
+            #
+            #   @return [String, nil]
+            optional :secret_key_ref, String
+
+            # @!attribute status
+            #
+            #   @return [Symbol, Telnyx::Models::AI::Assistants::UpdateAssistant::ObservabilitySettings::Status, nil]
+            optional :status, enum: -> { Telnyx::AI::Assistants::UpdateAssistant::ObservabilitySettings::Status }
+
+            # @!method initialize(host: nil, public_key_ref: nil, secret_key_ref: nil, status: nil)
+            #   @param host [String]
+            #   @param public_key_ref [String]
+            #   @param secret_key_ref [String]
+            #   @param status [Symbol, Telnyx::Models::AI::Assistants::UpdateAssistant::ObservabilitySettings::Status]
+
+            # @see Telnyx::Models::AI::Assistants::UpdateAssistant::ObservabilitySettings#status
+            module Status
+              extend Telnyx::Internal::Type::Enum
+
+              ENABLED = :enabled
+              DISABLED = :disabled
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
         end
       end
 

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

@@ -12,29 +12,46 @@ module Telnyx
         required :text, String
 
         # @!attribute duration
-        #   The duration of the audio file in seconds. This is only included if
-        #   `response_format` is set to `verbose_json`.
+        #   The duration of the audio file in seconds. Returned by
+        #   `distil-whisper/distil-large-v2` and `deepgram/nova-3` when `response_format` is
+        #   `verbose_json`. Not returned by `openai/whisper-large-v3-turbo`.
         #
         #   @return [Float, nil]
         optional :duration, Float
 
         # @!attribute segments
-        #   Segments of the transcribed text and their corresponding details. This is only
-        #   included if `response_format` is set to `verbose_json`.
+        #   Segments of the transcribed text and their corresponding details. Returned by
+        #   `distil-whisper/distil-large-v2` when `response_format` is `verbose_json`. Not
+        #   returned by `openai/whisper-large-v3-turbo`.
         #
         #   @return [Array<Telnyx::Models::AI::AudioTranscribeResponse::Segment>, nil]
         optional :segments,
                  -> { Telnyx::Internal::Type::ArrayOf[Telnyx::Models::AI::AudioTranscribeResponse::Segment] }
 
-        # @!method initialize(text:, duration: nil, segments: nil)
+        # @!attribute words
+        #   Word-level timestamps and optional speaker labels. Only returned by
+        #   `deepgram/nova-3` when word-level output is enabled via `model_config`.
+        #
+        #   @return [Array<Telnyx::Models::AI::AudioTranscribeResponse::Word>, nil]
+        optional :words, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::Models::AI::AudioTranscribeResponse::Word] }
+
+        # @!method initialize(text:, duration: nil, segments: nil, words: nil)
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::AudioTranscribeResponse} for more details.
         #
+        #   Response fields vary by model. `distil-whisper/distil-large-v2` returns `text`,
+        #   `duration`, and `segments` in `verbose_json` mode.
+        #   `openai/whisper-large-v3-turbo` returns `text` only. `deepgram/nova-3` returns
+        #   `text` and, depending on `model_config`, may include `words` with per-word
+        #   timestamps and speaker labels.
+        #
         #   @param text [String] The transcribed text for the audio file.
         #
-        #   @param duration [Float] The duration of the audio file in seconds. This is only included if `response_fo
+        #   @param duration [Float] The duration of the audio file in seconds. Returned by `distil-whisper/distil-la
+        #
+        #   @param segments [Array<Telnyx::Models::AI::AudioTranscribeResponse::Segment>] Segments of the transcribed text and their corresponding details. Returned by `d
         #
-        #   @param segments [Array<Telnyx::Models::AI::AudioTranscribeResponse::Segment>] Segments of the transcribed text and their corresponding details. This is only i
+        #   @param words [Array<Telnyx::Models::AI::AudioTranscribeResponse::Word>] Word-level timestamps and optional speaker labels. Only returned by `deepgram/no
 
         class Segment < Telnyx::Internal::Type::BaseModel
           # @!attribute id
@@ -70,6 +87,52 @@ module Telnyx
           #
           #   @param text [String] Text content of the segment.
         end
+
+        class Word < Telnyx::Internal::Type::BaseModel
+          # @!attribute end_
+          #   End time of the word in seconds.
+          #
+          #   @return [Float]
+          required :end_, Float, api_name: :end
+
+          # @!attribute start
+          #   Start time of the word in seconds.
+          #
+          #   @return [Float]
+          required :start, Float
+
+          # @!attribute word
+          #   The transcribed word.
+          #
+          #   @return [String]
+          required :word, String
+
+          # @!attribute confidence
+          #   Confidence score for the word (0.0 to 1.0).
+          #
+          #   @return [Float, nil]
+          optional :confidence, Float
+
+          # @!attribute speaker
+          #   Speaker index. Only present when diarization is enabled via `model_config`.
+          #
+          #   @return [Integer, nil]
+          optional :speaker, Integer
+
+          # @!method initialize(end_:, start:, word:, confidence: nil, speaker: nil)
+          #   Word-level timing detail. Only present when using `deepgram/nova-3` with
+          #   `model_config` options that enable word timestamps.
+          #
+          #   @param end_ [Float] End time of the word in seconds.
+          #
+          #   @param start [Float] Start time of the word in seconds.
+          #
+          #   @param word [String] The transcribed word.
+          #
+          #   @param confidence [Float] Confidence score for the word (0.0 to 1.0).
+          #
+          #   @param speaker [Integer] Speaker index. Only present when diarization is enabled via `model_config`.
+        end
       end
     end
   end