telnyx 5.171.0 → 5.173.0

data/rbi/telnyx/models/ai/avatar_settings_request.rbi

@@ -9,8 +9,8 @@ module Telnyx
             T.any(Telnyx::AI::AvatarSettingsRequest, Telnyx::Internal::AnyHash)
           end
 
-        # The Telnyx avatar to render.
-        sig { returns(Telnyx::AI::AvatarSettingsRequest::AvatarID::OrSymbol) }
+        # The Telnyx stock avatar or organization-owned custom avatar to render.
+        sig { returns(String) }
         attr_accessor :avatar_id
 
         # The background to render.
@@ -28,11 +28,13 @@ module Telnyx
         sig { returns(Symbol) }
         attr_accessor :provider
 
-        # **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.
         sig do
           params(
-            avatar_id: Telnyx::AI::AvatarSettingsRequest::AvatarID::OrSymbol,
+            avatar_id: String,
             background_id:
               Telnyx::AI::AvatarSettingsRequest::BackgroundID::OrSymbol,
             model: Telnyx::AI::AvatarSettingsRequest::Model::OrSymbol,
@@ -40,7 +42,7 @@ module Telnyx
           ).returns(T.attached_class)
         end
         def self.new(
-          # The Telnyx avatar to render.
+          # The Telnyx stock avatar or organization-owned custom avatar to render.
           avatar_id:,
           # The background to render.
           background_id:,
@@ -55,7 +57,7 @@ module Telnyx
         sig do
           override.returns(
             {
-              avatar_id: Telnyx::AI::AvatarSettingsRequest::AvatarID::OrSymbol,
+              avatar_id: String,
               background_id:
                 Telnyx::AI::AvatarSettingsRequest::BackgroundID::OrSymbol,
               model: Telnyx::AI::AvatarSettingsRequest::Model::OrSymbol,
@@ -66,58 +68,6 @@ module Telnyx
         def to_hash
         end
 
-        # The Telnyx avatar to render.
-        module AvatarID
-          extend Telnyx::Internal::Type::Enum
-
-          TaggedSymbol =
-            T.type_alias do
-              T.all(Symbol, Telnyx::AI::AvatarSettingsRequest::AvatarID)
-            end
-          OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-          ELENA =
-            T.let(
-              :elena,
-              Telnyx::AI::AvatarSettingsRequest::AvatarID::TaggedSymbol
-            )
-          BEN =
-            T.let(
-              :ben,
-              Telnyx::AI::AvatarSettingsRequest::AvatarID::TaggedSymbol
-            )
-          JORDAN =
-            T.let(
-              :jordan,
-              Telnyx::AI::AvatarSettingsRequest::AvatarID::TaggedSymbol
-            )
-          LIN =
-            T.let(
-              :lin,
-              Telnyx::AI::AvatarSettingsRequest::AvatarID::TaggedSymbol
-            )
-          AVERY =
-            T.let(
-              :avery,
-              Telnyx::AI::AvatarSettingsRequest::AvatarID::TaggedSymbol
-            )
-          RAPHAEL =
-            T.let(
-              :raphael,
-              Telnyx::AI::AvatarSettingsRequest::AvatarID::TaggedSymbol
-            )
-
-          sig do
-            override.returns(
-              T::Array[
-                Telnyx::AI::AvatarSettingsRequest::AvatarID::TaggedSymbol
-              ]
-            )
-          end
-          def self.values
-          end
-        end
-
         # The background to render.
         module BackgroundID
           extend Telnyx::Internal::Type::Enum
@@ -143,6 +93,11 @@ module Telnyx
               :reception,
               Telnyx::AI::AvatarSettingsRequest::BackgroundID::TaggedSymbol
             )
+          ILLUSTRATED_WORKSPACE =
+            T.let(
+              :illustrated_workspace,
+              Telnyx::AI::AvatarSettingsRequest::BackgroundID::TaggedSymbol
+            )
 
           sig do
             override.returns(

data/rbi/telnyx/models/ai/avatar_type.rbi

@@ -0,0 +1,23 @@
+# typed: strong
+
+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
+
+        TaggedSymbol = T.type_alias { T.all(Symbol, Telnyx::AI::AvatarType) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        STOCK = T.let(:stock, Telnyx::AI::AvatarType::TaggedSymbol)
+        CUSTOM = T.let(:custom, Telnyx::AI::AvatarType::TaggedSymbol)
+
+        sig { override.returns(T::Array[Telnyx::AI::AvatarType::TaggedSymbol]) }
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/models/ai/avatar_update_params.rbi

@@ -0,0 +1,61 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    module AI
+      class AvatarUpdateParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(Telnyx::AI::AvatarUpdateParams, Telnyx::Internal::AnyHash)
+          end
+
+        # 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.
+        sig { returns(String) }
+        attr_accessor :avatar_id
+
+        # New customer-facing name of the custom avatar.
+        sig { returns(String) }
+        attr_accessor :name
+
+        sig do
+          params(
+            avatar_id: String,
+            name: String,
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # 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.
+          avatar_id:,
+          # New customer-facing name of the custom avatar.
+          name:,
+          request_options: {}
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              avatar_id: String,
+              name: String,
+              request_options: Telnyx::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/models/ai/flow_node.rbi

@@ -117,6 +117,7 @@ module Telnyx
                     Telnyx::AI::AssistantTool::SendDtmf::OrHash,
                     Telnyx::AI::AssistantTool::SendMessage::OrHash,
                     Telnyx::AI::AssistantTool::SkipTurn::OrHash,
+                    Telnyx::AI::AssistantTool::Vision::OrHash,
                     Telnyx::AI::AssistantTool::Pay::OrHash,
                     Telnyx::AI::AssistantTool::UpdateDynamicVariables::OrHash
                   )
@@ -194,6 +195,7 @@ module Telnyx
                     Telnyx::AI::AssistantTool::SendDtmf::OrHash,
                     Telnyx::AI::AssistantTool::SendMessage::OrHash,
                     Telnyx::AI::AssistantTool::SkipTurn::OrHash,
+                    Telnyx::AI::AssistantTool::Vision::OrHash,
                     Telnyx::AI::AssistantTool::Pay::OrHash,
                     Telnyx::AI::AssistantTool::UpdateDynamicVariables::OrHash
                   )

data/rbi/telnyx/models/ai/inference_embedding.rbi

@@ -49,8 +49,10 @@ module Telnyx
         end
         attr_writer :a2a_agents
 
-        # **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.
         sig { returns(T.nilable(Telnyx::AI::TelnyxAvatarSettings)) }
         attr_reader :avatar_settings
 
@@ -325,6 +327,7 @@ module Telnyx
                   Telnyx::AI::AssistantTool::SendDtmf::OrHash,
                   Telnyx::AI::AssistantTool::SendMessage::OrHash,
                   Telnyx::AI::AssistantTool::SkipTurn::OrHash,
+                  Telnyx::AI::AssistantTool::Vision::OrHash,
                   Telnyx::AI::AssistantTool::Pay::OrHash,
                   Telnyx::AI::AssistantTool::UpdateDynamicVariables::OrHash
                 )
@@ -443,6 +446,7 @@ module Telnyx
                   Telnyx::AI::AssistantTool::SendDtmf::OrHash,
                   Telnyx::AI::AssistantTool::SendMessage::OrHash,
                   Telnyx::AI::AssistantTool::SkipTurn::OrHash,
+                  Telnyx::AI::AssistantTool::Vision::OrHash,
                   Telnyx::AI::AssistantTool::Pay::OrHash,
                   Telnyx::AI::AssistantTool::UpdateDynamicVariables::OrHash
                 )
@@ -478,8 +482,10 @@ module Telnyx
           # fetches combined. An agent whose card cannot be fetched costs the assistant that
           # capability for the conversation; it does not fail the call.
           a2a_agents: nil,
-          # **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.
           avatar_settings: nil,
           # Conversation flow as returned by the API.
           conversation_flow: nil,

data/rbi/telnyx/models/ai/insight_settings.rbi

@@ -17,15 +17,43 @@ module Telnyx
         sig { params(insight_group_id: String).void }
         attr_writer :insight_group_id
 
-        sig { params(insight_group_id: String).returns(T.attached_class) }
+        # 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.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :model
+
+        sig do
+          params(insight_group_id: String, model: T.nilable(String)).returns(
+            T.attached_class
+          )
+        end
         def self.new(
           # Reference to an Insight Group. Insights in this group will be run automatically
           # for all the assistant's conversations.
-          insight_group_id: nil
+          insight_group_id: nil,
+          # 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.
+          model: nil
         )
         end
 
-        sig { override.returns({ insight_group_id: String }) }
+        sig do
+          override.returns(
+            { insight_group_id: String, model: T.nilable(String) }
+          )
+        end
         def to_hash
         end
       end

data/rbi/telnyx/models/ai/privacy_settings.rbi

@@ -39,10 +39,49 @@ module Telnyx
         sig { params(in_transit_data_locality: T::Boolean).void }
         attr_writer :in_transit_data_locality
 
+        # Controls redaction of personally identifiable information (PII) from the
+        # conversation history that is stored for this assistant. `disabled` (default)
+        # stores content as-is. `redact` replaces detected PII with `<PII:type/>`
+        # placeholders (e.g. `<PII:name/>`, `<PII:phone/>`) as the stored copies are
+        # written: message content (user, assistant, and tool-result messages) and
+        # tool-call arguments are redacted when written to conversation history, so the
+        # stored transcript, its read-back via the history API, and any insights generated
+        # from the stored messages contain the placeholders instead of the PII; response
+        # bodies returned by webhook tools are redacted too, as stored in the webhook logs
+        # — a per-conversation record separate from the transcript. In the Mission Control
+        # Portal this field appears as a "PII Redaction" on/off toggle, where Enabled
+        # corresponds to `redact`. Redaction runs when the stored copy is written, after
+        # the LLM has generated its reply: the live conversation is not redacted, the
+        # assistant's tools keep receiving the full (unredacted) values during the call,
+        # and the LLM still sees full content in its context window. Call recordings
+        # (including any recording layout configured under telephony settings) and the
+        # payloads of messages/webhooks delivered during the call are never redacted by
+        # this setting. The set of detected PII types (names, street addresses, phone
+        # numbers, email addresses, government identifiers like SSN and driver's license
+        # numbers, credit card and bank account numbers, IP addresses, dates of birth, and
+        # other identifiers unique to a person) is fixed by Telnyx and cannot be
+        # configured or extended per assistant. Assistants with `redact` cannot be used
+        # for SMS/WhatsApp messaging (that combination is rejected with a 400 error);
+        # voice and web chat are unaffected.
+        sig do
+          returns(
+            T.nilable(Telnyx::AI::PrivacySettings::PiiRedaction::OrSymbol)
+          )
+        end
+        attr_reader :pii_redaction
+
+        sig do
+          params(
+            pii_redaction: Telnyx::AI::PrivacySettings::PiiRedaction::OrSymbol
+          ).void
+        end
+        attr_writer :pii_redaction
+
         sig do
           params(
             data_retention: T::Boolean,
-            in_transit_data_locality: T::Boolean
+            in_transit_data_locality: T::Boolean,
+            pii_redaction: Telnyx::AI::PrivacySettings::PiiRedaction::OrSymbol
           ).returns(T.attached_class)
         end
         def self.new(
@@ -65,17 +104,99 @@ module Telnyx
           # request entering the platform in another region is rejected rather than
           # forwarded, because forwarding it would already have moved the content across the
           # border. Defaults to false.
-          in_transit_data_locality: nil
+          in_transit_data_locality: nil,
+          # Controls redaction of personally identifiable information (PII) from the
+          # conversation history that is stored for this assistant. `disabled` (default)
+          # stores content as-is. `redact` replaces detected PII with `<PII:type/>`
+          # placeholders (e.g. `<PII:name/>`, `<PII:phone/>`) as the stored copies are
+          # written: message content (user, assistant, and tool-result messages) and
+          # tool-call arguments are redacted when written to conversation history, so the
+          # stored transcript, its read-back via the history API, and any insights generated
+          # from the stored messages contain the placeholders instead of the PII; response
+          # bodies returned by webhook tools are redacted too, as stored in the webhook logs
+          # — a per-conversation record separate from the transcript. In the Mission Control
+          # Portal this field appears as a "PII Redaction" on/off toggle, where Enabled
+          # corresponds to `redact`. Redaction runs when the stored copy is written, after
+          # the LLM has generated its reply: the live conversation is not redacted, the
+          # assistant's tools keep receiving the full (unredacted) values during the call,
+          # and the LLM still sees full content in its context window. Call recordings
+          # (including any recording layout configured under telephony settings) and the
+          # payloads of messages/webhooks delivered during the call are never redacted by
+          # this setting. The set of detected PII types (names, street addresses, phone
+          # numbers, email addresses, government identifiers like SSN and driver's license
+          # numbers, credit card and bank account numbers, IP addresses, dates of birth, and
+          # other identifiers unique to a person) is fixed by Telnyx and cannot be
+          # configured or extended per assistant. Assistants with `redact` cannot be used
+          # for SMS/WhatsApp messaging (that combination is rejected with a 400 error);
+          # voice and web chat are unaffected.
+          pii_redaction: nil
         )
         end
 
         sig do
           override.returns(
-            { data_retention: T::Boolean, in_transit_data_locality: T::Boolean }
+            {
+              data_retention: T::Boolean,
+              in_transit_data_locality: T::Boolean,
+              pii_redaction: Telnyx::AI::PrivacySettings::PiiRedaction::OrSymbol
+            }
           )
         end
         def to_hash
         end
+
+        # Controls redaction of personally identifiable information (PII) from the
+        # conversation history that is stored for this assistant. `disabled` (default)
+        # stores content as-is. `redact` replaces detected PII with `<PII:type/>`
+        # placeholders (e.g. `<PII:name/>`, `<PII:phone/>`) as the stored copies are
+        # written: message content (user, assistant, and tool-result messages) and
+        # tool-call arguments are redacted when written to conversation history, so the
+        # stored transcript, its read-back via the history API, and any insights generated
+        # from the stored messages contain the placeholders instead of the PII; response
+        # bodies returned by webhook tools are redacted too, as stored in the webhook logs
+        # — a per-conversation record separate from the transcript. In the Mission Control
+        # Portal this field appears as a "PII Redaction" on/off toggle, where Enabled
+        # corresponds to `redact`. Redaction runs when the stored copy is written, after
+        # the LLM has generated its reply: the live conversation is not redacted, the
+        # assistant's tools keep receiving the full (unredacted) values during the call,
+        # and the LLM still sees full content in its context window. Call recordings
+        # (including any recording layout configured under telephony settings) and the
+        # payloads of messages/webhooks delivered during the call are never redacted by
+        # this setting. The set of detected PII types (names, street addresses, phone
+        # numbers, email addresses, government identifiers like SSN and driver's license
+        # numbers, credit card and bank account numbers, IP addresses, dates of birth, and
+        # other identifiers unique to a person) is fixed by Telnyx and cannot be
+        # configured or extended per assistant. Assistants with `redact` cannot be used
+        # for SMS/WhatsApp messaging (that combination is rejected with a 400 error);
+        # voice and web chat are unaffected.
+        module PiiRedaction
+          extend Telnyx::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, Telnyx::AI::PrivacySettings::PiiRedaction)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          DISABLED =
+            T.let(
+              :disabled,
+              Telnyx::AI::PrivacySettings::PiiRedaction::TaggedSymbol
+            )
+          REDACT =
+            T.let(
+              :redact,
+              Telnyx::AI::PrivacySettings::PiiRedaction::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[Telnyx::AI::PrivacySettings::PiiRedaction::TaggedSymbol]
+            )
+          end
+          def self.values
+          end
+        end
       end
     end
   end

data/rbi/telnyx/models/ai/telephony_settings.rbi

@@ -126,9 +126,16 @@ module Telnyx
         attr_writer :supports_unauthenticated_web_calls
 
         # Maximum duration in seconds for the AI assistant to participate on the call.
-        # When this limit is reached the assistant will be stopped. This limit does not
-        # apply to portions of a call without an active assistant (for instance, a call
-        # transferred to a human representative).
+        # When this limit is reached the assistant will be stopped. Stopping the assistant
+        # does not itself hang up the call, and what happens next depends on how the
+        # assistant is running. On Call Control (ai_assistant_start) the call leg stays
+        # connected and continues to be billed until it is hung up (for example with the
+        # Hangup call command) or until the call ends for another reason. On TeXML, the
+        # assistant's `<Connect><AIAssistant>` instruction ends; in the default TeXML
+        # setup for assistants no instructions follow it, so the call is hung up. Your
+        # application receives a call.conversation.ended webhook when the assistant stops.
+        # This limit does not apply to portions of a call without an active assistant (for
+        # instance, a call transferred to a human representative).
         sig { returns(T.nilable(Integer)) }
         attr_reader :time_limit_secs
 
@@ -145,9 +152,16 @@ module Telnyx
         attr_writer :user_idle_reply_secs
 
         # Maximum duration in seconds of end user silence on the call. When this limit is
-        # reached the assistant will be stopped. This limit does not apply to portions of
-        # a call without an active assistant (for instance, a call transferred to a human
-        # representative).
+        # reached the assistant will be stopped. Stopping the assistant does not itself
+        # hang up the call, and what happens next depends on how the assistant is running.
+        # On Call Control (ai_assistant_start) the call leg stays connected and continues
+        # to be billed until it is hung up (for example with the Hangup call command) or
+        # until the call ends for another reason. On TeXML, the assistant's
+        # `<Connect><AIAssistant>` instruction ends; in the default TeXML setup for
+        # assistants no instructions follow it, so the call is hung up. Your application
+        # receives a call.conversation.ended webhook when the assistant stops. This limit
+        # does not apply to portions of a call without an active assistant (for instance,
+        # a call transferred to a human representative).
         sig { returns(T.nilable(Integer)) }
         attr_reader :user_idle_timeout_secs
 
@@ -242,18 +256,32 @@ module Telnyx
           # work with assistants that have telephony enabled.
           supports_unauthenticated_web_calls: nil,
           # Maximum duration in seconds for the AI assistant to participate on the call.
-          # When this limit is reached the assistant will be stopped. This limit does not
-          # apply to portions of a call without an active assistant (for instance, a call
-          # transferred to a human representative).
+          # When this limit is reached the assistant will be stopped. Stopping the assistant
+          # does not itself hang up the call, and what happens next depends on how the
+          # assistant is running. On Call Control (ai_assistant_start) the call leg stays
+          # connected and continues to be billed until it is hung up (for example with the
+          # Hangup call command) or until the call ends for another reason. On TeXML, the
+          # assistant's `<Connect><AIAssistant>` instruction ends; in the default TeXML
+          # setup for assistants no instructions follow it, so the call is hung up. Your
+          # application receives a call.conversation.ended webhook when the assistant stops.
+          # This limit does not apply to portions of a call without an active assistant (for
+          # instance, a call transferred to a human representative).
           time_limit_secs: nil,
           # Duration in seconds of end user silence before the assistant checks in on the
           # user. When this limit is reached the assistant will prompt the user to respond.
           # This is distinct from user_idle_timeout_secs which stops the assistant entirely.
           user_idle_reply_secs: nil,
           # Maximum duration in seconds of end user silence on the call. When this limit is
-          # reached the assistant will be stopped. This limit does not apply to portions of
-          # a call without an active assistant (for instance, a call transferred to a human
-          # representative).
+          # reached the assistant will be stopped. Stopping the assistant does not itself
+          # hang up the call, and what happens next depends on how the assistant is running.
+          # On Call Control (ai_assistant_start) the call leg stays connected and continues
+          # to be billed until it is hung up (for example with the Hangup call command) or
+          # until the call ends for another reason. On TeXML, the assistant's
+          # `<Connect><AIAssistant>` instruction ends; in the default TeXML setup for
+          # assistants no instructions follow it, so the call is hung up. Your application
+          # receives a call.conversation.ended webhook when the assistant stops. This limit
+          # does not apply to portions of a call without an active assistant (for instance,
+          # a call transferred to a human representative).
           user_idle_timeout_secs: nil,
           # Configuration for voicemail detection (AMD - Answering Machine Detection) on
           # outgoing calls. These settings only apply if AMD is enabled on the Dial command.

data/rbi/telnyx/models/ai/telnyx_avatar_settings.rbi

@@ -9,10 +9,8 @@ module Telnyx
             T.any(Telnyx::AI::TelnyxAvatarSettings, Telnyx::Internal::AnyHash)
           end
 
-        # The Telnyx avatar to render.
-        sig do
-          returns(Telnyx::AI::TelnyxAvatarSettings::AvatarID::TaggedSymbol)
-        end
+        # The Telnyx stock avatar or organization-owned custom avatar to render.
+        sig { returns(String) }
         attr_accessor :avatar_id
 
         # The background to render.
@@ -30,11 +28,13 @@ module Telnyx
         sig { returns(Symbol) }
         attr_accessor :provider
 
-        # **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.
         sig do
           params(
-            avatar_id: Telnyx::AI::TelnyxAvatarSettings::AvatarID::OrSymbol,
+            avatar_id: String,
             background_id:
               Telnyx::AI::TelnyxAvatarSettings::BackgroundID::OrSymbol,
             model: Telnyx::AI::TelnyxAvatarSettings::Model::OrSymbol,
@@ -42,7 +42,7 @@ module Telnyx
           ).returns(T.attached_class)
         end
         def self.new(
-          # The Telnyx avatar to render.
+          # The Telnyx stock avatar or organization-owned custom avatar to render.
           avatar_id:,
           # The background to render.
           background_id:,
@@ -57,8 +57,7 @@ module Telnyx
         sig do
           override.returns(
             {
-              avatar_id:
-                Telnyx::AI::TelnyxAvatarSettings::AvatarID::TaggedSymbol,
+              avatar_id: String,
               background_id:
                 Telnyx::AI::TelnyxAvatarSettings::BackgroundID::TaggedSymbol,
               model: Telnyx::AI::TelnyxAvatarSettings::Model::TaggedSymbol,
@@ -69,56 +68,6 @@ module Telnyx
         def to_hash
         end
 
-        # The Telnyx avatar to render.
-        module AvatarID
-          extend Telnyx::Internal::Type::Enum
-
-          TaggedSymbol =
-            T.type_alias do
-              T.all(Symbol, Telnyx::AI::TelnyxAvatarSettings::AvatarID)
-            end
-          OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-          ELENA =
-            T.let(
-              :elena,
-              Telnyx::AI::TelnyxAvatarSettings::AvatarID::TaggedSymbol
-            )
-          BEN =
-            T.let(
-              :ben,
-              Telnyx::AI::TelnyxAvatarSettings::AvatarID::TaggedSymbol
-            )
-          JORDAN =
-            T.let(
-              :jordan,
-              Telnyx::AI::TelnyxAvatarSettings::AvatarID::TaggedSymbol
-            )
-          LIN =
-            T.let(
-              :lin,
-              Telnyx::AI::TelnyxAvatarSettings::AvatarID::TaggedSymbol
-            )
-          AVERY =
-            T.let(
-              :avery,
-              Telnyx::AI::TelnyxAvatarSettings::AvatarID::TaggedSymbol
-            )
-          RAPHAEL =
-            T.let(
-              :raphael,
-              Telnyx::AI::TelnyxAvatarSettings::AvatarID::TaggedSymbol
-            )
-
-          sig do
-            override.returns(
-              T::Array[Telnyx::AI::TelnyxAvatarSettings::AvatarID::TaggedSymbol]
-            )
-          end
-          def self.values
-          end
-        end
-
         # The background to render.
         module BackgroundID
           extend Telnyx::Internal::Type::Enum
@@ -144,6 +93,11 @@ module Telnyx
               :reception,
               Telnyx::AI::TelnyxAvatarSettings::BackgroundID::TaggedSymbol
             )
+          ILLUSTRATED_WORKSPACE =
+            T.let(
+              :illustrated_workspace,
+              Telnyx::AI::TelnyxAvatarSettings::BackgroundID::TaggedSymbol
+            )
 
           sig do
             override.returns(