telnyx 5.167.0 → 5.169.0

data/rbi/telnyx/models/x402/credit_account/payment_retrieve_response.rbi

@@ -0,0 +1,53 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    module X402
+      module CreditAccount
+        class PaymentRetrieveResponse < Telnyx::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Telnyx::Models::X402::CreditAccount::PaymentRetrieveResponse,
+                Telnyx::Internal::AnyHash
+              )
+            end
+
+          # An x402 payment transaction.
+          sig do
+            returns(
+              T.nilable(Telnyx::X402::CreditAccount::X402TransactionRecord)
+            )
+          end
+          attr_reader :data
+
+          sig do
+            params(
+              data: Telnyx::X402::CreditAccount::X402TransactionRecord::OrHash
+            ).void
+          end
+          attr_writer :data
+
+          sig do
+            params(
+              data: Telnyx::X402::CreditAccount::X402TransactionRecord::OrHash
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # An x402 payment transaction.
+            data: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              { data: Telnyx::X402::CreditAccount::X402TransactionRecord }
+            )
+          end
+          def to_hash
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/models/x402/credit_account/x402_transaction_record.rbi

@@ -0,0 +1,219 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    module X402
+      module CreditAccount
+        class X402TransactionRecord < Telnyx::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Telnyx::X402::CreditAccount::X402TransactionRecord,
+                Telnyx::Internal::AnyHash
+              )
+            end
+
+          # Unique transaction identifier.
+          sig { returns(T.nilable(String)) }
+          attr_reader :id
+
+          sig { params(id: String).void }
+          attr_writer :id
+
+          # The transaction amount in the specified currency.
+          sig { returns(T.nilable(String)) }
+          attr_reader :amount
+
+          sig { params(amount: String).void }
+          attr_writer :amount
+
+          # ISO 8601 timestamp when the transaction was created.
+          sig { returns(T.nilable(Time)) }
+          attr_reader :created_at
+
+          sig { params(created_at: Time).void }
+          attr_writer :created_at
+
+          # The currency of the transaction amount (e.g. USD).
+          sig { returns(T.nilable(String)) }
+          attr_reader :currency
+
+          sig { params(currency: String).void }
+          attr_writer :currency
+
+          # The original quote ID associated with this transaction.
+          sig { returns(T.nilable(String)) }
+          attr_reader :quote_id
+
+          sig { params(quote_id: String).void }
+          attr_writer :quote_id
+
+          sig do
+            returns(
+              T.nilable(
+                Telnyx::X402::CreditAccount::X402TransactionRecord::RecordType::TaggedSymbol
+              )
+            )
+          end
+          attr_reader :record_type
+
+          sig do
+            params(
+              record_type:
+                Telnyx::X402::CreditAccount::X402TransactionRecord::RecordType::OrSymbol
+            ).void
+          end
+          attr_writer :record_type
+
+          # The settlement status of the transaction. x402 transactions are created after
+          # successful on-chain settlement, so the status is `settled`.
+          sig do
+            returns(
+              T.nilable(
+                Telnyx::X402::CreditAccount::X402TransactionRecord::Status::TaggedSymbol
+              )
+            )
+          end
+          attr_reader :status
+
+          sig do
+            params(
+              status:
+                Telnyx::X402::CreditAccount::X402TransactionRecord::Status::OrSymbol
+            ).void
+          end
+          attr_writer :status
+
+          # The on-chain transaction hash, if available.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :tx_hash
+
+          # ISO 8601 timestamp when the transaction was last updated.
+          sig { returns(T.nilable(Time)) }
+          attr_reader :updated_at
+
+          sig { params(updated_at: Time).void }
+          attr_writer :updated_at
+
+          # An x402 payment transaction.
+          sig do
+            params(
+              id: String,
+              amount: String,
+              created_at: Time,
+              currency: String,
+              quote_id: String,
+              record_type:
+                Telnyx::X402::CreditAccount::X402TransactionRecord::RecordType::OrSymbol,
+              status:
+                Telnyx::X402::CreditAccount::X402TransactionRecord::Status::OrSymbol,
+              tx_hash: T.nilable(String),
+              updated_at: Time
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Unique transaction identifier.
+            id: nil,
+            # The transaction amount in the specified currency.
+            amount: nil,
+            # ISO 8601 timestamp when the transaction was created.
+            created_at: nil,
+            # The currency of the transaction amount (e.g. USD).
+            currency: nil,
+            # The original quote ID associated with this transaction.
+            quote_id: nil,
+            record_type: nil,
+            # The settlement status of the transaction. x402 transactions are created after
+            # successful on-chain settlement, so the status is `settled`.
+            status: nil,
+            # The on-chain transaction hash, if available.
+            tx_hash: nil,
+            # ISO 8601 timestamp when the transaction was last updated.
+            updated_at: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                id: String,
+                amount: String,
+                created_at: Time,
+                currency: String,
+                quote_id: String,
+                record_type:
+                  Telnyx::X402::CreditAccount::X402TransactionRecord::RecordType::TaggedSymbol,
+                status:
+                  Telnyx::X402::CreditAccount::X402TransactionRecord::Status::TaggedSymbol,
+                tx_hash: T.nilable(String),
+                updated_at: Time
+              }
+            )
+          end
+          def to_hash
+          end
+
+          module RecordType
+            extend Telnyx::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Telnyx::X402::CreditAccount::X402TransactionRecord::RecordType
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            X402_TRANSACTION =
+              T.let(
+                :x402_transaction,
+                Telnyx::X402::CreditAccount::X402TransactionRecord::RecordType::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Telnyx::X402::CreditAccount::X402TransactionRecord::RecordType::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+
+          # The settlement status of the transaction. x402 transactions are created after
+          # successful on-chain settlement, so the status is `settled`.
+          module Status
+            extend Telnyx::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Telnyx::X402::CreditAccount::X402TransactionRecord::Status
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            SETTLED =
+              T.let(
+                :settled,
+                Telnyx::X402::CreditAccount::X402TransactionRecord::Status::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Telnyx::X402::CreditAccount::X402TransactionRecord::Status::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/models.rbi

@@ -132,6 +132,15 @@ module Telnyx
 
   BookAppointmentToolParams = Telnyx::Models::BookAppointmentToolParams
 
+  BotChallengeCreateParams = Telnyx::Models::BotChallengeCreateParams
+
+  BotSessionListParams = Telnyx::Models::BotSessionListParams
+
+  BotSignupCreateParams = Telnyx::Models::BotSignupCreateParams
+
+  BotSignupResendMagicLinkParams =
+    Telnyx::Models::BotSignupResendMagicLinkParams
+
   BrandedCallingPaginationMeta = Telnyx::Models::BrandedCallingPaginationMeta
 
   BulkMessagingSettingsUpdatePhoneNumbers =
@@ -392,6 +401,8 @@ module Telnyx
 
   CommentRetrieveParams = Telnyx::Models::CommentRetrieveParams
 
+  Compute = Telnyx::Models::Compute
+
   Conference = Telnyx::Models::Conference
 
   ConferenceCreated = Telnyx::Models::ConferenceCreated
@@ -498,6 +509,8 @@ module Telnyx
   ConnectionNoiseSuppressionDetails =
     Telnyx::Models::ConnectionNoiseSuppressionDetails
 
+  ConnectionRetrieveCountParams = Telnyx::Models::ConnectionRetrieveCountParams
+
   ConnectionRetrieveParams = Telnyx::Models::ConnectionRetrieveParams
 
   ConnectionRtcpSettings = Telnyx::Models::ConnectionRtcpSettings
@@ -1110,6 +1123,9 @@ module Telnyx
 
   ListRetrieveByZoneParams = Telnyx::Models::ListRetrieveByZoneParams
 
+  MachinePaymentAccountCreditParams =
+    Telnyx::Models::MachinePaymentAccountCreditParams
+
   ManagedAccount = Telnyx::Models::ManagedAccount
 
   ManagedAccountBalance = Telnyx::Models::ManagedAccountBalance
@@ -1251,6 +1267,8 @@ module Telnyx
   MessagingHostedNumberUpdateParams =
     Telnyx::Models::MessagingHostedNumberUpdateParams
 
+  MessagingInboundMessage = Telnyx::Models::MessagingInboundMessage
+
   MessagingInboundMessagePayload =
     Telnyx::Models::MessagingInboundMessagePayload
 
@@ -1280,6 +1298,8 @@ module Telnyx
 
   MessagingProfileDeleteParams = Telnyx::Models::MessagingProfileDeleteParams
 
+  MessagingProfileFeatures = Telnyx::Models::MessagingProfileFeatures
+
   MessagingProfileListAlphanumericSenderIDsParams =
     Telnyx::Models::MessagingProfileListAlphanumericSenderIDsParams
 
@@ -1387,6 +1407,9 @@ module Telnyx
 
   NetworkUpdateParams = Telnyx::Models::NetworkUpdateParams
 
+  NoiseSuppressionEngineListParams =
+    Telnyx::Models::NoiseSuppressionEngineListParams
+
   NotificationChannel = Telnyx::Models::NotificationChannel
 
   NotificationChannelCreateParams =
@@ -2074,6 +2097,8 @@ module Telnyx
   SubNumberOrderUpdateRequirementGroupParams =
     Telnyx::Models::SubNumberOrderUpdateRequirementGroupParams
 
+  SuccessResponse = Telnyx::Models::SuccessResponse
+
   SuppressedRecipient = Telnyx::Models::SuppressedRecipient
 
   TelephonyCredential = Telnyx::Models::TelephonyCredential
@@ -2386,6 +2411,8 @@ module Telnyx
 
   Whatsapp = Telnyx::Models::Whatsapp
 
+  WhatsappAccountUpdate = Telnyx::Models::WhatsappAccountUpdate
+
   WhatsappContact = Telnyx::Models::WhatsappContact
 
   WhatsappInteractive = Telnyx::Models::WhatsappInteractive
@@ -2396,6 +2423,8 @@ module Telnyx
 
   WhatsappMessageContent = Telnyx::Models::WhatsappMessageContent
 
+  WhatsappMessageEcho = Telnyx::Models::WhatsappMessageEcho
+
   WhatsappMessageTemplateDeleteParams =
     Telnyx::Models::WhatsappMessageTemplateDeleteParams
 

data/rbi/telnyx/resources/ai/assistants/versions.rbi

@@ -32,6 +32,7 @@ module Telnyx
             params(
               version_id: String,
               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],
@@ -61,11 +62,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,
@@ -88,6 +90,17 @@ module Telnyx
             version_id,
             # Path param: Unique identifier of the assistant.
             assistant_id:,
+            # Body param: 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,
             # Body param: Conversation flow as supplied by API clients (create / update).
             #
             # A directed graph of `FlowNodeReq` connected by `FlowEdge`s. Validation enforces
@@ -167,10 +180,10 @@ module Telnyx
             observability_settings: nil,
             # Body param: 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.
+            # it to 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,
             # Body param
             privacy_settings: nil,
@@ -180,11 +193,22 @@ module Telnyx
             # Body param
             telephony_settings: nil,
             # Body param: IDs of shared tools to attach to the assistant. New integrations
-            # should prefer `tool_ids` over inline `tools`.
+            # should prefer `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,
             # Body param: Deprecated for new integrations. Inline tool definitions available
             # to the assistant. Prefer `tool_ids` to attach shared tools created with the AI
-            # Tools endpoints.
+            # Tools 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,
             # Body param
             transcription: nil,

data/rbi/telnyx/resources/ai/assistants.rbi

@@ -39,6 +39,7 @@ module Telnyx
           params(
             instructions: String,
             name: String,
+            a2a_agents: T::Array[Telnyx::AI::AssistantA2AAgent::OrHash],
             conversation_flow: Telnyx::AI::ConversationFlowReq::OrHash,
             description: String,
             dynamic_variables: T::Hash[Symbol, T.anything],
@@ -66,11 +67,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,
@@ -94,6 +96,15 @@ module Telnyx
           instructions:,
           # Body param
           name:,
+          # Body param: 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.
+          a2a_agents: nil,
           # Body param: Conversation flow as supplied by API clients (create / update).
           #
           # A directed graph of `FlowNodeReq` connected by `FlowEdge`s. Validation enforces
@@ -168,10 +179,10 @@ module Telnyx
           observability_settings: nil,
           # Body param: 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.
+          # it to 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,
           # Body param
           privacy_settings: nil,
@@ -238,6 +249,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],
@@ -268,11 +280,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,
@@ -293,6 +306,16 @@ module Telnyx
         def update(
           # Unique identifier of the assistant.
           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
@@ -363,10 +386,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
@@ -377,11 +400,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.

data/rbi/telnyx/resources/ai/audio.rbi

@@ -24,25 +24,36 @@ module Telnyx
         def transcribe(
           # 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.

data/rbi/telnyx/resources/ai/openai/chat.rbi

@@ -18,9 +18,6 @@ module Telnyx
               early_stopping: T::Boolean,
               enable_thinking: T::Boolean,
               frequency_penalty: Float,
-              guided_choice: T::Array[String],
-              guided_json: T::Hash[Symbol, T.anything],
-              guided_regex: String,
               length_penalty: Float,
               logprobs: T::Boolean,
               max_tokens: Integer,
@@ -33,7 +30,11 @@ module Telnyx
                 Telnyx::AI::ChatCompletionRequest::ReasoningEffort::OrSymbol,
               region: Telnyx::AI::ChatCompletionRequest::Region::OrSymbol,
               response_format:
-                Telnyx::AI::ChatCompletionRequest::ResponseFormat::OrHash,
+                T.any(
+                  Telnyx::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatText::OrHash,
+                  Telnyx::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatJsonObject::OrHash,
+                  Telnyx::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatJsonSchemaParam::OrHash
+                ),
               seed: Integer,
               service_tier: String,
               stop: Telnyx::AI::ChatCompletionRequest::Stop::Variants,
@@ -75,13 +76,6 @@ module Telnyx
             enable_thinking: nil,
             # Higher values will penalize the model from repeating the same output tokens.
             frequency_penalty: nil,
-            # If specified, the output will be exactly one of the choices.
-            guided_choice: nil,
-            # Must be a valid JSON schema. If specified, the output will follow the JSON
-            # schema.
-            guided_json: nil,
-            # If specified, the output will follow the regex pattern.
-            guided_regex: nil,
             # This is used with `use_beam_search` to prefer shorter or longer completions.
             length_penalty: nil,
             # Whether to return log probabilities of the output tokens or not. If true,
@@ -118,8 +112,10 @@ module Telnyx
             # provider never passes through Telnyx model routing, so a region cannot be
             # enforced for it. Omit for today's latency-based routing.
             region: nil,
-            # 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.
             response_format: nil,
             # If specified, the system will make a best effort to sample deterministically,
             # such that repeated requests with the same `seed` and parameters should return