telnyx 5.171.0 → 5.173.0

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

@@ -17,6 +17,8 @@ module Telnyx
         #   English only (`en` and its regional variants, e.g. `en-US`, `en-GB`).
         #   `nvidia/parakeet-v3` is multilingual with automatic language detection;
         #   `omi-health/omi-med-stt-v1` is a medical model, English only.
+        #   `reson8/prerecorded` covers 10 languages, returns word timestamps, and labels
+        #   speakers via `model_config`.
         #
         #   @return [Symbol, Telnyx::Models::AI::AudioTranscribeParams::Model]
         required :model, enum: -> { Telnyx::AI::AudioTranscribeParams::Model }
@@ -49,17 +51,25 @@ module Telnyx
         #   `openai/whisper-large-v3-turbo`, supports multiple languages.
         #   `distil-whisper/distil-large-v2` does not support language parameter.
         #   `nvidia/parakeet-v3` detects the language automatically;
-        #   `omi-health/omi-med-stt-v1` is English only.
+        #   `omi-health/omi-med-stt-v1` is English only. `reson8/prerecorded` accepts `nl`,
+        #   `en`, `fr`, `fy`, `de`, `it`, `pl`, `pt`, `es` and `sv` (regional variants are
+        #   transcribed as the base language) and detects the language when it is omitted.
         #
         #   @return [String, nil]
         optional :language, String
 
         # @!attribute model_config
         #   Additional model-specific configuration parameters. Only allowed with the
-        #   `deepgram/*` models. Can include Deepgram-specific options such as
-        #   `smart_format`, `punctuate`, `diarize`, `utterance`, `numerals`, and `language`.
-        #   If `language` is provided both as a top-level parameter and in `model_config`,
-        #   the top-level parameter takes precedence.
+        #   `deepgram/*` models and `reson8/prerecorded`. Sent as a JSON string in multipart
+        #   requests; for the `deepgram/*` models it is passed through to Deepgram as query
+        #   parameters, while `reson8/prerecorded` accepts only `diarize` (speaker labels)
+        #   and `max_speakers` (1 to 8). Any other model with `model_config` returns 400.
+        #   Can include Deepgram-specific options such as `smart_format`, `punctuate`,
+        #   `diarize` (speaker labels), `multichannel` (transcribe each channel
+        #   independently; billed duration is file duration multiplied by the number of
+        #   channels), `utterances`, `numerals`, and `language`. If `language` is provided
+        #   both as a top-level parameter and in `model_config`, the top-level parameter
+        #   takes precedence.
         #
         #   @return [Hash{Symbol=>Object}, nil]
         optional :model_config, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
@@ -109,6 +119,8 @@ module Telnyx
         # English only (`en` and its regional variants, e.g. `en-US`, `en-GB`).
         # `nvidia/parakeet-v3` is multilingual with automatic language detection;
         # `omi-health/omi-med-stt-v1` is a medical model, English only.
+        # `reson8/prerecorded` covers 10 languages, returns word timestamps, and labels
+        # speakers via `model_config`.
         module Model
           extend Telnyx::Internal::Type::Enum
 
@@ -120,6 +132,7 @@ module Telnyx
           DEEPGRAM_NOVA_3_MEDICAL = :"deepgram/nova-3-medical"
           NVIDIA_PARAKEET_V3 = :"nvidia/parakeet-v3"
           OMI_HEALTH_OMI_MED_STT_V1 = :"omi-health/omi-med-stt-v1"
+          RESON8_PRERECORDED = :"reson8/prerecorded"
 
           # @!method self.values
           #   @return [Array<Symbol>]

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

@@ -47,6 +47,9 @@ module Telnyx
         #   return `text` and, depending on `model_config`, may include `words` with
         #   per-word timestamps and speaker labels. The Parakeet models
         #   (`nvidia/parakeet-v3`, `omi-health/omi-med-stt-v1`) return `text` only.
+        #   `reson8/prerecorded` returns `text` and, in `verbose_json` mode, `duration` and
+        #   `segments` with `words`; with `diarize`, one segment per speaker turn with
+        #   speaker labels.
         #
         #   @param text [String] The transcribed text for the audio file.
         #
@@ -81,21 +84,33 @@ module Telnyx
           #   @return [String]
           required :text, String
 
+          # @!attribute channel
+          #   Zero-indexed audio channel of this segment. Returned by the `deepgram/*` models
+          #   when `multichannel` is enabled via `model_config` and the file has more than one
+          #   channel. Segments from all channels are merged in one list ordered by start
+          #   time.
+          #
+          #   @return [Integer, nil]
+          optional :channel, Integer
+
           # @!attribute speakers
-          #   Speaker indices heard in this segment. Returned by the `deepgram/*` models when
-          #   `diarize` is enabled via `model_config`.
+          #   Speaker indices heard in this segment. Returned by the `deepgram/*` models and
+          #   `reson8/prerecorded` when `diarize` is enabled via `model_config`. With
+          #   `multichannel`, speakers are numbered per channel from 0, so identify a speaker
+          #   by (`channel`, speaker).
           #
           #   @return [Array<Integer>, nil]
           optional :speakers, Telnyx::Internal::Type::ArrayOf[Integer]
 
           # @!attribute words
           #   Word-level timing detail for this segment. Returned by the `deepgram/*` models
-          #   when word-level output is enabled via `model_config`.
+          #   when word-level output is enabled via `model_config`, and by
+          #   `reson8/prerecorded`.
           #
           #   @return [Array<Telnyx::Models::AI::AudioTranscriptionResponseWord>, nil]
           optional :words, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::AI::AudioTranscriptionResponseWord] }
 
-          # @!method initialize(id:, end_:, start:, text:, speakers: nil, words: nil)
+          # @!method initialize(id:, end_:, start:, text:, channel: nil, speakers: nil, words: nil)
           #   Some parameter documentations has been truncated, see
           #   {Telnyx::Models::AI::AudioTranscribeResponse::Segment} for more details.
           #
@@ -107,7 +122,9 @@ module Telnyx
           #
           #   @param text [String] Text content of the segment.
           #
-          #   @param speakers [Array<Integer>] Speaker indices heard in this segment. Returned by the `deepgram/*` models when
+          #   @param channel [Integer] Zero-indexed audio channel of this segment. Returned by the `deepgram/*` models
+          #
+          #   @param speakers [Array<Integer>] Speaker indices heard in this segment. Returned by the `deepgram/*` models and `
           #
           #   @param words [Array<Telnyx::Models::AI::AudioTranscriptionResponseWord>] Word-level timing detail for this segment. Returned by the `deepgram/*` models w
         end

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

@@ -53,7 +53,7 @@ module Telnyx
         #   {Telnyx::Models::AI::AudioTranscriptionResponseWord} for more details.
         #
         #   Word-level timing detail. Only present when using a `deepgram/*` model with
-        #   `model_config` options that enable word timestamps.
+        #   `model_config` options that enable word timestamps, or `reson8/prerecorded`.
         #
         #   @param end_ [Float] End time of the word in seconds.
         #

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

@@ -0,0 +1,151 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      # @see Telnyx::Resources::AI::Avatars#list
+      class Avatar < Telnyx::Internal::Type::BaseModel
+        # @!attribute id
+        #   Stable identifier returned by the Avatars API. Discover available stock IDs with
+        #   GET /v2/ai/avatars and filter[avatar_type]=stock rather than maintaining a fixed
+        #   list. Custom avatar IDs use the `avatar_` prefix and must belong to the
+        #   authenticated organization. The service validates that the selected avatar is
+        #   available.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute avatar_type
+        #   Whether the avatar is provided by Telnyx or was uploaded by the authenticated
+        #   organization.
+        #
+        #   @return [Symbol, Telnyx::Models::AI::AvatarType]
+        required :avatar_type, enum: -> { Telnyx::AI::AvatarType }
+
+        # @!attribute hosted
+        #   Indicates that avatar rendering runs on Telnyx-operated infrastructure.
+        #
+        #   @return [Boolean, true]
+        required :hosted, const: true
+
+        # @!attribute image_url
+        #   HTTPS image URL suitable for an avatar selection thumbnail. If the URL expires,
+        #   list or retrieve the avatar again to refresh it.
+        #
+        #   @return [String]
+        required :image_url, String
+
+        # @!attribute name
+        #   Customer-facing avatar name.
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute provider
+        #   Avatar provider. The first release supports Telnyx avatars.
+        #
+        #   @return [Symbol, :telnyx]
+        required :provider, const: :telnyx
+
+        # @!attribute content_type
+        #   MIME type of a custom avatar image.
+        #
+        #   @return [Symbol, Telnyx::Models::AI::Avatar::ContentType, nil]
+        optional :content_type, enum: -> { Telnyx::AI::Avatar::ContentType }
+
+        # @!attribute created_at
+        #   Time when the custom avatar was created.
+        #
+        #   @return [Time, nil]
+        optional :created_at, Time
+
+        # @!attribute height_px
+        #   Decoded height of a custom avatar image.
+        #
+        #   @return [Integer, nil]
+        optional :height_px, Integer
+
+        # @!attribute image_url_expires_at
+        #   Expiration time of `image_url`. Omitted when the URL does not expire.
+        #
+        #   @return [Time, nil]
+        optional :image_url_expires_at, Time
+
+        # @!attribute size_bytes
+        #   Size of a custom avatar image in bytes.
+        #
+        #   @return [Integer, nil]
+        optional :size_bytes, Integer
+
+        # @!attribute updated_at
+        #   Time when the custom avatar was last updated.
+        #
+        #   @return [Time, nil]
+        optional :updated_at, Time
+
+        # @!attribute width_px
+        #   Decoded width of a custom avatar image.
+        #
+        #   @return [Integer, nil]
+        optional :width_px, Integer
+
+        response_only do
+          # @!attribute suggested_voice_id
+          #   Optional recommended Telnyx text-to-speech voice for this avatar. An omitted
+          #   field or empty string means no recommendation is available. Custom avatars have
+          #   no suggested voice. It is informational and selecting the avatar does not
+          #   automatically change the AI Assistant's configured voice.
+          #
+          #   @return [String, nil]
+          optional :suggested_voice_id, String
+        end
+
+        # @!method initialize(id:, avatar_type:, image_url:, name:, content_type: nil, created_at: nil, height_px: nil, image_url_expires_at: nil, size_bytes: nil, suggested_voice_id: nil, updated_at: nil, width_px: nil, hosted: true, provider: :telnyx)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::AI::Avatar} for more details.
+        #
+        #   @param id [String] Stable identifier returned by the Avatars API. Discover available stock IDs with
+        #
+        #   @param avatar_type [Symbol, Telnyx::Models::AI::AvatarType] Whether the avatar is provided by Telnyx or was uploaded by the authenticated or
+        #
+        #   @param image_url [String] HTTPS image URL suitable for an avatar selection thumbnail. If the URL expires,
+        #
+        #   @param name [String] Customer-facing avatar name.
+        #
+        #   @param content_type [Symbol, Telnyx::Models::AI::Avatar::ContentType] MIME type of a custom avatar image.
+        #
+        #   @param created_at [Time] Time when the custom avatar was created.
+        #
+        #   @param height_px [Integer] Decoded height of a custom avatar image.
+        #
+        #   @param image_url_expires_at [Time] Expiration time of `image_url`. Omitted when the URL does not expire.
+        #
+        #   @param size_bytes [Integer] Size of a custom avatar image in bytes.
+        #
+        #   @param suggested_voice_id [String] Optional recommended Telnyx text-to-speech voice for this avatar. An omitted fie
+        #
+        #   @param updated_at [Time] Time when the custom avatar was last updated.
+        #
+        #   @param width_px [Integer] Decoded width of a custom avatar image.
+        #
+        #   @param hosted [Boolean, true] Indicates that avatar rendering runs on Telnyx-operated infrastructure.
+        #
+        #   @param provider [Symbol, :telnyx] Avatar provider. The first release supports Telnyx avatars.
+
+        # MIME type of a custom avatar image.
+        #
+        # @see Telnyx::Models::AI::Avatar#content_type
+        module ContentType
+          extend Telnyx::Internal::Type::Enum
+
+          IMAGE_JPEG = :"image/jpeg"
+          IMAGE_PNG = :"image/png"
+          IMAGE_WEBP = :"image/webp"
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      # @see Telnyx::Resources::AI::Avatars#create
+      class AvatarCreateParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        # @!attribute image_file
+        #   JPEG, PNG, or WebP image file. The maximum file size is 10 MiB.
+        #
+        #   @return [Pathname, StringIO, IO, String, Telnyx::FilePart]
+        required :image_file, Telnyx::Internal::Type::FileInput
+
+        # @!attribute name
+        #   Customer-facing name of the custom avatar.
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!method initialize(image_file:, name:, request_options: {})
+        #   @param image_file [Pathname, StringIO, IO, String, Telnyx::FilePart] JPEG, PNG, or WebP image file. The maximum file size is 10 MiB.
+        #
+        #   @param name [String] Customer-facing name of the custom avatar.
+        #
+        #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      AvatarID = String
+    end
+  end
+end

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

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      # @see Telnyx::Resources::AI::Avatars#list
+      class AvatarListParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        # @!attribute filter_avatar_type
+        #   Return only stock or custom avatars.
+        #
+        #   @return [Symbol, Telnyx::Models::AI::AvatarType, nil]
+        optional :filter_avatar_type, enum: -> { Telnyx::AI::AvatarType }
+
+        # @!attribute filter_id
+        #   Return the avatar with this exact ID.
+        #
+        #   @return [String, nil]
+        optional :filter_id, String
+
+        # @!attribute filter_name
+        #   Return avatars whose names contain this value, using case-insensitive matching.
+        #
+        #   @return [String, nil]
+        optional :filter_name, String
+
+        # @!attribute page_number
+        #   Page number to retrieve, starting at 1.
+        #
+        #   @return [Integer, nil]
+        optional :page_number, Integer
+
+        # @!attribute page_size
+        #   Number of avatars to return per page.
+        #
+        #   @return [Integer, nil]
+        optional :page_size, Integer
+
+        # @!method initialize(filter_avatar_type: nil, filter_id: nil, filter_name: nil, page_number: nil, page_size: nil, request_options: {})
+        #   @param filter_avatar_type [Symbol, Telnyx::Models::AI::AvatarType] Return only stock or custom avatars.
+        #
+        #   @param filter_id [String] Return the avatar with this exact ID.
+        #
+        #   @param filter_name [String] Return avatars whose names contain this value, using case-insensitive matching.
+        #
+        #   @param page_number [Integer] Page number to retrieve, starting at 1.
+        #
+        #   @param page_size [Integer] Number of avatars to return per page.
+        #
+        #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      # @see Telnyx::Resources::AI::Avatars#create
+      class AvatarResponse < Telnyx::Internal::Type::BaseModel
+        # @!attribute data
+        #
+        #   @return [Telnyx::Models::AI::Avatar]
+        required :data, -> { Telnyx::AI::Avatar }
+
+        # @!method initialize(data:)
+        #   @param data [Telnyx::Models::AI::Avatar]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      # @see Telnyx::Resources::AI::Avatars#retrieve
+      class AvatarRetrieveParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        # @!attribute avatar_id
+        #   Stable identifier returned by the Avatars API. Discover available stock IDs with
+        #   GET /v2/ai/avatars and filter[avatar_type]=stock rather than maintaining a fixed
+        #   list. Custom avatar IDs use the `avatar_` prefix and must belong to the
+        #   authenticated organization. The service validates that the selected avatar is
+        #   available.
+        #
+        #   @return [String]
+        required :avatar_id, String
+
+        # @!method initialize(avatar_id:, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::AI::AvatarRetrieveParams} for more details.
+        #
+        #   @param avatar_id [String] Stable identifier returned by the Avatars API. Discover available stock IDs with
+        #
+        #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

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

@@ -5,10 +5,10 @@ module Telnyx
     module AI
       class AvatarSettingsRequest < Telnyx::Internal::Type::BaseModel
         # @!attribute avatar_id
-        #   The Telnyx avatar to render.
+        #   The Telnyx stock avatar or organization-owned custom avatar to render.
         #
-        #   @return [Symbol, Telnyx::Models::AI::AvatarSettingsRequest::AvatarID]
-        required :avatar_id, enum: -> { Telnyx::AI::AvatarSettingsRequest::AvatarID }
+        #   @return [String]
+        required :avatar_id, String
 
         # @!attribute background_id
         #   The background to render.
@@ -33,10 +33,12 @@ module Telnyx
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::AvatarSettingsRequest} for more details.
         #
-        #   **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.
         #
-        #   @param avatar_id [Symbol, Telnyx::Models::AI::AvatarSettingsRequest::AvatarID] The Telnyx avatar to render.
+        #   @param avatar_id [String] The Telnyx stock avatar or organization-owned custom avatar to render.
         #
         #   @param background_id [Symbol, Telnyx::Models::AI::AvatarSettingsRequest::BackgroundID] The background to render.
         #
@@ -44,23 +46,6 @@ module Telnyx
         #
         #   @param provider [Symbol, :telnyx] Selects the Telnyx open-source avatar provider.
 
-        # The Telnyx avatar to render.
-        #
-        # @see Telnyx::Models::AI::AvatarSettingsRequest#avatar_id
-        module AvatarID
-          extend Telnyx::Internal::Type::Enum
-
-          ELENA = :elena
-          BEN = :ben
-          JORDAN = :jordan
-          LIN = :lin
-          AVERY = :avery
-          RAPHAEL = :raphael
-
-          # @!method self.values
-          #   @return [Array<Symbol>]
-        end
-
         # The background to render.
         #
         # @see Telnyx::Models::AI::AvatarSettingsRequest#background_id
@@ -70,6 +55,7 @@ module Telnyx
           OFFICE = :office
           STUDIO = :studio
           RECEPTION = :reception
+          ILLUSTRATED_WORKSPACE = :illustrated_workspace
 
           # @!method self.values
           #   @return [Array<Symbol>]

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

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      # Whether the avatar is provided by Telnyx or was uploaded by the authenticated
+      # organization.
+      module AvatarType
+        extend Telnyx::Internal::Type::Enum
+
+        STOCK = :stock
+        CUSTOM = :custom
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      # @see Telnyx::Resources::AI::Avatars#update
+      class AvatarUpdateParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        # @!attribute avatar_id
+        #   Stable identifier returned by the Avatars API. Discover available stock IDs with
+        #   GET /v2/ai/avatars and filter[avatar_type]=stock rather than maintaining a fixed
+        #   list. Custom avatar IDs use the `avatar_` prefix and must belong to the
+        #   authenticated organization. The service validates that the selected avatar is
+        #   available.
+        #
+        #   @return [String]
+        required :avatar_id, String
+
+        # @!attribute name
+        #   New customer-facing name of the custom avatar.
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!method initialize(avatar_id:, name:, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::AI::AvatarUpdateParams} for more details.
+        #
+        #   @param avatar_id [String] Stable identifier returned by the Avatars API. Discover available stock IDs with
+        #
+        #   @param name [String] New customer-facing name of the custom avatar.
+        #
+        #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

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

@@ -78,7 +78,7 @@ module Telnyx
         #   follow-up fetch per shared tool. Ignored on input — set `shared_tool_ids` to
         #   configure a node's tools.
         #
-        #   @return [Array<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<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[Telnyx::Internal::Type::ArrayOf[union: Telnyx::AI::AssistantTool]] }
 
@@ -132,7 +132,7 @@ module Telnyx
         #
         #   @param shared_tool_ids [Array<String>] IDs of shared (org-level) tools available at this node. Knowledge bases are atta
         #
-        #   @param tools [Array<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>>] Full tool definitions for this node, resolved from `shared_tool_ids` server-side
+        #   @param tools [Array<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>>] Full tool definitions for this node, resolved from `shared_tool_ids` server-side
         #
         #   @param tools_mode [Symbol, Telnyx::Models::AI::FlowNode::ToolsMode] How `shared_tool_ids` combine with the assistant-level tool set. `replace` (defa
         #

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

@@ -51,8 +51,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::TelnyxAvatarSettings, nil]
         optional :avatar_settings, -> { Telnyx::AI::TelnyxAvatarSettings }, nil?: true
@@ -234,7 +236,7 @@ module Telnyx
         #   changes. Each tool type except `function`, `webhook`, and `client_side_tool`
         #   allows at most one instance per assistant across both sources.
         #
-        #   @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
@@ -298,7 +300,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::TelnyxAvatarSettings, nil] **Beta:** Configuration for the Telnyx open-source avatar provider. The launch c
+        #   @param avatar_settings [Telnyx::Models::AI::TelnyxAvatarSettings, nil] **Beta:** Configuration for the Telnyx open-source avatar provider. Use a stock
         #
         #   @param conversation_flow [Telnyx::Models::AI::ConversationFlow] Conversation flow as returned by the API.
         #
@@ -346,7 +348,7 @@ module Telnyx
         #
         #   @param telephony_settings [Telnyx::Models::AI::TelephonySettings]
         #
-        #   @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>] The assistant's tools. Responses merge the assistant's shared Tools Library tool
+        #   @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>] The assistant's tools. Responses merge the assistant's shared Tools Library tool
         #
         #   @param transcription [Telnyx::Models::AI::TranscriptionSettings]
         #

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

@@ -11,11 +11,26 @@ module Telnyx
         #   @return [String, nil]
         optional :insight_group_id, String
 
-        # @!method initialize(insight_group_id: nil)
+        # @!attribute model
+        #   The model that generates the assistant's insights when a conversation ends. It
+        #   runs every insight in the group, Telnyx-managed insights included. Must be
+        #   `zai-org/GLM-5.3-Flash` or `meta-llama/Llama-3.3-70B-Instruct`; any other model
+        #   returns `422`. When omitted on create, it defaults to `zai-org/GLM-5.3-Flash`;
+        #   when omitted on update, the current model is kept. `null` uses Telnyx's default
+        #   insight models, which assistants created before this setting have. Insights of
+        #   messaging conversations, and insights regenerated later, always use Telnyx's
+        #   default insight models.
+        #
+        #   @return [String, nil]
+        optional :model, String, nil?: true
+
+        # @!method initialize(insight_group_id: nil, model: nil)
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::InsightSettings} for more details.
         #
         #   @param insight_group_id [String] Reference to an Insight Group. Insights in this group will be run automatically
+        #
+        #   @param model [String, nil] The model that generates the assistant's insights when a conversation ends. It r
       end
     end
   end