telnyx 5.158.0 → 5.159.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7ba2d7dc239e9dadfb6ab54f6db2e3ba392a0daa2aefc510125246f1c56ba2bf
-  data.tar.gz: e221a76eb1569c624505f16a05ed24b7240a98822363fc7ce624efe40b2db83a
+  metadata.gz: 2ef3d02bb657bb6d91e6d90a8cad3873c5db29d4ba4ecb61e21fbf2efae59dcb
+  data.tar.gz: 71c473b3a79715cbbd52939409016def3959295c91a60d1523d44b74764b7e5e
 SHA512:
-  metadata.gz: 33ef86c497f0b0766fe589d3e972c1b7c38f62071feb8124fa90ba5384592feeab448cdc437e033f1fa1b9267145173ddbc1018db3ce0ec62a9b213d41da4f70
-  data.tar.gz: feca65fd354e30431cf7f3a9e8b3d92ba72b754ff354181dbb484d4cf7095d39c4cfebe0da248e7a28f4a2688f0b40387e87fc8a8da8a6f17e47abbba44fa50f
+  metadata.gz: 581c58a35b40cc249ef319daf7fe65f751236995fac4d017eba7815439154b540ad91f49c35e8869c0295a26e2d0d063a52e07929deed5b03f987236e6879676
+  data.tar.gz: 51743faea90266f4617c362a577f705156c2ab90f3f136940dab596622367e1b716adec87c111db38a77da6df647d8dcc9055fa84b89e7c11b2bc05f6e0d6b41

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [5.159.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.158.0...v5.159.0) (2026-08-03)
+
+
+### Features
+
+* promote from staging 096fe95 ([242763e](https://github.com/team-telnyx/telnyx-ruby/commit/242763ec0d95a0cfc6cc322b0480605ccbd9e4a6))
+
+
+### Chores
+
+* add repository code owner ([#334](https://github.com/team-telnyx/telnyx-ruby/issues/334)) ([db8b14a](https://github.com/team-telnyx/telnyx-ruby/commit/db8b14a96026cf8d6218200ac689fb3dd251cec0))
+
 ## [5.158.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.157.0...v5.158.0) (2026-07-21)
 
 

data/README.md

@@ -24,7 +24,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "telnyx", "~> 5.158.0"
+gem "telnyx", "~> 5.159.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/telnyx/client.rb

@@ -690,6 +690,47 @@ module Telnyx
     # @return [Telnyx::Resources::InfringementClaims]
     attr_reader :infringement_claims
 
+    # Recipient suppression records (`/v2/email_blocks`).
+    # @return [Telnyx::Resources::EmailBlocks]
+    attr_reader :email_blocks
+
+    # @return [Telnyx::Resources::EmailDomains]
+    attr_reader :email_domains
+
+    # Retrieve account-level email events and event statistics.
+    # @return [Telnyx::Resources::EmailEvents]
+    attr_reader :email_events
+
+    # Create and manage agent inboxes, retrieve inbound messages and threads, and
+    # reply to or forward messages.
+    # @return [Telnyx::Resources::EmailInboxes]
+    attr_reader :email_inboxes
+
+    # Send and manage email messages. Legacy `/v2/emails` routes are aliases for these
+    # endpoints.
+    # @return [Telnyx::Resources::EmailMessages]
+    attr_reader :email_messages
+
+    # Create, list, retrieve, update, delete, and render Liquid email templates.
+    # @return [Telnyx::Resources::EmailTemplates]
+    attr_reader :email_templates
+
+    # Account-wide conversation threads across every inbox, for agents operating many
+    # inboxes at once.
+    # @return [Telnyx::Resources::EmailThreads]
+    attr_reader :email_threads
+
+    # Named groups and group-scoped suppressions.
+    # @return [Telnyx::Resources::EmailUnsubscribeGroups]
+    attr_reader :email_unsubscribe_groups
+
+    # Validate email addresses synchronously or in asynchronous batches.
+    # @return [Telnyx::Resources::EmailValidations]
+    attr_reader :email_validations
+
+    # @return [Telnyx::Resources::Pricing]
+    attr_reader :pricing
+
     # @api private
     #
     # @return [Hash{String=>String}]
@@ -969,6 +1010,16 @@ module Telnyx
       @call_reasons = Telnyx::Resources::CallReasons.new(client: self)
       @dir = Telnyx::Resources::Dir.new(client: self)
       @infringement_claims = Telnyx::Resources::InfringementClaims.new(client: self)
+      @email_blocks = Telnyx::Resources::EmailBlocks.new(client: self)
+      @email_domains = Telnyx::Resources::EmailDomains.new(client: self)
+      @email_events = Telnyx::Resources::EmailEvents.new(client: self)
+      @email_inboxes = Telnyx::Resources::EmailInboxes.new(client: self)
+      @email_messages = Telnyx::Resources::EmailMessages.new(client: self)
+      @email_templates = Telnyx::Resources::EmailTemplates.new(client: self)
+      @email_threads = Telnyx::Resources::EmailThreads.new(client: self)
+      @email_unsubscribe_groups = Telnyx::Resources::EmailUnsubscribeGroups.new(client: self)
+      @email_validations = Telnyx::Resources::EmailValidations.new(client: self)
+      @pricing = Telnyx::Resources::Pricing.new(client: self)
     end
   end
 end

data/lib/telnyx/models/ai/anthropic/v1_messages_params.rb

@@ -71,7 +71,9 @@ module Telnyx
           optional :metadata, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
 
           # @!attribute service_tier
-          #   Service tier for the request.
+          #   The service tier to use for this request. Supported values vary by model; use
+          #   the Telnyx models endpoint and inspect the model's `service_tiers` field. If
+          #   omitted, Telnyx-hosted models use `default`.
           #
           #   @return [String, nil]
           optional :service_tier, String
@@ -162,7 +164,7 @@ module Telnyx
           #
           #   @param metadata [Hash{Symbol=>Object}] An object describing metadata about the request.
           #
-          #   @param service_tier [String] Service tier for the request.
+          #   @param service_tier [String] The service tier to use for this request. Supported values vary by model; use th
           #
           #   @param stop_sequences [Array<String>] Custom sequences that will cause the model to stop generating.
           #

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

@@ -31,7 +31,20 @@ module Telnyx
         #   @return [String, nil]
         optional :name, String
 
-        # @!method initialize(assistant_id:, content:, conversation_id:, name: nil, request_options: {})
+        # @!attribute stream
+        #   When true, the response is streamed as Server-Sent Events (`text/event-stream`):
+        #   `delta` events carry content fragments as they are generated, a final `done`
+        #   event carries the full content plus `whatsapp_template`, and a terminal `error`
+        #   event reports failures that happen after streaming started. When false
+        #   (default), the response is a single JSON object.
+        #
+        #   @return [Boolean, nil]
+        optional :stream, Telnyx::Internal::Type::Boolean
+
+        # @!method initialize(assistant_id:, content:, conversation_id:, name: nil, stream: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::AI::AssistantChatParams} for more details.
+        #
         #   @param assistant_id [String]
         #
         #   @param content [String] The message content sent by the client to the assistant
@@ -40,6 +53,8 @@ module Telnyx
         #
         #   @param name [String] The optional display name of the user sending the message
         #
+        #   @param stream [Boolean] When true, the response is streamed as Server-Sent Events (`text/event-stream`):
+        #
         #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
       end
     end

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

@@ -128,6 +128,14 @@ module Telnyx
         #   @return [Integer, nil]
         optional :seed, Integer
 
+        # @!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
+        #   omitted, Telnyx-hosted models use `default`.
+        #
+        #   @return [String, nil]
+        optional :service_tier, String
+
         # @!attribute stop
         #   Up to 4 sequences where the API will stop generating further tokens. The
         #   returned text will not contain the stop sequence.
@@ -187,7 +195,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, response_format: nil, seed: 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, 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, 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.
         #
@@ -227,6 +235,8 @@ module Telnyx
         #
         #   @param seed [Integer] If specified, the system will make a best effort to sample deterministically, su
         #
+        #   @param service_tier [String] The service tier to use for this request. Supported values vary by model; use `G
+        #
         #   @param stop [String, Array<String>] Up to 4 sequences where the API will stop generating further tokens. The returne
         #
         #   @param stream [Boolean] Whether or not to stream data-only server-sent events as they become available.

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

@@ -38,6 +38,14 @@ module Telnyx
         #   @return [String, nil]
         optional :model, String
 
+        # @!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
+        #   omitted, Telnyx-hosted models use `default`.
+        #
+        #   @return [String, nil]
+        optional :service_tier, String
+
         # @!attribute stream
         #   Set to `true` to stream Server-Sent Events, matching OpenAI's Responses
         #   streaming format.
@@ -45,7 +53,7 @@ module Telnyx
         #   @return [Boolean, nil]
         optional :stream, Telnyx::Internal::Type::Boolean
 
-        # @!method initialize(conversation: nil, input: nil, instructions: nil, model: nil, stream: nil, request_options: {})
+        # @!method initialize(conversation: nil, input: nil, instructions: nil, model: nil, service_tier: nil, stream: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::OpenAICreateResponseParams} for more details.
         #
@@ -57,6 +65,8 @@ module Telnyx
         #
         #   @param model [String] Model identifier to use for the response, for example `zai-org/GLM-5.1-FP8` or a
         #
+        #   @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}]

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

@@ -18,7 +18,13 @@ module Telnyx
         #   hint), `multi` (no language hint), and language-specific hints `en`, `es`, `fr`,
         #   `de`, `hi`, `ru`, `pt`, `ja`, `it`, and `nl`. For `soniox/stt-rt-v4`, `auto`
         #   omits the language hint and lets Soniox auto-detect; ISO 639-1 codes (e.g. `en`,
-        #   `es`) bias detection toward that language.
+        #   `es`) bias detection toward that language. For `humain/realtime`, supported
+        #   values are `ar`, `en`, `codeswitch` (Arabic/English code-switching), and `auto`
+        #   (resolves server-side to code-switching). Unlike other models, `humain/realtime`
+        #   does not fall back to `auto` when `language` is omitted — omitting it applies
+        #   `en` instead. For `reson8/turns`, supported values are `auto` (or unset) for
+        #   automatic language detection, and the language codes `nl`, `en`, `fr`, `fy`,
+        #   `de`, `it`, `pl`, `pt`, `es`, and `sv` to fix the transcription language.
         #
         #   @return [String, nil]
         optional :language, String
@@ -38,6 +44,10 @@ module Telnyx
         #     detection and configurable endpointing.
         #   - `nvidia/parakeet-v3` is a multilingual transcription model with automatic
         #     language detection.
+        #   - `humain/realtime` is a streaming model with native Arabic and Arabic/English
+        #     code-switching support.
+        #   - `reson8/turns` is a turn-based streaming model covering 10 European languages
+        #     with automatic language detection.
         #
         #   @return [Symbol, Telnyx::Models::AI::TranscriptionSettings::Model, nil]
         optional :model, enum: -> { Telnyx::AI::TranscriptionSettings::Model }
@@ -82,6 +92,10 @@ module Telnyx
         #   detection and configurable endpointing.
         # - `nvidia/parakeet-v3` is a multilingual transcription model with automatic
         #   language detection.
+        # - `humain/realtime` is a streaming model with native Arabic and Arabic/English
+        #   code-switching support.
+        # - `reson8/turns` is a turn-based streaming model covering 10 European languages
+        #   with automatic language detection.
         #
         # @see Telnyx::Models::AI::TranscriptionSettings#model
         module Model
@@ -95,6 +109,8 @@ module Telnyx
           XAI_GROK_STT = :"xai/grok-stt"
           SONIOX_STT_RT_V4 = :"soniox/stt-rt-v4"
           NVIDIA_PARAKEET_V3 = :"nvidia/parakeet-v3"
+          HUMAIN_REALTIME = :"humain/realtime"
+          RESON8_TURNS = :"reson8/turns"
           DISTIL_WHISPER_DISTIL_LARGE_V2 = :"distil-whisper/distil-large-v2"
           OPENAI_WHISPER_LARGE_V3_TURBO = :"openai/whisper-large-v3-turbo"
 

data/lib/telnyx/models/attachment_request.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    class AttachmentRequest < Telnyx::Internal::Type::BaseModel
+      # @!attribute content
+      #   Attachment content, typically Base64-encoded. Defaults to empty string when
+      #   omitted.
+      #
+      #   @return [String, nil]
+      optional :content, String
+
+      # @!attribute content_id
+      #   MIME Content-ID used to reference an inline attachment.
+      #
+      #   @return [String, nil]
+      optional :content_id, String, nil?: true
+
+      # @!attribute content_type
+      #   MIME content type. Defaults to "application/octet-stream" when omitted.
+      #
+      #   @return [String, nil]
+      optional :content_type, String
+
+      # @!attribute disposition
+      #   MIME disposition (`attachment` or `inline`).
+      #
+      #   @return [String, nil]
+      optional :disposition, String
+
+      # @!attribute filename
+      #   Attachment filename. Defaults to "attachment" when omitted.
+      #
+      #   @return [String, nil]
+      optional :filename, String
+
+      # @!method initialize(content: nil, content_id: nil, content_type: nil, disposition: nil, filename: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::AttachmentRequest} for more details.
+      #
+      #   @param content [String] Attachment content, typically Base64-encoded. Defaults to empty string when omit
+      #
+      #   @param content_id [String, nil] MIME Content-ID used to reference an inline attachment.
+      #
+      #   @param content_type [String] MIME content type. Defaults to "application/octet-stream" when omitted.
+      #
+      #   @param disposition [String] MIME disposition (`attachment` or `inline`).
+      #
+      #   @param filename [String] Attachment filename. Defaults to "attachment" when omitted.
+    end
+  end
+end

data/lib/telnyx/models/call_assistant_request.rb

@@ -104,7 +104,12 @@ module Telnyx
       #   @return [Array<Telnyx::Models::BookAppointmentTool, Telnyx::Models::CheckAvailabilityTool, Telnyx::Models::AI::WebhookTool, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::TransferTool, Telnyx::Models::CallControlRetrievalTool>, nil]
       optional :tools, -> { Telnyx::Internal::Type::ArrayOf[union: Telnyx::CallAssistantRequest::Tool] }
 
-      # @!method initialize(id:, dynamic_variables: nil, external_llm: nil, fallback_config: nil, greeting: nil, instructions: nil, llm_api_key_ref: nil, mcp_servers: nil, model: nil, name: nil, observability_settings: nil, openai_api_key_ref: nil, tools: nil)
+      # @!attribute voice_settings
+      #
+      #   @return [Telnyx::Models::AI::VoiceSettings, nil]
+      optional :voice_settings, -> { Telnyx::AI::VoiceSettings }
+
+      # @!method initialize(id:, dynamic_variables: nil, external_llm: nil, fallback_config: nil, greeting: nil, instructions: nil, llm_api_key_ref: nil, mcp_servers: nil, model: nil, name: nil, observability_settings: nil, openai_api_key_ref: nil, tools: nil, voice_settings: nil)
       #   Some parameter documentations has been truncated, see
       #   {Telnyx::Models::CallAssistantRequest} for more details.
       #
@@ -137,6 +142,8 @@ module Telnyx
       #   @param openai_api_key_ref [String] Deprecated — use `llm_api_key_ref` instead. Integration secret identifier for th
       #
       #   @param tools [Array<Telnyx::Models::BookAppointmentTool, Telnyx::Models::CheckAvailabilityTool, Telnyx::Models::AI::WebhookTool, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::TransferTool, Telnyx::Models::CallControlRetrievalTool>] Inline tool definitions available to the assistant (webhook, retrieval, transfer
+      #
+      #   @param voice_settings [Telnyx::Models::AI::VoiceSettings]
 
       module DynamicVariable
         extend Telnyx::Internal::Type::Union

data/lib/telnyx/models/call_dial_params.rb

@@ -298,6 +298,17 @@ module Telnyx
       #   @return [Boolean, nil]
       optional :retry_on_timeout, Telnyx::Internal::Type::Boolean
 
+      # @!attribute route_to_mobile
+      #   When set to true, routes the call directly to the mobile device associated with
+      #   the destination Telnyx Mobile number, bypassing Inbound Calls Interception
+      #   configured in the Telnyx Portal under Mobile Numbers → select the number → Voice
+      #   → Call Interception. Use this when transferring an intercepted call to the
+      #   mobile device to prevent the call from being intercepted again. Defaults to
+      #   false.
+      #
+      #   @return [Boolean, nil]
+      optional :route_to_mobile, Telnyx::Internal::Type::Boolean
+
       # @!attribute send_digits_on_answer
       #   DTMF digits to send automatically after the called party answers. Useful for
       #   reaching an extension behind an IVR (e.g. `"200"` to dial extension 200 once the
@@ -496,7 +507,7 @@ module Telnyx
       #   @return [Symbol, Telnyx::Models::CallDialParams::WebhookURLsMethod, nil]
       optional :webhook_urls_method, enum: -> { Telnyx::CallDialParams::WebhookURLsMethod }
 
-      # @!method initialize(connection_id:, from:, to:, answering_machine_detection: nil, answering_machine_detection_config: nil, assistant: nil, audio_url: nil, billing_group_id: nil, bridge_intent: nil, bridge_on_answer: nil, client_state: nil, command_id: nil, conference_config: nil, conversation_relay_config: nil, custom_headers: nil, deepfake_detection: nil, dialogflow_config: nil, enable_dialogflow: nil, from_display_name: nil, link_to: nil, media_encryption: nil, media_name: nil, park_after_unbridge: nil, preferred_codecs: nil, prevent_double_bridge: nil, privacy: nil, record: nil, record_channels: nil, record_custom_file_name: nil, record_format: nil, record_max_length: nil, record_timeout_secs: nil, record_track: nil, record_trim: nil, retry_on_timeout: nil, send_digits_on_answer: nil, send_silence_when_idle: nil, sip_auth_password: nil, sip_auth_username: nil, sip_headers: nil, sip_region: nil, sip_transport_protocol: nil, sound_modifications: nil, stream_auth_token: nil, stream_bidirectional_codec: nil, stream_bidirectional_mode: nil, stream_bidirectional_sampling_rate: nil, stream_bidirectional_target_legs: nil, stream_codec: nil, stream_establish_before_call_originate: nil, stream_track: nil, stream_url: nil, supervise_call_control_id: nil, supervisor_role: nil, time_limit_secs: nil, timeout_secs: nil, transcription: nil, transcription_config: nil, webhook_retries_policies: nil, webhook_url: nil, webhook_url_method: nil, webhook_urls: nil, webhook_urls_method: nil, request_options: {})
+      # @!method initialize(connection_id:, from:, to:, answering_machine_detection: nil, answering_machine_detection_config: nil, assistant: nil, audio_url: nil, billing_group_id: nil, bridge_intent: nil, bridge_on_answer: nil, client_state: nil, command_id: nil, conference_config: nil, conversation_relay_config: nil, custom_headers: nil, deepfake_detection: nil, dialogflow_config: nil, enable_dialogflow: nil, from_display_name: nil, link_to: nil, media_encryption: nil, media_name: nil, park_after_unbridge: nil, preferred_codecs: nil, prevent_double_bridge: nil, privacy: nil, record: nil, record_channels: nil, record_custom_file_name: nil, record_format: nil, record_max_length: nil, record_timeout_secs: nil, record_track: nil, record_trim: nil, retry_on_timeout: nil, route_to_mobile: nil, send_digits_on_answer: nil, send_silence_when_idle: nil, sip_auth_password: nil, sip_auth_username: nil, sip_headers: nil, sip_region: nil, sip_transport_protocol: nil, sound_modifications: nil, stream_auth_token: nil, stream_bidirectional_codec: nil, stream_bidirectional_mode: nil, stream_bidirectional_sampling_rate: nil, stream_bidirectional_target_legs: nil, stream_codec: nil, stream_establish_before_call_originate: nil, stream_track: nil, stream_url: nil, supervise_call_control_id: nil, supervisor_role: nil, time_limit_secs: nil, timeout_secs: nil, transcription: nil, transcription_config: nil, webhook_retries_policies: nil, webhook_url: nil, webhook_url_method: nil, webhook_urls: nil, webhook_urls_method: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Telnyx::Models::CallDialParams} for more details.
       #
@@ -570,6 +581,8 @@ module Telnyx
       #
       #   @param retry_on_timeout [Boolean] Whether to keep trying the remaining routing paths (e.g. alternate providers/gat
       #
+      #   @param route_to_mobile [Boolean] When set to true, routes the call directly to the mobile device associated with
+      #
       #   @param send_digits_on_answer [String] DTMF digits to send automatically after the called party answers. Useful for rea
       #
       #   @param send_silence_when_idle [Boolean] Generate silence RTP packets when no transmission available.