telnyx 5.166.0 → 5.168.0

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

@@ -48,25 +48,6 @@ module Telnyx
         #   @return [Float, nil]
         optional :frequency_penalty, Float
 
-        # @!attribute guided_choice
-        #   If specified, the output will be exactly one of the choices.
-        #
-        #   @return [Array<String>, nil]
-        optional :guided_choice, Telnyx::Internal::Type::ArrayOf[String]
-
-        # @!attribute guided_json
-        #   Must be a valid JSON schema. If specified, the output will follow the JSON
-        #   schema.
-        #
-        #   @return [Hash{Symbol=>Object}, nil]
-        optional :guided_json, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
-
-        # @!attribute guided_regex
-        #   If specified, the output will follow the regex pattern.
-        #
-        #   @return [String, nil]
-        optional :guided_regex, String
-
         # @!attribute length_penalty
         #   This is used with `use_beam_search` to prefer shorter or longer completions.
         #
@@ -95,6 +76,16 @@ module Telnyx
         #   @return [Float, nil]
         optional :min_p, Float
 
+        # @!attribute mode
+        #   How strictly `region` is applied. `preferred` (the default when `region` is set)
+        #   tries that region first and falls back to another when the model cannot be
+        #   served there, so a request that would have succeeded still succeeds. `strict`
+        #   pins the request: it is served from that region or it fails with a 422, never
+        #   redirected to another region. Requires `region`.
+        #
+        #   @return [Symbol, Telnyx::Models::AI::ChatCompletionRequest::Mode, nil]
+        optional :mode, enum: -> { Telnyx::AI::ChatCompletionRequest::Mode }
+
         # @!attribute model
         #   The language model to chat with.
         #
@@ -123,12 +114,24 @@ module Telnyx
         #   @return [Symbol, Telnyx::Models::AI::ChatCompletionRequest::ReasoningEffort, nil]
         optional :reasoning_effort, enum: -> { Telnyx::AI::ChatCompletionRequest::ReasoningEffort }
 
+        # @!attribute region
+        #   Optional data-residency region the request should be served from, using the same
+        #   vocabulary as your account's Data Locality setting. Behavior depends on `mode`.
+        #   Supported for Telnyx-hosted models only: a request routed to an external
+        #   provider never passes through Telnyx model routing, so a region cannot be
+        #   enforced for it. Omit for today's latency-based routing.
+        #
+        #   @return [Symbol, Telnyx::Models::AI::ChatCompletionRequest::Region, nil]
+        optional :region, enum: -> { Telnyx::AI::ChatCompletionRequest::Region }
+
         # @!attribute response_format
-        #   Use this is you want to guarantee a JSON output without defining a schema. For
-        #   control over the schema, use `guided_json`.
+        #   Controls the format of the model output. `json_object` guarantees valid JSON
+        #   output without defining a schema; `json_schema` constrains the output to the
+        #   JSON schema you supply via the `json_schema` property and is the supported way
+        #   to get guaranteed structured output on Telnyx-hosted models.
         #
-        #   @return [Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat, nil]
-        optional :response_format, -> { Telnyx::AI::ChatCompletionRequest::ResponseFormat }
+        #   @return [Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatText, Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatJsonObject, Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatJsonSchemaParam, nil]
+        optional :response_format, union: -> { Telnyx::AI::ChatCompletionRequest::ResponseFormat }
 
         # @!attribute seed
         #   If specified, the system will make a best effort to sample deterministically,
@@ -205,7 +208,7 @@ module Telnyx
         #   @return [Boolean, nil]
         optional :use_beam_search, Telnyx::Internal::Type::Boolean
 
-        # @!method initialize(messages:, api_key_ref: nil, best_of: nil, early_stopping: nil, enable_thinking: nil, frequency_penalty: nil, guided_choice: nil, guided_json: nil, guided_regex: nil, length_penalty: nil, logprobs: nil, max_tokens: nil, min_p: nil, model: nil, n: nil, presence_penalty: nil, reasoning_effort: nil, response_format: nil, seed: nil, service_tier: nil, stop: nil, stream: nil, temperature: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, use_beam_search: nil)
+        # @!method initialize(messages:, api_key_ref: nil, best_of: nil, early_stopping: nil, enable_thinking: nil, frequency_penalty: nil, length_penalty: nil, logprobs: nil, max_tokens: nil, min_p: nil, mode: nil, model: nil, n: nil, presence_penalty: nil, reasoning_effort: nil, region: nil, response_format: nil, seed: nil, service_tier: nil, stop: nil, stream: nil, temperature: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, use_beam_search: nil)
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::ChatCompletionRequest} for more details.
         #
@@ -221,12 +224,6 @@ module Telnyx
         #
         #   @param frequency_penalty [Float] Higher values will penalize the model from repeating the same output tokens.
         #
-        #   @param guided_choice [Array<String>] If specified, the output will be exactly one of the choices.
-        #
-        #   @param guided_json [Hash{Symbol=>Object}] Must be a valid JSON schema. If specified, the output will follow the JSON schem
-        #
-        #   @param guided_regex [String] If specified, the output will follow the regex pattern.
-        #
         #   @param length_penalty [Float] This is used with `use_beam_search` to prefer shorter or longer completions.
         #
         #   @param logprobs [Boolean] Whether to return log probabilities of the output tokens or not. If true, return
@@ -235,6 +232,8 @@ module Telnyx
         #
         #   @param min_p [Float] This is an alternative to `top_p` that [many prefer](https://github.com/huggingf
         #
+        #   @param mode [Symbol, Telnyx::Models::AI::ChatCompletionRequest::Mode] How strictly `region` is applied. `preferred` (the default when `region` is set)
+        #
         #   @param model [String] The language model to chat with.
         #
         #   @param n [Float] This will return multiple choices for you instead of a single chat completion.
@@ -243,7 +242,9 @@ module Telnyx
         #
         #   @param reasoning_effort [Symbol, Telnyx::Models::AI::ChatCompletionRequest::ReasoningEffort] Controls the reasoning effort for models that support it. When set, the model sp
         #
-        #   @param response_format [Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat] Use this is you want to guarantee a JSON output without defining a schema. For c
+        #   @param region [Symbol, Telnyx::Models::AI::ChatCompletionRequest::Region] Optional data-residency region the request should be served from, using the same
+        #
+        #   @param response_format [Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatText, Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatJsonObject, Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatJsonSchemaParam] Controls the format of the model output. `json_object` guarantees valid JSON out
         #
         #   @param seed [Integer] If specified, the system will make a best effort to sample deterministically, su
         #
@@ -345,6 +346,23 @@ module Telnyx
           end
         end
 
+        # How strictly `region` is applied. `preferred` (the default when `region` is set)
+        # tries that region first and falls back to another when the model cannot be
+        # served there, so a request that would have succeeded still succeeds. `strict`
+        # pins the request: it is served from that region or it fails with a 422, never
+        # redirected to another region. Requires `region`.
+        #
+        # @see Telnyx::Models::AI::ChatCompletionRequest#mode
+        module Mode
+          extend Telnyx::Internal::Type::Enum
+
+          PREFERRED = :preferred
+          STRICT = :strict
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
         # Controls the reasoning effort for models that support it. When set, the model
         # spends more or less compute on internal reasoning before generating its
         # response. Supported values: none, minimal, low, medium, high, xhigh, max. Not
@@ -367,29 +385,148 @@ module Telnyx
           #   @return [Array<Symbol>]
         end
 
+        # Optional data-residency region the request should be served from, using the same
+        # vocabulary as your account's Data Locality setting. Behavior depends on `mode`.
+        # Supported for Telnyx-hosted models only: a request routed to an external
+        # provider never passes through Telnyx model routing, so a region cannot be
+        # enforced for it. Omit for today's latency-based routing.
+        #
+        # @see Telnyx::Models::AI::ChatCompletionRequest#region
+        module Region
+          extend Telnyx::Internal::Type::Enum
+
+          USA = :USA
+          EU = :EU
+          AUS = :AUS
+          UAE = :UAE
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # Controls the format of the model output. `json_object` guarantees valid JSON
+        # output without defining a schema; `json_schema` constrains the output to the
+        # JSON schema you supply via the `json_schema` property and is the supported way
+        # to get guaranteed structured output on Telnyx-hosted models.
+        #
         # @see Telnyx::Models::AI::ChatCompletionRequest#response_format
-        class ResponseFormat < Telnyx::Internal::Type::BaseModel
-          # @!attribute type
-          #
-          #   @return [Symbol, Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat::Type]
-          required :type, enum: -> { Telnyx::AI::ChatCompletionRequest::ResponseFormat::Type }
+        module ResponseFormat
+          extend Telnyx::Internal::Type::Union
 
-          # @!method initialize(type:)
-          #   Use this is you want to guarantee a JSON output without defining a schema. For
-          #   control over the schema, use `guided_json`.
-          #
-          #   @param type [Symbol, Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat::Type]
+          # Plain text output.
+          variant -> { Telnyx::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatText }
 
-          # @see Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat#type
-          module Type
-            extend Telnyx::Internal::Type::Enum
+          # JSON mode: the model output is valid JSON, without a schema.
+          variant -> { Telnyx::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatJsonObject }
 
-            TEXT = :text
-            JSON_OBJECT = :json_object
+          # Structured output: the model output is constrained to the JSON schema supplied in `json_schema`.
+          variant -> { Telnyx::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatJsonSchemaParam }
 
-            # @!method self.values
-            #   @return [Array<Symbol>]
+          class ResponseFormatText < Telnyx::Internal::Type::BaseModel
+            # @!attribute type
+            #
+            #   @return [Symbol, :text]
+            required :type, const: :text
+
+            # @!method initialize(type: :text)
+            #   Plain text output.
+            #
+            #   @param type [Symbol, :text]
           end
+
+          class ResponseFormatJsonObject < Telnyx::Internal::Type::BaseModel
+            # @!attribute type
+            #
+            #   @return [Symbol, :json_object]
+            required :type, const: :json_object
+
+            # @!method initialize(type: :json_object)
+            #   JSON mode: the model output is valid JSON, without a schema.
+            #
+            #   @param type [Symbol, :json_object]
+          end
+
+          class ResponseFormatJsonSchemaParam < Telnyx::Internal::Type::BaseModel
+            # @!attribute json_schema
+            #   The JSON schema configuration, required when `type` is `json_schema`. Matches
+            #   the
+            #   [OpenAI structured outputs](https://platform.openai.com/docs/guides/structured-outputs)
+            #   `json_schema` response format.
+            #
+            #   @return [Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatJsonSchemaParam::JsonSchema]
+            required :json_schema,
+                     -> { Telnyx::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatJsonSchemaParam::JsonSchema }
+
+            # @!attribute type
+            #
+            #   @return [Symbol, :json_schema]
+            required :type, const: :json_schema
+
+            # @!method initialize(json_schema:, type: :json_schema)
+            #   Some parameter documentations has been truncated, see
+            #   {Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatJsonSchemaParam}
+            #   for more details.
+            #
+            #   Structured output: the model output is constrained to the JSON schema supplied
+            #   in `json_schema`.
+            #
+            #   @param json_schema [Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatJsonSchemaParam::JsonSchema] The JSON schema configuration, required when `type` is `json_schema`. Matches th
+            #
+            #   @param type [Symbol, :json_schema]
+
+            # @see Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatJsonSchemaParam#json_schema
+            class JsonSchema < Telnyx::Internal::Type::BaseModel
+              # @!attribute name
+              #   The name of the response format. Used for clarity only.
+              #
+              #   @return [String]
+              required :name, String
+
+              # @!attribute description
+              #   A description of what the response format is for, typically used to guide the
+              #   model.
+              #
+              #   @return [String, nil]
+              optional :description, String
+
+              # @!attribute schema
+              #   The JSON schema the model output must conform to. A valid
+              #   [JSON Schema](https://json-schema.org) object, e.g. a Pydantic
+              #   `model_json_schema()` export.
+              #
+              #   @return [Hash{Symbol=>Object}, nil]
+              optional :schema, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+              # @!attribute strict
+              #   Enables strict schema adherence when supported by the model. If the generated
+              #   output does not match the provided schema, the request fails instead of
+              #   returning non-conformant output.
+              #
+              #   @return [Boolean, nil]
+              optional :strict, Telnyx::Internal::Type::Boolean
+
+              # @!method initialize(name:, description: nil, schema: nil, strict: nil)
+              #   Some parameter documentations has been truncated, see
+              #   {Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatJsonSchemaParam::JsonSchema}
+              #   for more details.
+              #
+              #   The JSON schema configuration, required when `type` is `json_schema`. Matches
+              #   the
+              #   [OpenAI structured outputs](https://platform.openai.com/docs/guides/structured-outputs)
+              #   `json_schema` response format.
+              #
+              #   @param name [String] The name of the response format. Used for clarity only.
+              #
+              #   @param description [String] A description of what the response format is for, typically used to guide the mo
+              #
+              #   @param schema [Hash{Symbol=>Object}] The JSON schema the model output must conform to. A valid [JSON Schema](https://
+              #
+              #   @param strict [Boolean] Enables strict schema adherence when supported by the model. If the generated ou
+            end
+          end
+
+          # @!method self.variants
+          #   @return [Array(Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatText, Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatJsonObject, Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatJsonSchemaParam)]
         end
 
         # Up to 4 sequences where the API will stop generating further tokens. The

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

@@ -37,6 +37,19 @@ module Telnyx
         #   @return [String]
         required :name, String
 
+        # @!attribute a2a_agents
+        #   A2A agents this assistant can delegate to. Tools are not stored here: at the
+        #   start of every conversation each agent's card is fetched and one tool is derived
+        #   per skill the card advertises, named `a2a_<name>_<skill_id>`. The following
+        #   limits are not enforced when the assistant is saved, and anything past them is
+        #   dropped when the conversation starts: 64 agents per assistant, 64 skills per
+        #   card, 128 derived tools per assistant, and a 6 second budget for all card
+        #   fetches combined. An agent whose card cannot be fetched costs the assistant that
+        #   capability for the conversation; it does not fail the call.
+        #
+        #   @return [Array<Telnyx::Models::AI::AssistantA2AAgent>, nil]
+        optional :a2a_agents, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::AI::AssistantA2AAgent] }
+
         # @!attribute conversation_flow
         #   Conversation flow as returned by the API.
         #
@@ -237,7 +250,7 @@ module Telnyx
         #   @return [Telnyx::Models::AI::WidgetSettings, nil]
         optional :widget_settings, -> { Telnyx::AI::WidgetSettings }
 
-        # @!method initialize(id:, created_at:, instructions:, model:, name:, conversation_flow: nil, description: nil, dynamic_variables: nil, dynamic_variables_webhook_timeout_ms: nil, dynamic_variables_webhook_url: nil, enabled_features: nil, external_llm: nil, fallback_config: nil, greeting: nil, import_metadata: nil, insight_settings: nil, integrations: nil, interruption_settings: nil, llm_api_key_ref: nil, mcp_servers: nil, messaging_settings: nil, observability_settings: nil, post_conversation_settings: nil, privacy_settings: nil, related_mission_ids: nil, tags: nil, telephony_settings: nil, tools: nil, transcription: nil, version_created_at: nil, version_id: nil, version_name: nil, voice_settings: nil, widget_settings: nil)
+        # @!method initialize(id:, created_at:, instructions:, model:, name:, a2a_agents: nil, conversation_flow: nil, description: nil, dynamic_variables: nil, dynamic_variables_webhook_timeout_ms: nil, dynamic_variables_webhook_url: nil, enabled_features: nil, external_llm: nil, fallback_config: nil, greeting: nil, import_metadata: nil, insight_settings: nil, integrations: nil, interruption_settings: nil, llm_api_key_ref: nil, mcp_servers: nil, messaging_settings: nil, observability_settings: nil, post_conversation_settings: nil, privacy_settings: nil, related_mission_ids: nil, tags: nil, telephony_settings: nil, tools: nil, transcription: nil, version_created_at: nil, version_id: nil, version_name: nil, voice_settings: nil, widget_settings: nil)
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::InferenceEmbedding} for more details.
         #
@@ -251,6 +264,8 @@ module Telnyx
         #
         #   @param name [String]
         #
+        #   @param a2a_agents [Array<Telnyx::Models::AI::AssistantA2AAgent>] A2A agents this assistant can delegate to. Tools are not stored here: at the sta
+        #
         #   @param conversation_flow [Telnyx::Models::AI::ConversationFlow] Conversation flow as returned by the API.
         #
         #   @param description [String]

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

@@ -31,6 +31,16 @@ module Telnyx
         #   @return [String, nil]
         optional :instructions, String
 
+        # @!attribute mode
+        #   How strictly `region` is applied. `preferred` (the default when `region` is set)
+        #   tries that region first and falls back to another when the model cannot be
+        #   served there, so a request that would have succeeded still succeeds. `strict`
+        #   pins the request: it is served from that region or it fails with a 422, never
+        #   redirected to another region. Requires `region`.
+        #
+        #   @return [Symbol, Telnyx::Models::AI::OpenAICreateResponseParams::Mode, nil]
+        optional :mode, enum: -> { Telnyx::AI::OpenAICreateResponseParams::Mode }
+
         # @!attribute model
         #   Model identifier to use for the response, for example `zai-org/GLM-5.1-FP8` or
         #   another model available from the Telnyx OpenAI-compatible models endpoint.
@@ -43,6 +53,16 @@ module Telnyx
         #   @return [Telnyx::Models::AI::OpenAICreateResponseParams::Reasoning, nil]
         optional :reasoning, -> { Telnyx::AI::OpenAICreateResponseParams::Reasoning }
 
+        # @!attribute region
+        #   Optional data-residency region the request should be served from, using the same
+        #   vocabulary as your account's Data Locality setting. Behavior depends on `mode`.
+        #   Supported for Telnyx-hosted models only: a request routed to an external
+        #   provider never passes through Telnyx model routing, so a region cannot be
+        #   enforced for it. Omit for today's latency-based routing.
+        #
+        #   @return [Symbol, Telnyx::Models::AI::OpenAICreateResponseParams::Region, nil]
+        optional :region, enum: -> { Telnyx::AI::OpenAICreateResponseParams::Region }
+
         # @!attribute service_tier
         #   The service tier to use for this request. Supported values vary by model; use
         #   `GET /v2/ai/openai/models` and inspect the model's `service_tiers` field. If
@@ -58,7 +78,7 @@ module Telnyx
         #   @return [Boolean, nil]
         optional :stream, Telnyx::Internal::Type::Boolean
 
-        # @!method initialize(conversation: nil, input: nil, instructions: nil, model: nil, reasoning: nil, service_tier: nil, stream: nil, request_options: {})
+        # @!method initialize(conversation: nil, input: nil, instructions: nil, mode: nil, model: nil, reasoning: nil, region: nil, service_tier: nil, stream: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::OpenAICreateResponseParams} for more details.
         #
@@ -68,16 +88,35 @@ module Telnyx
         #
         #   @param instructions [String] Optional system/developer instructions for the model. When used with a persisted
         #
+        #   @param mode [Symbol, Telnyx::Models::AI::OpenAICreateResponseParams::Mode] How strictly `region` is applied. `preferred` (the default when `region` is set)
+        #
         #   @param model [String] Model identifier to use for the response, for example `zai-org/GLM-5.1-FP8` or a
         #
         #   @param reasoning [Telnyx::Models::AI::OpenAICreateResponseParams::Reasoning]
         #
+        #   @param region [Symbol, Telnyx::Models::AI::OpenAICreateResponseParams::Region] Optional data-residency region the request should be served from, using the same
+        #
         #   @param service_tier [String] The service tier to use for this request. Supported values vary by model; use `G
         #
         #   @param stream [Boolean] Set to `true` to stream Server-Sent Events, matching OpenAI's Responses streamin
         #
         #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
 
+        # How strictly `region` is applied. `preferred` (the default when `region` is set)
+        # tries that region first and falls back to another when the model cannot be
+        # served there, so a request that would have succeeded still succeeds. `strict`
+        # pins the request: it is served from that region or it fails with a 422, never
+        # redirected to another region. Requires `region`.
+        module Mode
+          extend Telnyx::Internal::Type::Enum
+
+          PREFERRED = :preferred
+          STRICT = :strict
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
         class Reasoning < Telnyx::Internal::Type::BaseModel
           # @!attribute effort
           #   Controls the reasoning effort for models that support it. Same values and
@@ -111,6 +150,23 @@ module Telnyx
             #   @return [Array<Symbol>]
           end
         end
+
+        # Optional data-residency region the request should be served from, using the same
+        # vocabulary as your account's Data Locality setting. Behavior depends on `mode`.
+        # Supported for Telnyx-hosted models only: a request routed to an external
+        # provider never passes through Telnyx model routing, so a region cannot be
+        # enforced for it. Omit for today's latency-based routing.
+        module Region
+          extend Telnyx::Internal::Type::Enum
+
+          USA = :USA
+          EU = :EU
+          AUS = :AUS
+          UAE = :UAE
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
       end
     end
   end

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

@@ -19,6 +19,18 @@ module Telnyx
         #   @return [Boolean, nil]
         optional :disable_dtmf, Telnyx::Internal::Type::Boolean
 
+        # @!attribute fallback_destination
+        #   Destination number or SIP URI to transfer the caller to when the AI conversation
+        #   ends abnormally, for example because of an assistant-side error, so the caller
+        #   is not left in dead air. This only fires for abnormal ends: it does not fire
+        #   when the conversation ends on purpose (the caller hung up, the assistant
+        #   completed normally, the caller hung up after a relay handoff, or voicemail was
+        #   detected), and it does not fire when the assistant already transferred or
+        #   bridged the call.
+        #
+        #   @return [String, nil]
+        optional :fallback_destination, String
+
         # @!attribute noise_suppression
         #   The noise suppression engine to use. Use 'disabled' to turn off noise
         #   suppression.
@@ -97,7 +109,7 @@ module Telnyx
         #   @return [Telnyx::Models::AI::TelephonySettings::VoicemailDetection, nil]
         optional :voicemail_detection, -> { Telnyx::AI::TelephonySettings::VoicemailDetection }
 
-        # @!method initialize(default_texml_app_id: nil, disable_dtmf: nil, noise_suppression: nil, noise_suppression_config: nil, recording_settings: nil, send_message_history_updates: nil, supports_unauthenticated_web_calls: nil, time_limit_secs: nil, user_idle_reply_secs: nil, user_idle_timeout_secs: nil, voicemail_detection: nil)
+        # @!method initialize(default_texml_app_id: nil, disable_dtmf: nil, fallback_destination: nil, noise_suppression: nil, noise_suppression_config: nil, recording_settings: nil, send_message_history_updates: nil, supports_unauthenticated_web_calls: nil, time_limit_secs: nil, user_idle_reply_secs: nil, user_idle_timeout_secs: nil, voicemail_detection: nil)
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::TelephonySettings} for more details.
         #
@@ -105,6 +117,8 @@ module Telnyx
         #
         #   @param disable_dtmf [Boolean] Disable inbound DTMF for the entire call. Must be set to true if a 'pay' tool is
         #
+        #   @param fallback_destination [String] Destination number or SIP URI to transfer the caller to when the AI conversation
+        #
         #   @param noise_suppression [Symbol, Telnyx::Models::AI::TelephonySettings::NoiseSuppression] The noise suppression engine to use. Use 'disabled' to turn off noise suppressio
         #
         #   @param noise_suppression_config [Telnyx::Models::AI::TelephonySettings::NoiseSuppressionConfig] Configuration for noise suppression. Only applicable when noise_suppression is '

data/lib/telnyx/models/compute/func_retrieve_logs_params.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Compute
+      # @see Telnyx::Resources::Compute::Funcs#retrieve_logs
+      class FuncRetrieveLogsParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute end_time
+        #   Return records at or before this RFC 3339 timestamp.
+        #
+        #   @return [Time, nil]
+        optional :end_time, Time
+
+        # @!attribute limit
+        #   Maximum records to return.
+        #
+        #   @return [Integer, nil]
+        optional :limit, Integer
+
+        # @!attribute start_time
+        #   Return records at or after this RFC 3339 timestamp.
+        #
+        #   @return [Time, nil]
+        optional :start_time, Time
+
+        # @!attribute type
+        #   Log stream to return.
+        #
+        #   @return [Symbol, Telnyx::Models::Compute::FuncRetrieveLogsParams::Type, nil]
+        optional :type, enum: -> { Telnyx::Compute::FuncRetrieveLogsParams::Type }
+
+        # @!method initialize(id:, end_time: nil, limit: nil, start_time: nil, type: nil, request_options: {})
+        #   @param id [String]
+        #
+        #   @param end_time [Time] Return records at or before this RFC 3339 timestamp.
+        #
+        #   @param limit [Integer] Maximum records to return.
+        #
+        #   @param start_time [Time] Return records at or after this RFC 3339 timestamp.
+        #
+        #   @param type [Symbol, Telnyx::Models::Compute::FuncRetrieveLogsParams::Type] Log stream to return.
+        #
+        #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+
+        # Log stream to return.
+        module Type
+          extend Telnyx::Internal::Type::Enum
+
+          RUNTIME = :runtime
+          INVOCATIONS = :invocations
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end