telnyx 5.126.0 → 5.128.0

data/lib/telnyx/models/ai/missions/run_list_params.rb

@@ -27,6 +27,7 @@ module Telnyx
           optional :page_size, Integer
 
           # @!attribute status
+          #   Filter results by status.
           #
           #   @return [String, nil]
           optional :status, String
@@ -38,7 +39,7 @@ module Telnyx
           #
           #   @param page_size [Integer] Number of items per page
           #
-          #   @param status [String]
+          #   @param status [String] Filter results by status.
           #
           #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
         end

data/lib/telnyx/models/ai/missions/run_list_runs_params.rb

@@ -22,6 +22,7 @@ module Telnyx
           optional :page_size, Integer
 
           # @!attribute status
+          #   Filter results by status.
           #
           #   @return [String, nil]
           optional :status, String
@@ -31,7 +32,7 @@ module Telnyx
           #
           #   @param page_size [Integer] Number of items per page
           #
-          #   @param status [String]
+          #   @param status [String] Filter results by status.
           #
           #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
         end

data/lib/telnyx/models/ai/missions/runs/event_list_params.rb

@@ -21,6 +21,7 @@ module Telnyx
             required :run_id, String
 
             # @!attribute agent_id
+            #   Filter results by agent id.
             #
             #   @return [String, nil]
             optional :agent_id, String
@@ -38,11 +39,13 @@ module Telnyx
             optional :page_size, Integer
 
             # @!attribute step_id
+            #   Filter results by step id.
             #
             #   @return [String, nil]
             optional :step_id, String
 
             # @!attribute type
+            #   Filter results by type.
             #
             #   @return [String, nil]
             optional :type, String
@@ -52,15 +55,15 @@ module Telnyx
             #
             #   @param run_id [String]
             #
-            #   @param agent_id [String]
+            #   @param agent_id [String] Filter results by agent id.
             #
             #   @param page_number [Integer] Page number (1-based)
             #
             #   @param page_size [Integer] Number of items per page
             #
-            #   @param step_id [String]
+            #   @param step_id [String] Filter results by step id.
             #
-            #   @param type [String]
+            #   @param type [String] Filter results by type.
             #
             #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
           end

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

@@ -7,8 +7,8 @@ module Telnyx
       class OpenAIListModelsResponse < Telnyx::Internal::Type::BaseModel
         # @!attribute data
         #
-        #   @return [Array<Telnyx::Models::ModelMetadata>]
-        required :data, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::ModelMetadata] }
+        #   @return [Array<Telnyx::Models::AI::OpenAIListModelsResponse::Data>]
+        required :data, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::Models::AI::OpenAIListModelsResponse::Data] }
 
         # @!attribute object
         #
@@ -16,8 +16,215 @@ module Telnyx
         optional :object, String
 
         # @!method initialize(data:, object: nil)
-        #   @param data [Array<Telnyx::Models::ModelMetadata>]
+        #   @param data [Array<Telnyx::Models::AI::OpenAIListModelsResponse::Data>]
         #   @param object [String]
+
+        class Data < Telnyx::Internal::Type::BaseModel
+          # @!attribute id
+          #   Model identifier. For open-source models, follows the
+          #   `{organization}/{model_name}` convention from Hugging Face (e.g.
+          #   `moonshotai/Kimi-K2.6`).
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute context_length
+          #   Maximum total tokens (prompt + completion) supported by the model in a single
+          #   request.
+          #
+          #   @return [Integer]
+          required :context_length, Integer
+
+          # @!attribute created
+          #   Timestamp at which the model was registered on Telnyx Inference (ISO 8601).
+          #
+          #   @return [Time]
+          required :created, Time
+
+          # @!attribute languages
+          #   ISO language codes the model supports (e.g. `en`, `es`).
+          #
+          #   @return [Array<String>]
+          required :languages, Telnyx::Internal::Type::ArrayOf[String]
+
+          # @!attribute license
+          #   License the model is distributed under, e.g. `Apache 2.0`, `MIT`,
+          #   `Llama 3 Community License`.
+          #
+          #   @return [String]
+          required :license, String
+
+          # @!attribute organization
+          #   Organization that originally published the model, matching the prefix of `id`
+          #   for open-source models.
+          #
+          #   @return [String]
+          required :organization, String
+
+          # @!attribute owned_by
+          #   Owner of the model. `Telnyx` for Telnyx-hosted open-source models, the upstream
+          #   provider name for proxied models, or the Telnyx organization id for fine-tuned
+          #   models.
+          #
+          #   @return [String]
+          required :owned_by, String
+
+          # @!attribute parameters
+          #   Total parameter count of the model.
+          #
+          #   @return [Integer]
+          required :parameters, Integer
+
+          # @!attribute tier
+          #   Billing tier the model belongs to. Used together with `pricing` to determine
+          #   cost per 1M tokens.
+          #
+          #   @return [Symbol, Telnyx::Models::AI::OpenAIListModelsResponse::Data::Tier]
+          required :tier, enum: -> { Telnyx::Models::AI::OpenAIListModelsResponse::Data::Tier }
+
+          # @!attribute base_model
+          #   Base model the fine-tuned model was trained from. Only set for fine-tuned
+          #   models.
+          #
+          #   @return [String, nil]
+          optional :base_model, String, nil?: true
+
+          # @!attribute description
+          #   Short, human-readable summary of what the model is best suited for.
+          #
+          #   @return [String, nil]
+          optional :description, String, nil?: true
+
+          # @!attribute is_fine_tunable
+          #   Whether the model can be used as a base for a fine-tuning job via
+          #   `POST /v2/ai/fine_tuning/jobs`.
+          #
+          #   @return [Boolean, nil]
+          optional :is_fine_tunable, Telnyx::Internal::Type::Boolean
+
+          # @!attribute is_vision_supported
+          #   Whether the model accepts image inputs in chat completions (multimodal vision
+          #   support).
+          #
+          #   @return [Boolean, nil]
+          optional :is_vision_supported, Telnyx::Internal::Type::Boolean
+
+          # @!attribute max_completion_tokens
+          #   Maximum number of completion (output) tokens the model will generate per
+          #   request. `null` if unconstrained beyond `context_length`.
+          #
+          #   @return [Integer, nil]
+          optional :max_completion_tokens, Integer, nil?: true
+
+          # @!attribute object
+          #   Object type. Always `model`.
+          #
+          #   @return [String, nil]
+          optional :object, String
+
+          # @!attribute parameters_str
+          #   Human-readable parameter count, e.g. `1.0T`, `753.9B`, `8B`.
+          #
+          #   @return [String, nil]
+          optional :parameters_str, String, nil?: true
+
+          # @!attribute pricing
+          #   Mapping of token kind to price, as strings to preserve precision. Typical keys
+          #   are `prompt`, `cached_prompt`, and `completion`. When pricing is available the
+          #   block also includes `currency` (ISO 4217 code matching the account's configured
+          #   billing currency) and `unit` (the denomination the prices are quoted in,
+          #   currently always `1M_tokens` for token-priced models).
+          #
+          #   @return [Hash{Symbol=>String}, nil]
+          optional :pricing, Telnyx::Internal::Type::HashOf[String]
+
+          # @!attribute recommended_for_assistants
+          #   Whether Telnyx currently recommends this model as the LLM powering a Telnyx AI
+          #   Assistant.
+          #
+          #   @return [Boolean, nil]
+          optional :recommended_for_assistants, Telnyx::Internal::Type::Boolean
+
+          # @!attribute regions
+          #   Public region names where the model is currently deployed (e.g. `us-central-1`,
+          #   `eu-central-1`).
+          #
+          #   @return [Array<String>, nil]
+          optional :regions, Telnyx::Internal::Type::ArrayOf[String]
+
+          # @!attribute task
+          #   Primary task the model is intended for, e.g. `text-generation`,
+          #   `audio-text-to-text`, `feature-extraction` (embeddings).
+          #
+          #   @return [String, nil]
+          optional :task, String
+
+          # @!method initialize(id:, context_length:, created:, languages:, license:, organization:, owned_by:, parameters:, tier:, base_model: nil, description: nil, is_fine_tunable: nil, is_vision_supported: nil, max_completion_tokens: nil, object: nil, parameters_str: nil, pricing: nil, recommended_for_assistants: nil, regions: nil, task: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::AI::OpenAIListModelsResponse::Data} for more details.
+          #
+          #   Metadata for a model available on Telnyx Inference. Returned by
+          #   `GET /v2/ai/openai/models` (and the deprecated `GET /v2/ai/models`). Open-source
+          #   models live under their Hugging Face organization (e.g. `moonshotai/Kimi-K2.6`,
+          #   `zai-org/GLM-5.1-FP8`, `MiniMaxAI/MiniMax-M2.7`); fine-tuned models are owned by
+          #   the Telnyx organization that trained them.
+          #
+          #   @param id [String] Model identifier. For open-source models, follows the `{organization}/{model_nam
+          #
+          #   @param context_length [Integer] Maximum total tokens (prompt + completion) supported by the model in a single re
+          #
+          #   @param created [Time] Timestamp at which the model was registered on Telnyx Inference (ISO 8601).
+          #
+          #   @param languages [Array<String>] ISO language codes the model supports (e.g. `en`, `es`).
+          #
+          #   @param license [String] License the model is distributed under, e.g. `Apache 2.0`, `MIT`, `Llama 3 Commu
+          #
+          #   @param organization [String] Organization that originally published the model, matching the prefix of `id` fo
+          #
+          #   @param owned_by [String] Owner of the model. `Telnyx` for Telnyx-hosted open-source models, the upstream
+          #
+          #   @param parameters [Integer] Total parameter count of the model.
+          #
+          #   @param tier [Symbol, Telnyx::Models::AI::OpenAIListModelsResponse::Data::Tier] Billing tier the model belongs to. Used together with `pricing` to determine cos
+          #
+          #   @param base_model [String, nil] Base model the fine-tuned model was trained from. Only set for fine-tuned models
+          #
+          #   @param description [String, nil] Short, human-readable summary of what the model is best suited for.
+          #
+          #   @param is_fine_tunable [Boolean] Whether the model can be used as a base for a fine-tuning job via `POST /v2/ai/f
+          #
+          #   @param is_vision_supported [Boolean] Whether the model accepts image inputs in chat completions (multimodal vision su
+          #
+          #   @param max_completion_tokens [Integer, nil] Maximum number of completion (output) tokens the model will generate per request
+          #
+          #   @param object [String] Object type. Always `model`.
+          #
+          #   @param parameters_str [String, nil] Human-readable parameter count, e.g. `1.0T`, `753.9B`, `8B`.
+          #
+          #   @param pricing [Hash{Symbol=>String}] Mapping of token kind to price, as strings to preserve precision. Typical keys a
+          #
+          #   @param recommended_for_assistants [Boolean] Whether Telnyx currently recommends this model as the LLM powering a Telnyx AI A
+          #
+          #   @param regions [Array<String>] Public region names where the model is currently deployed (e.g. `us-central-1`,
+          #
+          #   @param task [String] Primary task the model is intended for, e.g. `text-generation`, `audio-text-to-t
+
+          # Billing tier the model belongs to. Used together with `pricing` to determine
+          # cost per 1M tokens.
+          #
+          # @see Telnyx::Models::AI::OpenAIListModelsResponse::Data#tier
+          module Tier
+            extend Telnyx::Internal::Type::Enum
+
+            SMALL = :small
+            MEDIUM = :medium
+            LARGE = :large
+            UNLISTED = :unlisted
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
       end
     end
   end

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

@@ -9,30 +9,38 @@ module Telnyx
         include Telnyx::Internal::Type::RequestParameters
 
         # @!attribute filter_name
+        #   Filter results by filter name.
         #
         #   @return [String, nil]
         optional :filter_name, String
 
         # @!attribute filter_type
+        #   Filter results by filter type.
         #
         #   @return [String, nil]
         optional :filter_type, String
 
         # @!attribute page_number
+        #   Page number to retrieve (1-based).
         #
         #   @return [Integer, nil]
         optional :page_number, Integer
 
         # @!attribute page_size
+        #   Number of items to return per page.
         #
         #   @return [Integer, nil]
         optional :page_size, Integer
 
         # @!method initialize(filter_name: nil, filter_type: nil, page_number: nil, page_size: nil, request_options: {})
-        #   @param filter_name [String]
-        #   @param filter_type [String]
-        #   @param page_number [Integer]
-        #   @param page_size [Integer]
+        #   @param filter_name [String] Filter results by filter name.
+        #
+        #   @param filter_type [String] Filter results by filter type.
+        #
+        #   @param page_number [Integer] Page number to retrieve (1-based).
+        #
+        #   @param page_size [Integer] Number of items to return per page.
+        #
         #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
       end
     end

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

@@ -32,7 +32,7 @@ module Telnyx
           #   variable string like `{{ targets }}` where `targets` is returned by the dynamic
           #   variables webhook and resolves to an array of target objects at runtime.
           #
-          #   @return [Array<Telnyx::Models::AI::TransferTool::Transfer::Targets::TargetsList>, String]
+          #   @return [Array<Telnyx::Models::AI::TransferTool::Transfer::Targets::UnionMember0>, String]
           required :targets, union: -> { Telnyx::AI::TransferTool::Transfer::Targets }
 
           # @!method initialize(from:, targets:)
@@ -41,7 +41,7 @@ module Telnyx
           #
           #   @param from [String] Number or SIP URI placing the call.
           #
-          #   @param targets [Array<Telnyx::Models::AI::TransferTool::Transfer::Targets::TargetsList>, String] The different possible targets of the transfer. The assistant will be able to ch
+          #   @param targets [Array<Telnyx::Models::AI::TransferTool::Transfer::Targets::UnionMember0>, String] The different possible targets of the transfer. The assistant will be able to ch
 
           # The different possible targets of the transfer. The assistant will be able to
           # choose one of the targets to transfer the call to. This can also be a dynamic
@@ -52,12 +52,12 @@ module Telnyx
           module Targets
             extend Telnyx::Internal::Type::Union
 
-            variant -> { Telnyx::Models::AI::TransferTool::Transfer::Targets::TargetsListArray }
+            variant -> { Telnyx::Models::AI::TransferTool::Transfer::Targets::UnionMember0Array }
 
             # A dynamic variable string like `{{ targets }}` where `targets` is returned by the dynamic variables webhook and resolves to an array of target objects at runtime.
             variant String
 
-            class TargetsList < Telnyx::Internal::Type::BaseModel
+            class UnionMember0 < Telnyx::Internal::Type::BaseModel
               # @!attribute to
               #   The destination number or SIP URI of the call.
               #
@@ -77,11 +77,13 @@ module Telnyx
             end
 
             # @!method self.variants
-            #   @return [Array(Array<Telnyx::Models::AI::TransferTool::Transfer::Targets::TargetsList>, String)]
+            #   @return [Array(Array<Telnyx::Models::AI::TransferTool::Transfer::Targets::UnionMember0>, String)]
 
             # @type [Telnyx::Internal::Type::Converter]
-            TargetsListArray =
-              Telnyx::Internal::Type::ArrayOf[-> { Telnyx::AI::TransferTool::Transfer::Targets::TargetsList }]
+            UnionMember0Array =
+              Telnyx::Internal::Type::ArrayOf[-> {
+                Telnyx::AI::TransferTool::Transfer::Targets::UnionMember0
+              }]
           end
         end
 

data/lib/telnyx/models/ai_retrieve_models_response.rb

@@ -6,8 +6,8 @@ module Telnyx
     class AIRetrieveModelsResponse < Telnyx::Internal::Type::BaseModel
       # @!attribute data
       #
-      #   @return [Array<Telnyx::Models::ModelMetadata>]
-      required :data, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::ModelMetadata] }
+      #   @return [Array<Telnyx::Models::AIRetrieveModelsResponse::Data>]
+      required :data, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::Models::AIRetrieveModelsResponse::Data] }
 
       # @!attribute object
       #
@@ -15,8 +15,215 @@ module Telnyx
       optional :object, String
 
       # @!method initialize(data:, object: nil)
-      #   @param data [Array<Telnyx::Models::ModelMetadata>]
+      #   @param data [Array<Telnyx::Models::AIRetrieveModelsResponse::Data>]
       #   @param object [String]
+
+      class Data < Telnyx::Internal::Type::BaseModel
+        # @!attribute id
+        #   Model identifier. For open-source models, follows the
+        #   `{organization}/{model_name}` convention from Hugging Face (e.g.
+        #   `moonshotai/Kimi-K2.6`).
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute context_length
+        #   Maximum total tokens (prompt + completion) supported by the model in a single
+        #   request.
+        #
+        #   @return [Integer]
+        required :context_length, Integer
+
+        # @!attribute created
+        #   Timestamp at which the model was registered on Telnyx Inference (ISO 8601).
+        #
+        #   @return [Time]
+        required :created, Time
+
+        # @!attribute languages
+        #   ISO language codes the model supports (e.g. `en`, `es`).
+        #
+        #   @return [Array<String>]
+        required :languages, Telnyx::Internal::Type::ArrayOf[String]
+
+        # @!attribute license
+        #   License the model is distributed under, e.g. `Apache 2.0`, `MIT`,
+        #   `Llama 3 Community License`.
+        #
+        #   @return [String]
+        required :license, String
+
+        # @!attribute organization
+        #   Organization that originally published the model, matching the prefix of `id`
+        #   for open-source models.
+        #
+        #   @return [String]
+        required :organization, String
+
+        # @!attribute owned_by
+        #   Owner of the model. `Telnyx` for Telnyx-hosted open-source models, the upstream
+        #   provider name for proxied models, or the Telnyx organization id for fine-tuned
+        #   models.
+        #
+        #   @return [String]
+        required :owned_by, String
+
+        # @!attribute parameters
+        #   Total parameter count of the model.
+        #
+        #   @return [Integer]
+        required :parameters, Integer
+
+        # @!attribute tier
+        #   Billing tier the model belongs to. Used together with `pricing` to determine
+        #   cost per 1M tokens.
+        #
+        #   @return [Symbol, Telnyx::Models::AIRetrieveModelsResponse::Data::Tier]
+        required :tier, enum: -> { Telnyx::Models::AIRetrieveModelsResponse::Data::Tier }
+
+        # @!attribute base_model
+        #   Base model the fine-tuned model was trained from. Only set for fine-tuned
+        #   models.
+        #
+        #   @return [String, nil]
+        optional :base_model, String, nil?: true
+
+        # @!attribute description
+        #   Short, human-readable summary of what the model is best suited for.
+        #
+        #   @return [String, nil]
+        optional :description, String, nil?: true
+
+        # @!attribute is_fine_tunable
+        #   Whether the model can be used as a base for a fine-tuning job via
+        #   `POST /v2/ai/fine_tuning/jobs`.
+        #
+        #   @return [Boolean, nil]
+        optional :is_fine_tunable, Telnyx::Internal::Type::Boolean
+
+        # @!attribute is_vision_supported
+        #   Whether the model accepts image inputs in chat completions (multimodal vision
+        #   support).
+        #
+        #   @return [Boolean, nil]
+        optional :is_vision_supported, Telnyx::Internal::Type::Boolean
+
+        # @!attribute max_completion_tokens
+        #   Maximum number of completion (output) tokens the model will generate per
+        #   request. `null` if unconstrained beyond `context_length`.
+        #
+        #   @return [Integer, nil]
+        optional :max_completion_tokens, Integer, nil?: true
+
+        # @!attribute object
+        #   Object type. Always `model`.
+        #
+        #   @return [String, nil]
+        optional :object, String
+
+        # @!attribute parameters_str
+        #   Human-readable parameter count, e.g. `1.0T`, `753.9B`, `8B`.
+        #
+        #   @return [String, nil]
+        optional :parameters_str, String, nil?: true
+
+        # @!attribute pricing
+        #   Mapping of token kind to price, as strings to preserve precision. Typical keys
+        #   are `prompt`, `cached_prompt`, and `completion`. When pricing is available the
+        #   block also includes `currency` (ISO 4217 code matching the account's configured
+        #   billing currency) and `unit` (the denomination the prices are quoted in,
+        #   currently always `1M_tokens` for token-priced models).
+        #
+        #   @return [Hash{Symbol=>String}, nil]
+        optional :pricing, Telnyx::Internal::Type::HashOf[String]
+
+        # @!attribute recommended_for_assistants
+        #   Whether Telnyx currently recommends this model as the LLM powering a Telnyx AI
+        #   Assistant.
+        #
+        #   @return [Boolean, nil]
+        optional :recommended_for_assistants, Telnyx::Internal::Type::Boolean
+
+        # @!attribute regions
+        #   Public region names where the model is currently deployed (e.g. `us-central-1`,
+        #   `eu-central-1`).
+        #
+        #   @return [Array<String>, nil]
+        optional :regions, Telnyx::Internal::Type::ArrayOf[String]
+
+        # @!attribute task
+        #   Primary task the model is intended for, e.g. `text-generation`,
+        #   `audio-text-to-text`, `feature-extraction` (embeddings).
+        #
+        #   @return [String, nil]
+        optional :task, String
+
+        # @!method initialize(id:, context_length:, created:, languages:, license:, organization:, owned_by:, parameters:, tier:, base_model: nil, description: nil, is_fine_tunable: nil, is_vision_supported: nil, max_completion_tokens: nil, object: nil, parameters_str: nil, pricing: nil, recommended_for_assistants: nil, regions: nil, task: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::AIRetrieveModelsResponse::Data} for more details.
+        #
+        #   Metadata for a model available on Telnyx Inference. Returned by
+        #   `GET /v2/ai/openai/models` (and the deprecated `GET /v2/ai/models`). Open-source
+        #   models live under their Hugging Face organization (e.g. `moonshotai/Kimi-K2.6`,
+        #   `zai-org/GLM-5.1-FP8`, `MiniMaxAI/MiniMax-M2.7`); fine-tuned models are owned by
+        #   the Telnyx organization that trained them.
+        #
+        #   @param id [String] Model identifier. For open-source models, follows the `{organization}/{model_nam
+        #
+        #   @param context_length [Integer] Maximum total tokens (prompt + completion) supported by the model in a single re
+        #
+        #   @param created [Time] Timestamp at which the model was registered on Telnyx Inference (ISO 8601).
+        #
+        #   @param languages [Array<String>] ISO language codes the model supports (e.g. `en`, `es`).
+        #
+        #   @param license [String] License the model is distributed under, e.g. `Apache 2.0`, `MIT`, `Llama 3 Commu
+        #
+        #   @param organization [String] Organization that originally published the model, matching the prefix of `id` fo
+        #
+        #   @param owned_by [String] Owner of the model. `Telnyx` for Telnyx-hosted open-source models, the upstream
+        #
+        #   @param parameters [Integer] Total parameter count of the model.
+        #
+        #   @param tier [Symbol, Telnyx::Models::AIRetrieveModelsResponse::Data::Tier] Billing tier the model belongs to. Used together with `pricing` to determine cos
+        #
+        #   @param base_model [String, nil] Base model the fine-tuned model was trained from. Only set for fine-tuned models
+        #
+        #   @param description [String, nil] Short, human-readable summary of what the model is best suited for.
+        #
+        #   @param is_fine_tunable [Boolean] Whether the model can be used as a base for a fine-tuning job via `POST /v2/ai/f
+        #
+        #   @param is_vision_supported [Boolean] Whether the model accepts image inputs in chat completions (multimodal vision su
+        #
+        #   @param max_completion_tokens [Integer, nil] Maximum number of completion (output) tokens the model will generate per request
+        #
+        #   @param object [String] Object type. Always `model`.
+        #
+        #   @param parameters_str [String, nil] Human-readable parameter count, e.g. `1.0T`, `753.9B`, `8B`.
+        #
+        #   @param pricing [Hash{Symbol=>String}] Mapping of token kind to price, as strings to preserve precision. Typical keys a
+        #
+        #   @param recommended_for_assistants [Boolean] Whether Telnyx currently recommends this model as the LLM powering a Telnyx AI A
+        #
+        #   @param regions [Array<String>] Public region names where the model is currently deployed (e.g. `us-central-1`,
+        #
+        #   @param task [String] Primary task the model is intended for, e.g. `text-generation`, `audio-text-to-t
+
+        # Billing tier the model belongs to. Used together with `pricing` to determine
+        # cost per 1M tokens.
+        #
+        # @see Telnyx::Models::AIRetrieveModelsResponse::Data#tier
+        module Tier
+          extend Telnyx::Internal::Type::Enum
+
+          SMALL = :small
+          MEDIUM = :medium
+          LARGE = :large
+          UNLISTED = :unlisted
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
     end
   end
 end