telnyx 5.167.0 → 5.169.0

data/rbi/telnyx/models/ai/assistant_update_params.rbi

@@ -15,6 +15,25 @@ module Telnyx
         sig { returns(String) }
         attr_accessor :assistant_id
 
+        # 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. Omit this field to
+        # leave the assistant's agents unchanged; send an empty array to remove them all.
+        sig { returns(T.nilable(T::Array[Telnyx::AI::AssistantA2AAgent])) }
+        attr_reader :a2a_agents
+
+        sig do
+          params(
+            a2a_agents: T::Array[Telnyx::AI::AssistantA2AAgent::OrHash]
+          ).void
+        end
+        attr_writer :a2a_agents
+
         # Conversation flow as supplied by API clients (create / update).
         #
         # A directed graph of `FlowNodeReq` connected by `FlowEdge`s. Validation enforces
@@ -215,10 +234,10 @@ module Telnyx
 
         # Configuration for post-conversation processing. When enabled, the assistant
         # receives one additional LLM turn after the conversation ends, allowing it to
-        # execute tool calls such as logging to a CRM or sending a summary. The assistant
-        # can execute multiple parallel or sequential tools during this phase.
-        # Telephony-control tools (e.g. hangup, transfer) are unavailable
-        # post-conversation. Beta feature.
+        # execute final tool calls such as sending a summary or updating a record via
+        # webhook or function tools. Integration and MCP server tools are not available
+        # post-conversation; call-control tools (e.g. hangup, transfer) are also
+        # unavailable. Beta feature.
         sig { returns(T.nilable(Telnyx::AI::PostConversationSettingsReq)) }
         attr_reader :post_conversation_settings
 
@@ -263,7 +282,11 @@ module Telnyx
         attr_writer :telephony_settings
 
         # IDs of shared tools to attach to the assistant. New integrations should prefer
-        # `tool_ids` over inline `tools`.
+        # `tool_ids` over inline `tools`. On update, a sent `tool_ids` array fully
+        # replaces the assistant's attached shared tools; omit the field to leave them
+        # unchanged. Single-instance tool types are counted across inline `tools` and
+        # `tool_ids` combined, so attaching a shared tool of such a type when an instance
+        # already exists returns HTTP 400 with error code 10015.
         sig { returns(T.nilable(T::Array[String])) }
         attr_reader :tool_ids
 
@@ -272,17 +295,25 @@ module Telnyx
 
         # Deprecated for new integrations. Inline tool definitions available to the
         # assistant. Prefer `tool_ids` to attach shared tools created with the AI Tools
-        # endpoints.
+        # endpoints. On update, a sent `tools` array fully replaces the assistant's inline
+        # tools; omit the field to leave the inline tools unchanged. Each tool type except
+        # `function`, `webhook`, and `client_side_tool` allows at most one instance per
+        # assistant, counted across inline `tools` and shared `tool_ids` combined —
+        # sending a duplicate of such a type returns HTTP 400 with error code 10015.
+        # Responses merge shared tools into `tools` with `shared: true`; when updating,
+        # omit those tools from the `tools` array and manage them through `tool_ids`
+        # instead.
         sig do
           returns(
             T.nilable(
               T::Array[
                 T.any(
+                  Telnyx::AI::AssistantTool::Function,
                   Telnyx::AI::InferenceEmbeddingWebhookToolParams,
                   Telnyx::AI::AssistantTool::ClientSideTool,
                   Telnyx::AI::RetrievalTool,
                   Telnyx::AI::AssistantTool::Handoff,
-                  Telnyx::AI::HangupTool,
+                  Telnyx::AI::AssistantTool::Hangup,
                   Telnyx::AI::AssistantTool::Transfer,
                   Telnyx::AI::AssistantTool::Invite,
                   Telnyx::AI::AssistantTool::Refer,
@@ -303,11 +334,12 @@ module Telnyx
             tools:
               T::Array[
                 T.any(
+                  Telnyx::AI::AssistantTool::Function::OrHash,
                   Telnyx::AI::InferenceEmbeddingWebhookToolParams::OrHash,
                   Telnyx::AI::AssistantTool::ClientSideTool::OrHash,
                   Telnyx::AI::RetrievalTool::OrHash,
                   Telnyx::AI::AssistantTool::Handoff::OrHash,
-                  Telnyx::AI::HangupTool::OrHash,
+                  Telnyx::AI::AssistantTool::Hangup::OrHash,
                   Telnyx::AI::AssistantTool::Transfer::OrHash,
                   Telnyx::AI::AssistantTool::Invite::OrHash,
                   Telnyx::AI::AssistantTool::Refer::OrHash,
@@ -353,6 +385,7 @@ module Telnyx
         sig do
           params(
             assistant_id: String,
+            a2a_agents: T::Array[Telnyx::AI::AssistantA2AAgent::OrHash],
             conversation_flow: Telnyx::AI::ConversationFlowReq::OrHash,
             description: String,
             dynamic_variables: T::Hash[Symbol, T.anything],
@@ -383,11 +416,12 @@ module Telnyx
             tools:
               T::Array[
                 T.any(
+                  Telnyx::AI::AssistantTool::Function::OrHash,
                   Telnyx::AI::InferenceEmbeddingWebhookToolParams::OrHash,
                   Telnyx::AI::AssistantTool::ClientSideTool::OrHash,
                   Telnyx::AI::RetrievalTool::OrHash,
                   Telnyx::AI::AssistantTool::Handoff::OrHash,
-                  Telnyx::AI::HangupTool::OrHash,
+                  Telnyx::AI::AssistantTool::Hangup::OrHash,
                   Telnyx::AI::AssistantTool::Transfer::OrHash,
                   Telnyx::AI::AssistantTool::Invite::OrHash,
                   Telnyx::AI::AssistantTool::Refer::OrHash,
@@ -407,6 +441,16 @@ module Telnyx
         end
         def self.new(
           assistant_id:,
+          # 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. Omit this field to
+          # leave the assistant's agents unchanged; send an empty array to remove them all.
+          a2a_agents: nil,
           # Conversation flow as supplied by API clients (create / update).
           #
           # A directed graph of `FlowNodeReq` connected by `FlowEdge`s. Validation enforces
@@ -477,10 +521,10 @@ module Telnyx
           observability_settings: nil,
           # Configuration for post-conversation processing. When enabled, the assistant
           # receives one additional LLM turn after the conversation ends, allowing it to
-          # execute tool calls such as logging to a CRM or sending a summary. The assistant
-          # can execute multiple parallel or sequential tools during this phase.
-          # Telephony-control tools (e.g. hangup, transfer) are unavailable
-          # post-conversation. Beta feature.
+          # execute final tool calls such as sending a summary or updating a record via
+          # webhook or function tools. Integration and MCP server tools are not available
+          # post-conversation; call-control tools (e.g. hangup, transfer) are also
+          # unavailable. Beta feature.
           post_conversation_settings: nil,
           privacy_settings: nil,
           # Indicates whether the assistant should be promoted to the main version. Defaults
@@ -491,11 +535,22 @@ module Telnyx
           tags: nil,
           telephony_settings: nil,
           # IDs of shared tools to attach to the assistant. New integrations should prefer
-          # `tool_ids` over inline `tools`.
+          # `tool_ids` over inline `tools`. On update, a sent `tool_ids` array fully
+          # replaces the assistant's attached shared tools; omit the field to leave them
+          # unchanged. Single-instance tool types are counted across inline `tools` and
+          # `tool_ids` combined, so attaching a shared tool of such a type when an instance
+          # already exists returns HTTP 400 with error code 10015.
           tool_ids: nil,
           # Deprecated for new integrations. Inline tool definitions available to the
           # assistant. Prefer `tool_ids` to attach shared tools created with the AI Tools
-          # endpoints.
+          # endpoints. On update, a sent `tools` array fully replaces the assistant's inline
+          # tools; omit the field to leave the inline tools unchanged. Each tool type except
+          # `function`, `webhook`, and `client_side_tool` allows at most one instance per
+          # assistant, counted across inline `tools` and shared `tool_ids` combined —
+          # sending a duplicate of such a type returns HTTP 400 with error code 10015.
+          # Responses merge shared tools into `tools` with `shared: true`; when updating,
+          # omit those tools from the `tools` array and manage them through `tool_ids`
+          # instead.
           tools: nil,
           transcription: nil,
           # Human-readable name for the assistant version.
@@ -511,6 +566,7 @@ module Telnyx
           override.returns(
             {
               assistant_id: String,
+              a2a_agents: T::Array[Telnyx::AI::AssistantA2AAgent],
               conversation_flow: Telnyx::AI::ConversationFlowReq,
               description: String,
               dynamic_variables: T::Hash[Symbol, T.anything],
@@ -541,11 +597,12 @@ module Telnyx
               tools:
                 T::Array[
                   T.any(
+                    Telnyx::AI::AssistantTool::Function,
                     Telnyx::AI::InferenceEmbeddingWebhookToolParams,
                     Telnyx::AI::AssistantTool::ClientSideTool,
                     Telnyx::AI::RetrievalTool,
                     Telnyx::AI::AssistantTool::Handoff,
-                    Telnyx::AI::HangupTool,
+                    Telnyx::AI::AssistantTool::Hangup,
                     Telnyx::AI::AssistantTool::Transfer,
                     Telnyx::AI::AssistantTool::Invite,
                     Telnyx::AI::AssistantTool::Refer,

data/rbi/telnyx/models/ai/assistants/update_assistant.rbi

@@ -15,6 +15,25 @@ module Telnyx
               )
             end
 
+          # 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. Omit this field to
+          # leave the assistant's agents unchanged; send an empty array to remove them all.
+          sig { returns(T.nilable(T::Array[Telnyx::AI::AssistantA2AAgent])) }
+          attr_reader :a2a_agents
+
+          sig do
+            params(
+              a2a_agents: T::Array[Telnyx::AI::AssistantA2AAgent::OrHash]
+            ).void
+          end
+          attr_writer :a2a_agents
+
           # Conversation flow as supplied by API clients (create / update).
           #
           # A directed graph of `FlowNodeReq` connected by `FlowEdge`s. Validation enforces
@@ -219,10 +238,10 @@ module Telnyx
 
           # Configuration for post-conversation processing. When enabled, the assistant
           # receives one additional LLM turn after the conversation ends, allowing it to
-          # execute tool calls such as logging to a CRM or sending a summary. The assistant
-          # can execute multiple parallel or sequential tools during this phase.
-          # Telephony-control tools (e.g. hangup, transfer) are unavailable
-          # post-conversation. Beta feature.
+          # execute final tool calls such as sending a summary or updating a record via
+          # webhook or function tools. Integration and MCP server tools are not available
+          # post-conversation; call-control tools (e.g. hangup, transfer) are also
+          # unavailable. Beta feature.
           sig { returns(T.nilable(Telnyx::AI::PostConversationSettingsReq)) }
           attr_reader :post_conversation_settings
 
@@ -261,7 +280,11 @@ module Telnyx
           attr_writer :telephony_settings
 
           # IDs of shared tools to attach to the assistant. New integrations should prefer
-          # `tool_ids` over inline `tools`.
+          # `tool_ids` over inline `tools`. On update, a sent `tool_ids` array fully
+          # replaces the assistant's attached shared tools; omit the field to leave them
+          # unchanged. Single-instance tool types are counted across inline `tools` and
+          # `tool_ids` combined, so attaching a shared tool of such a type when an instance
+          # already exists returns HTTP 400 with error code 10015.
           sig { returns(T.nilable(T::Array[String])) }
           attr_reader :tool_ids
 
@@ -270,17 +293,25 @@ module Telnyx
 
           # Deprecated for new integrations. Inline tool definitions available to the
           # assistant. Prefer `tool_ids` to attach shared tools created with the AI Tools
-          # endpoints.
+          # endpoints. On update, a sent `tools` array fully replaces the assistant's inline
+          # tools; omit the field to leave the inline tools unchanged. Each tool type except
+          # `function`, `webhook`, and `client_side_tool` allows at most one instance per
+          # assistant, counted across inline `tools` and shared `tool_ids` combined —
+          # sending a duplicate of such a type returns HTTP 400 with error code 10015.
+          # Responses merge shared tools into `tools` with `shared: true`; when updating,
+          # omit those tools from the `tools` array and manage them through `tool_ids`
+          # instead.
           sig do
             returns(
               T.nilable(
                 T::Array[
                   T.any(
+                    Telnyx::AI::AssistantTool::Function,
                     Telnyx::AI::InferenceEmbeddingWebhookToolParams,
                     Telnyx::AI::AssistantTool::ClientSideTool,
                     Telnyx::AI::RetrievalTool,
                     Telnyx::AI::AssistantTool::Handoff,
-                    Telnyx::AI::HangupTool,
+                    Telnyx::AI::AssistantTool::Hangup,
                     Telnyx::AI::AssistantTool::Transfer,
                     Telnyx::AI::AssistantTool::Invite,
                     Telnyx::AI::AssistantTool::Refer,
@@ -301,11 +332,12 @@ module Telnyx
               tools:
                 T::Array[
                   T.any(
+                    Telnyx::AI::AssistantTool::Function::OrHash,
                     Telnyx::AI::InferenceEmbeddingWebhookToolParams::OrHash,
                     Telnyx::AI::AssistantTool::ClientSideTool::OrHash,
                     Telnyx::AI::RetrievalTool::OrHash,
                     Telnyx::AI::AssistantTool::Handoff::OrHash,
-                    Telnyx::AI::HangupTool::OrHash,
+                    Telnyx::AI::AssistantTool::Hangup::OrHash,
                     Telnyx::AI::AssistantTool::Transfer::OrHash,
                     Telnyx::AI::AssistantTool::Invite::OrHash,
                     Telnyx::AI::AssistantTool::Refer::OrHash,
@@ -354,6 +386,7 @@ module Telnyx
 
           sig do
             params(
+              a2a_agents: T::Array[Telnyx::AI::AssistantA2AAgent::OrHash],
               conversation_flow: Telnyx::AI::ConversationFlowReq::OrHash,
               description: String,
               dynamic_variables: T::Hash[Symbol, T.anything],
@@ -383,11 +416,12 @@ module Telnyx
               tools:
                 T::Array[
                   T.any(
+                    Telnyx::AI::AssistantTool::Function::OrHash,
                     Telnyx::AI::InferenceEmbeddingWebhookToolParams::OrHash,
                     Telnyx::AI::AssistantTool::ClientSideTool::OrHash,
                     Telnyx::AI::RetrievalTool::OrHash,
                     Telnyx::AI::AssistantTool::Handoff::OrHash,
-                    Telnyx::AI::HangupTool::OrHash,
+                    Telnyx::AI::AssistantTool::Hangup::OrHash,
                     Telnyx::AI::AssistantTool::Transfer::OrHash,
                     Telnyx::AI::AssistantTool::Invite::OrHash,
                     Telnyx::AI::AssistantTool::Refer::OrHash,
@@ -405,6 +439,16 @@ module Telnyx
             ).returns(T.attached_class)
           end
           def self.new(
+            # 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. Omit this field to
+            # leave the assistant's agents unchanged; send an empty array to remove them all.
+            a2a_agents: nil,
             # Conversation flow as supplied by API clients (create / update).
             #
             # A directed graph of `FlowNodeReq` connected by `FlowEdge`s. Validation enforces
@@ -475,10 +519,10 @@ module Telnyx
             observability_settings: nil,
             # Configuration for post-conversation processing. When enabled, the assistant
             # receives one additional LLM turn after the conversation ends, allowing it to
-            # execute tool calls such as logging to a CRM or sending a summary. The assistant
-            # can execute multiple parallel or sequential tools during this phase.
-            # Telephony-control tools (e.g. hangup, transfer) are unavailable
-            # post-conversation. Beta feature.
+            # execute final tool calls such as sending a summary or updating a record via
+            # webhook or function tools. Integration and MCP server tools are not available
+            # post-conversation; call-control tools (e.g. hangup, transfer) are also
+            # unavailable. Beta feature.
             post_conversation_settings: nil,
             privacy_settings: nil,
             # Tags associated with the assistant. Tags can also be managed with the assistant
@@ -486,11 +530,22 @@ module Telnyx
             tags: nil,
             telephony_settings: nil,
             # IDs of shared tools to attach to the assistant. New integrations should prefer
-            # `tool_ids` over inline `tools`.
+            # `tool_ids` over inline `tools`. On update, a sent `tool_ids` array fully
+            # replaces the assistant's attached shared tools; omit the field to leave them
+            # unchanged. Single-instance tool types are counted across inline `tools` and
+            # `tool_ids` combined, so attaching a shared tool of such a type when an instance
+            # already exists returns HTTP 400 with error code 10015.
             tool_ids: nil,
             # Deprecated for new integrations. Inline tool definitions available to the
             # assistant. Prefer `tool_ids` to attach shared tools created with the AI Tools
-            # endpoints.
+            # endpoints. On update, a sent `tools` array fully replaces the assistant's inline
+            # tools; omit the field to leave the inline tools unchanged. Each tool type except
+            # `function`, `webhook`, and `client_side_tool` allows at most one instance per
+            # assistant, counted across inline `tools` and shared `tool_ids` combined —
+            # sending a duplicate of such a type returns HTTP 400 with error code 10015.
+            # Responses merge shared tools into `tools` with `shared: true`; when updating,
+            # omit those tools from the `tools` array and manage them through `tool_ids`
+            # instead.
             tools: nil,
             transcription: nil,
             # Human-readable name for the assistant version.
@@ -504,6 +559,7 @@ module Telnyx
           sig do
             override.returns(
               {
+                a2a_agents: T::Array[Telnyx::AI::AssistantA2AAgent],
                 conversation_flow: Telnyx::AI::ConversationFlowReq,
                 description: String,
                 dynamic_variables: T::Hash[Symbol, T.anything],
@@ -534,11 +590,12 @@ module Telnyx
                 tools:
                   T::Array[
                     T.any(
+                      Telnyx::AI::AssistantTool::Function,
                       Telnyx::AI::InferenceEmbeddingWebhookToolParams,
                       Telnyx::AI::AssistantTool::ClientSideTool,
                       Telnyx::AI::RetrievalTool,
                       Telnyx::AI::AssistantTool::Handoff,
-                      Telnyx::AI::HangupTool,
+                      Telnyx::AI::AssistantTool::Hangup,
                       Telnyx::AI::AssistantTool::Transfer,
                       Telnyx::AI::AssistantTool::Invite,
                       Telnyx::AI::AssistantTool::Refer,

data/rbi/telnyx/models/ai/audio_transcribe_params.rbi

@@ -14,15 +14,19 @@ module Telnyx
 
         # ID of the model to use. `distil-whisper/distil-large-v2` is lower latency but
         # English-only. `openai/whisper-large-v3-turbo` is multi-lingual but slightly
-        # higher latency. `deepgram/nova-3` supports English variants (en, en-US, en-GB,
-        # en-AU, en-NZ, en-IN) and only accepts mp3/wav files.
+        # higher latency. The `deepgram/*` models only accept mp3/wav files:
+        # `deepgram/nova-3` covers ~49 languages plus `multi` and `deepgram/nova-2` covers
+        # ~33, while the `-medical` variants are tuned for clinical vocabulary and accept
+        # 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.
         sig { returns(Telnyx::AI::AudioTranscribeParams::Model::OrSymbol) }
         attr_accessor :model
 
         # The audio file object to transcribe, in one of these formats: flac, mp3, mp4,
         # mpeg, mpga, m4a, ogg, wav, or webm. File uploads are limited to 100 MB. Cannot
-        # be used together with `file_url`. Note: `deepgram/nova-3` only supports mp3 and
-        # wav formats.
+        # be used together with `file_url`. Note: the `deepgram/*` models only support mp3
+        # and wav formats.
         sig { returns(T.nilable(Telnyx::Internal::FileInput)) }
         attr_reader :file
 
@@ -31,25 +35,32 @@ module Telnyx
 
         # Link to audio file in one of these formats: flac, mp3, mp4, mpeg, mpga, m4a,
         # ogg, wav, or webm. Support for hosted files is limited to 100MB. Cannot be used
-        # together with `file`. Note: `deepgram/nova-3` only supports mp3 and wav formats.
+        # together with `file`. Note: the `deepgram/*` models only support mp3 and wav
+        # formats.
         sig { returns(T.nilable(String)) }
         attr_reader :file_url
 
         sig { params(file_url: String).void }
         attr_writer :file_url
 
-        # The language of the audio to be transcribed. For `deepgram/nova-3`, only English
-        # variants are supported: `en`, `en-US`, `en-GB`, `en-AU`, `en-NZ`, `en-IN`. For
+        # The language of the audio to be transcribed. `deepgram/nova-3` supports ~49
+        # languages plus `multi`, and `deepgram/nova-2` supports ~33 plus `multi`; the
+        # `-medical` variants are English only (`en` and its regional variants, e.g.
+        # `en-US`, `en-GB`). Deepgram models validate on the base language and forward the
+        # full tag, so regional variants such as `de-CH` and `pt-BR` are accepted where
+        # the base language is supported; an unsupported language returns a 400. For
         # `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.
         sig { returns(T.nilable(String)) }
         attr_reader :language
 
         sig { params(language: String).void }
         attr_writer :language
 
-        # Additional model-specific configuration parameters. Only allowed with
-        # `deepgram/nova-3` model. Can include Deepgram-specific options such as
+        # 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.
@@ -115,25 +126,36 @@ module Telnyx
         def self.new(
           # ID of the model to use. `distil-whisper/distil-large-v2` is lower latency but
           # English-only. `openai/whisper-large-v3-turbo` is multi-lingual but slightly
-          # higher latency. `deepgram/nova-3` supports English variants (en, en-US, en-GB,
-          # en-AU, en-NZ, en-IN) and only accepts mp3/wav files.
+          # higher latency. The `deepgram/*` models only accept mp3/wav files:
+          # `deepgram/nova-3` covers ~49 languages plus `multi` and `deepgram/nova-2` covers
+          # ~33, while the `-medical` variants are tuned for clinical vocabulary and accept
+          # 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.
           model:,
           # The audio file object to transcribe, in one of these formats: flac, mp3, mp4,
           # mpeg, mpga, m4a, ogg, wav, or webm. File uploads are limited to 100 MB. Cannot
-          # be used together with `file_url`. Note: `deepgram/nova-3` only supports mp3 and
-          # wav formats.
+          # be used together with `file_url`. Note: the `deepgram/*` models only support mp3
+          # and wav formats.
           file: nil,
           # Link to audio file in one of these formats: flac, mp3, mp4, mpeg, mpga, m4a,
           # ogg, wav, or webm. Support for hosted files is limited to 100MB. Cannot be used
-          # together with `file`. Note: `deepgram/nova-3` only supports mp3 and wav formats.
+          # together with `file`. Note: the `deepgram/*` models only support mp3 and wav
+          # formats.
           file_url: nil,
-          # The language of the audio to be transcribed. For `deepgram/nova-3`, only English
-          # variants are supported: `en`, `en-US`, `en-GB`, `en-AU`, `en-NZ`, `en-IN`. For
+          # The language of the audio to be transcribed. `deepgram/nova-3` supports ~49
+          # languages plus `multi`, and `deepgram/nova-2` supports ~33 plus `multi`; the
+          # `-medical` variants are English only (`en` and its regional variants, e.g.
+          # `en-US`, `en-GB`). Deepgram models validate on the base language and forward the
+          # full tag, so regional variants such as `de-CH` and `pt-BR` are accepted where
+          # the base language is supported; an unsupported language returns a 400. For
           # `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.
           language: nil,
-          # Additional model-specific configuration parameters. Only allowed with
-          # `deepgram/nova-3` model. Can include Deepgram-specific options such as
+          # 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.
@@ -170,8 +192,12 @@ module Telnyx
 
         # ID of the model to use. `distil-whisper/distil-large-v2` is lower latency but
         # English-only. `openai/whisper-large-v3-turbo` is multi-lingual but slightly
-        # higher latency. `deepgram/nova-3` supports English variants (en, en-US, en-GB,
-        # en-AU, en-NZ, en-IN) and only accepts mp3/wav files.
+        # higher latency. The `deepgram/*` models only accept mp3/wav files:
+        # `deepgram/nova-3` covers ~49 languages plus `multi` and `deepgram/nova-2` covers
+        # ~33, while the `-medical` variants are tuned for clinical vocabulary and accept
+        # 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.
         module Model
           extend Telnyx::Internal::Type::Enum
 
@@ -191,11 +217,36 @@ module Telnyx
               :"openai/whisper-large-v3-turbo",
               Telnyx::AI::AudioTranscribeParams::Model::TaggedSymbol
             )
+          DEEPGRAM_NOVA_2 =
+            T.let(
+              :"deepgram/nova-2",
+              Telnyx::AI::AudioTranscribeParams::Model::TaggedSymbol
+            )
+          DEEPGRAM_NOVA_2_MEDICAL =
+            T.let(
+              :"deepgram/nova-2-medical",
+              Telnyx::AI::AudioTranscribeParams::Model::TaggedSymbol
+            )
           DEEPGRAM_NOVA_3 =
             T.let(
               :"deepgram/nova-3",
               Telnyx::AI::AudioTranscribeParams::Model::TaggedSymbol
             )
+          DEEPGRAM_NOVA_3_MEDICAL =
+            T.let(
+              :"deepgram/nova-3-medical",
+              Telnyx::AI::AudioTranscribeParams::Model::TaggedSymbol
+            )
+          NVIDIA_PARAKEET_V3 =
+            T.let(
+              :"nvidia/parakeet-v3",
+              Telnyx::AI::AudioTranscribeParams::Model::TaggedSymbol
+            )
+          OMI_HEALTH_OMI_MED_STT_V1 =
+            T.let(
+              :"omi-health/omi-med-stt-v1",
+              Telnyx::AI::AudioTranscribeParams::Model::TaggedSymbol
+            )
 
           sig do
             override.returns(