telnyx 5.170.0 → 5.171.0

data/lib/telnyx/models/calls/action_start_ai_assistant_params.rb

@@ -14,9 +14,11 @@ module Telnyx
         required :call_control_id, String
 
         # @!attribute assistant
-        #   AI Assistant configuration. All fields except `id` are optional — the
-        #   assistant's stored configuration will be used as fallback for any omitted
-        #   fields.
+        #   AI Assistant configuration and per-call overrides. All fields except `id` are
+        #   optional. Omitted assistant fields use the stored configuration. Supplied
+        #   `voice_settings` and `transcription` objects replace their stored objects rather
+        #   than merging individual settings; include every setting you want to retain.
+        #   `dynamic_variables` are merged, with request values taking precedence.
         #
         #   @return [Telnyx::Models::CallAssistantRequest, nil]
         optional :assistant, -> { Telnyx::CallAssistantRequest }
@@ -87,7 +89,7 @@ module Telnyx
         #
         #   @param call_control_id [String]
         #
-        #   @param assistant [Telnyx::Models::CallAssistantRequest] AI Assistant configuration. All fields except `id` are optional — the assistant'
+        #   @param assistant [Telnyx::Models::CallAssistantRequest] AI Assistant configuration and per-call overrides. All fields except `id` are op
         #
         #   @param client_state [String] Use this field to add state to every subsequent webhook. It must be a valid Base
         #

data/lib/telnyx/models/calls/action_start_conversation_relay_params.rb

@@ -149,10 +149,13 @@ module Telnyx
         #   Engine-specific transcription settings for Conversation Relay. This accepts the
         #   same provider-specific options used by the Call Transcription Start command,
         #   such as `transcription_model`, without requiring the engine discriminator to be
-        #   repeated inside this object.
+        #   repeated inside this object. With Deepgram Flux (`deepgram/flux`),
+        #   `interim_results`, `eot_threshold` and `eager_eot_threshold` control the interim
+        #   prompts and the `eagerEndOfTurn` and `turnResumed` frames sent to your WebSocket
+        #   server.
         #
-        #   @return [Hash{Symbol=>Object}, nil]
-        optional :transcription_engine_config, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+        #   @return [Telnyx::Models::Calls::ConversationRelayTranscriptionEngineConfig, nil]
+        optional :transcription_engine_config, -> { Telnyx::Calls::ConversationRelayTranscriptionEngineConfig }
 
         # @!attribute tts_provider
         #   Text-to-speech provider. If omitted, Telnyx derives it from `voice` or
@@ -179,10 +182,10 @@ module Telnyx
         #     the `VoiceId` (e.g., `AWS.Polly.Joanna-Neural`). Check the
         #     [available voices](https://docs.aws.amazon.com/polly/latest/dg/available-voices.html)
         #     for compatibility.
-        #   - **Azure:** Use `Azure.<VoiceId>. (e.g. Azure.en-CA-ClaraNeural,
-        #     Azure.en-CA-LiamNeural, Azure.en-US-BrianMultilingualNeural,
-        #     Azure.en-US-Ava:DragonHDLatestNeural. For a complete list of voices, go to
-        #     [Azure Voice Gallery](https://speech.microsoft.com/portal/voicegallery).)
+        #   - **Azure:** Use `Azure.<VoiceId>` (e.g., `Azure.en-CA-ClaraNeural`,
+        #     `Azure.en-CA-LiamNeural`, `Azure.en-US-BrianMultilingualNeural`,
+        #     `Azure.en-US-Ava:DragonHDLatestNeural`). For a complete list of voices, go to
+        #     [Azure Voice Gallery](https://speech.microsoft.com/portal/voicegallery).
         #   - **ElevenLabs:** Use `ElevenLabs.<ModelId>.<VoiceId>` (e.g.,
         #     `ElevenLabs.BaseModel.John`). The `ModelId` part is optional. To use
         #     ElevenLabs, you must provide your ElevenLabs API key as an integration secret
@@ -261,7 +264,7 @@ module Telnyx
         #
         #   @param transcription_engine [Symbol, Telnyx::Models::Calls::ActionStartConversationRelayParams::TranscriptionEngine] Engine to use for speech recognition. Legacy values `A` - `Google`, `B` - `Telny
         #
-        #   @param transcription_engine_config [Hash{Symbol=>Object}] Engine-specific transcription settings for Conversation Relay. This accepts the
+        #   @param transcription_engine_config [Telnyx::Models::Calls::ConversationRelayTranscriptionEngineConfig] Engine-specific transcription settings for Conversation Relay. This accepts the
         #
         #   @param tts_provider [String] Text-to-speech provider. If omitted, Telnyx derives it from `voice` or `provider
         #

data/lib/telnyx/models/calls/action_transfer_params.rb

@@ -34,7 +34,16 @@ module Telnyx
         #   'greeting_end' or 'detect_words' is used and a 'machine' is detected, you will
         #   receive another 'call.machine.greeting.ended' webhook when the answering machine
         #   greeting ends with a beep or silence. If `detect_beep` is used, you will only
-        #   receive 'call.machine.greeting.ended' if a beep is detected.
+        #   receive 'call.machine.greeting.ended' if a beep is detected. If
+        #   `answering_machine_detection` is set to `premium_ios_call_screening_detection`,
+        #   Premium AMD runs with iOS Call Screening support: after an initial `machine`
+        #   result, Telnyx listens for the iOS call-screening prompt to end or for an Apple
+        #   Call Screening tone, sends `call.machine.premium.greeting.ended` with
+        #   `result=prompt_ended` or `call.machine.premium.call_screening.detected` with
+        #   `result=screening` respectively. When the Apple Call Screening tone is detected,
+        #   Premium AMD is restarted on the screened call and a
+        #   `call.machine.premium.detection.ended` webhook with the post-screening
+        #   classification follows.
         #
         #   @return [Symbol, Telnyx::Models::Calls::ActionTransferParams::AnsweringMachineDetection, nil]
         optional :answering_machine_detection,
@@ -44,7 +53,8 @@ module Telnyx
         #   Optional configuration parameters to modify 'answering_machine_detection'
         #   performance. Only `total_analysis_time_millis` and `greeting_duration_millis`
         #   parameters are applicable when `premium` is selected as
-        #   answering_machine_detection.
+        #   answering_machine_detection. `prompt_end_timeout_millis` is additionally
+        #   applicable when `premium_ios_call_screening_detection` is selected.
         #
         #   @return [Telnyx::Models::Calls::ActionTransferParams::AnsweringMachineDetectionConfig, nil]
         optional :answering_machine_detection_config,
@@ -443,11 +453,21 @@ module Telnyx
         # 'greeting_end' or 'detect_words' is used and a 'machine' is detected, you will
         # receive another 'call.machine.greeting.ended' webhook when the answering machine
         # greeting ends with a beep or silence. If `detect_beep` is used, you will only
-        # receive 'call.machine.greeting.ended' if a beep is detected.
+        # receive 'call.machine.greeting.ended' if a beep is detected. If
+        # `answering_machine_detection` is set to `premium_ios_call_screening_detection`,
+        # Premium AMD runs with iOS Call Screening support: after an initial `machine`
+        # result, Telnyx listens for the iOS call-screening prompt to end or for an Apple
+        # Call Screening tone, sends `call.machine.premium.greeting.ended` with
+        # `result=prompt_ended` or `call.machine.premium.call_screening.detected` with
+        # `result=screening` respectively. When the Apple Call Screening tone is detected,
+        # Premium AMD is restarted on the screened call and a
+        # `call.machine.premium.detection.ended` webhook with the post-screening
+        # classification follows.
         module AnsweringMachineDetection
           extend Telnyx::Internal::Type::Enum
 
           PREMIUM = :premium
+          PREMIUM_IOS_CALL_SCREENING_DETECTION = :premium_ios_call_screening_detection
           DETECT = :detect
           DETECT_BEEP = :detect_beep
           DETECT_WORDS = :detect_words
@@ -573,6 +593,15 @@ module Telnyx
           #   @return [Integer, nil]
           optional :maximum_word_length_millis, Integer
 
+          # @!attribute prompt_end_timeout_millis
+          #   Maximum time Telnyx waits, in milliseconds, for the iOS call-screening prompt to
+          #   end after Premium AMD initially detects a `machine`. Used when
+          #   `answering_machine_detection` is `premium_ios_call_screening_detection`.
+          #   Defaults to 5000 milliseconds.
+          #
+          #   @return [Integer, nil]
+          optional :prompt_end_timeout_millis, Integer
+
           # @!attribute silence_threshold
           #   Minimum noise threshold for any analysis.
           #
@@ -585,7 +614,7 @@ module Telnyx
           #   @return [Integer, nil]
           optional :total_analysis_time_millis, Integer
 
-          # @!method initialize(after_greeting_silence_millis: nil, beep_detection_profile: nil, beep_max_frequency_hz: nil, beep_min_frequency_hz: nil, beep_min_tone_duration_millis: nil, beep_spectral_confirmation: nil, beep_spectral_min_purity: nil, beep_spectral_reject_fax_cng: nil, beep_spectral_window_millis: nil, between_words_silence_millis: nil, greeting_duration_millis: nil, greeting_silence_duration_millis: nil, greeting_total_analysis_time_millis: nil, initial_silence_millis: nil, maximum_number_of_words: nil, maximum_word_length_millis: nil, silence_threshold: nil, total_analysis_time_millis: nil)
+          # @!method initialize(after_greeting_silence_millis: nil, beep_detection_profile: nil, beep_max_frequency_hz: nil, beep_min_frequency_hz: nil, beep_min_tone_duration_millis: nil, beep_spectral_confirmation: nil, beep_spectral_min_purity: nil, beep_spectral_reject_fax_cng: nil, beep_spectral_window_millis: nil, between_words_silence_millis: nil, greeting_duration_millis: nil, greeting_silence_duration_millis: nil, greeting_total_analysis_time_millis: nil, initial_silence_millis: nil, maximum_number_of_words: nil, maximum_word_length_millis: nil, prompt_end_timeout_millis: nil, silence_threshold: nil, total_analysis_time_millis: nil)
           #   Some parameter documentations has been truncated, see
           #   {Telnyx::Models::Calls::ActionTransferParams::AnsweringMachineDetectionConfig}
           #   for more details.
@@ -593,7 +622,8 @@ module Telnyx
           #   Optional configuration parameters to modify 'answering_machine_detection'
           #   performance. Only `total_analysis_time_millis` and `greeting_duration_millis`
           #   parameters are applicable when `premium` is selected as
-          #   answering_machine_detection.
+          #   answering_machine_detection. `prompt_end_timeout_millis` is additionally
+          #   applicable when `premium_ios_call_screening_detection` is selected.
           #
           #   @param after_greeting_silence_millis [Integer] Silence duration threshold after a greeting message or voice for it be considere
           #
@@ -627,6 +657,8 @@ module Telnyx
           #
           #   @param maximum_word_length_millis [Integer] If a single word lasts longer than this threshold, consider it a machine.
           #
+          #   @param prompt_end_timeout_millis [Integer] Maximum time Telnyx waits, in milliseconds, for the iOS call-screening prompt to
+          #
           #   @param silence_threshold [Integer] Minimum noise threshold for any analysis.
           #
           #   @param total_analysis_time_millis [Integer] Maximum timeout threshold for overall detection.

data/lib/telnyx/models/calls/conversation_relay_transcription_engine_config.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Calls
+      class ConversationRelayTranscriptionEngineConfig < Telnyx::Internal::Type::BaseModel
+        # @!attribute eager_eot_threshold
+        #   Deepgram Flux: confidence at which an `eagerEndOfTurn` frame is sent before the
+        #   final prompt, followed by `turnResumed` if the caller keeps talking. When
+        #   omitted, these frames are not sent.
+        #
+        #   @return [Float, nil]
+        optional :eager_eot_threshold, Float
+
+        # @!attribute eot_threshold
+        #   Deepgram Flux: confidence required to end the caller's turn.
+        #
+        #   @return [Float, nil]
+        optional :eot_threshold, Float
+
+        # @!attribute interim_results
+        #   Deepgram Flux: send interim transcripts as `prompt` frames with `last: false`.
+        #
+        #   @return [Boolean, nil]
+        optional :interim_results, Telnyx::Internal::Type::Boolean
+
+        # @!method initialize(eager_eot_threshold: nil, eot_threshold: nil, interim_results: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::Calls::ConversationRelayTranscriptionEngineConfig} for more
+        #   details.
+        #
+        #   Engine-specific transcription settings for Conversation Relay. This accepts the
+        #   same provider-specific options used by the Call Transcription Start command,
+        #   such as `transcription_model`, without requiring the engine discriminator to be
+        #   repeated inside this object. With Deepgram Flux (`deepgram/flux`),
+        #   `interim_results`, `eot_threshold` and `eager_eot_threshold` control the interim
+        #   prompts and the `eagerEndOfTurn` and `turnResumed` frames sent to your WebSocket
+        #   server.
+        #
+        #   @param eager_eot_threshold [Float] Deepgram Flux: confidence at which an `eagerEndOfTurn` frame is sent before the
+        #
+        #   @param eot_threshold [Float] Deepgram Flux: confidence required to end the caller's turn.
+        #
+        #   @param interim_results [Boolean] Deepgram Flux: send interim transcripts as `prompt` frames with `last: false`.
+      end
+    end
+  end
+end

data/lib/telnyx/models/calls/telnyx_voice_settings.rb

@@ -11,9 +11,10 @@ module Telnyx
         required :type, enum: -> { Telnyx::Calls::TelnyxVoiceSettings::Type }
 
         # @!attribute voice_speed
-        #   The voice speed to be used for the voice. The voice speed must be between 0.1
-        #   and 2.0. Default value is 1.0. Not supported for `Telnyx.Bayan.*` or
-        #   `Telnyx.Sukhan.*` voices.
+        #   The voice speed to be used for the voice. Telnyx `Ultra` voices accept values
+        #   from 0.6 to 1.5; values outside that range are rejected by the synthesis engine.
+        #   `Qwen3TTS` and `KokoroTTS` accept the field but do not apply it. Default value
+        #   is 1.0. Not supported for `Telnyx.Bayan.*` or `Telnyx.Sukhan.*` voices.
         #
         #   @return [Float, nil]
         optional :voice_speed, Float
@@ -24,7 +25,7 @@ module Telnyx
         #
         #   @param type [Symbol, Telnyx::Models::Calls::TelnyxVoiceSettings::Type] Voice settings provider type
         #
-        #   @param voice_speed [Float] The voice speed to be used for the voice. The voice speed must be between 0.1 an
+        #   @param voice_speed [Float] The voice speed to be used for the voice. Telnyx `Ultra` voices accept values fr
 
         # Voice settings provider type
         #

data/lib/telnyx/models/conversation_relay_embedded_config.rb

@@ -90,10 +90,13 @@ module Telnyx
       #   Engine-specific transcription settings for Conversation Relay. This accepts the
       #   same provider-specific options used by the Call Transcription Start command,
       #   such as `transcription_model`, without requiring the engine discriminator to be
-      #   repeated inside this object.
+      #   repeated inside this object. With Deepgram Flux (`deepgram/flux`),
+      #   `interim_results`, `eot_threshold` and `eager_eot_threshold` control the interim
+      #   prompts and the `eagerEndOfTurn` and `turnResumed` frames sent to your WebSocket
+      #   server.
       #
-      #   @return [Hash{Symbol=>Object}, nil]
-      optional :transcription_engine_config, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+      #   @return [Telnyx::Models::Calls::ConversationRelayTranscriptionEngineConfig, nil]
+      optional :transcription_engine_config, -> { Telnyx::Calls::ConversationRelayTranscriptionEngineConfig }
 
       # @!attribute tts_provider
       #   Text-to-speech provider. If omitted, Telnyx derives it from `voice` or
@@ -113,10 +116,10 @@ module Telnyx
       #     the `VoiceId` (e.g., `AWS.Polly.Joanna-Neural`). Check the
       #     [available voices](https://docs.aws.amazon.com/polly/latest/dg/available-voices.html)
       #     for compatibility.
-      #   - **Azure:** Use `Azure.<VoiceId>. (e.g. Azure.en-CA-ClaraNeural,
-      #     Azure.en-CA-LiamNeural, Azure.en-US-BrianMultilingualNeural,
-      #     Azure.en-US-Ava:DragonHDLatestNeural. For a complete list of voices, go to
-      #     [Azure Voice Gallery](https://speech.microsoft.com/portal/voicegallery).)
+      #   - **Azure:** Use `Azure.<VoiceId>` (e.g., `Azure.en-CA-ClaraNeural`,
+      #     `Azure.en-CA-LiamNeural`, `Azure.en-US-BrianMultilingualNeural`,
+      #     `Azure.en-US-Ava:DragonHDLatestNeural`). For a complete list of voices, go to
+      #     [Azure Voice Gallery](https://speech.microsoft.com/portal/voicegallery).
       #   - **ElevenLabs:** Use `ElevenLabs.<ModelId>.<VoiceId>` (e.g.,
       #     `ElevenLabs.BaseModel.John`). The `ModelId` part is optional. To use
       #     ElevenLabs, you must provide your ElevenLabs API key as an integration secret
@@ -188,7 +191,7 @@ module Telnyx
       #
       #   @param transcription_engine [Symbol, Telnyx::Models::ConversationRelayEmbeddedConfig::TranscriptionEngine] Engine to use for speech recognition. Legacy values `A` - `Google`, `B` - `Telny
       #
-      #   @param transcription_engine_config [Hash{Symbol=>Object}] Engine-specific transcription settings for Conversation Relay. This accepts the
+      #   @param transcription_engine_config [Telnyx::Models::Calls::ConversationRelayTranscriptionEngineConfig] Engine-specific transcription settings for Conversation Relay. This accepts the
       #
       #   @param tts_provider [String] Text-to-speech provider. If omitted, Telnyx derives it from `voice` or `provider
       #

data/lib/telnyx/models/conversation_relay_language.rb

@@ -30,10 +30,13 @@ module Telnyx
       #   Engine-specific transcription settings for Conversation Relay. This accepts the
       #   same provider-specific options used by the Call Transcription Start command,
       #   such as `transcription_model`, without requiring the engine discriminator to be
-      #   repeated inside this object.
+      #   repeated inside this object. With Deepgram Flux (`deepgram/flux`),
+      #   `interim_results`, `eot_threshold` and `eager_eot_threshold` control the interim
+      #   prompts and the `eagerEndOfTurn` and `turnResumed` frames sent to your WebSocket
+      #   server.
       #
-      #   @return [Hash{Symbol=>Object}, nil]
-      optional :transcription_engine_config, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+      #   @return [Telnyx::Models::Calls::ConversationRelayTranscriptionEngineConfig, nil]
+      optional :transcription_engine_config, -> { Telnyx::Calls::ConversationRelayTranscriptionEngineConfig }
 
       # @!attribute transcription_provider
       #   Conversation Relay transcription provider name. Prefer `transcription_engine`
@@ -73,7 +76,7 @@ module Telnyx
       #
       #   @param transcription_engine [Symbol, Telnyx::Models::ConversationRelayLanguage::TranscriptionEngine] Engine to use for speech recognition. Legacy values `A` - `Google`, `B` - `Telny
       #
-      #   @param transcription_engine_config [Hash{Symbol=>Object}] Engine-specific transcription settings for Conversation Relay. This accepts the
+      #   @param transcription_engine_config [Telnyx::Models::Calls::ConversationRelayTranscriptionEngineConfig] Engine-specific transcription settings for Conversation Relay. This accepts the
       #
       #   @param transcription_provider [String] Conversation Relay transcription provider name. Prefer `transcription_engine` wh
       #

data/lib/telnyx/models/dir/phone_number_list_params.rb

@@ -25,13 +25,7 @@ module Telnyx
         #   @return [Integer, nil]
         optional :page_size, Integer
 
-        # @!attribute status
-        #   Filter by phone-number status.
-        #
-        #   @return [Symbol, Telnyx::Models::Dir::DirPhoneNumberStatus, nil]
-        optional :status, enum: -> { Telnyx::Dir::DirPhoneNumberStatus }
-
-        # @!method initialize(dir_id:, page_number: nil, page_size: nil, status: nil, request_options: {})
+        # @!method initialize(dir_id:, page_number: nil, page_size: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::Dir::PhoneNumberListParams} for more details.
         #
@@ -41,8 +35,6 @@ module Telnyx
         #
         #   @param page_size [Integer] Items per page. Maximum 250; values above are clamped to 250.
         #
-        #   @param status [Symbol, Telnyx::Models::Dir::DirPhoneNumberStatus] Filter by phone-number status.
-        #
         #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
       end
     end

data/lib/telnyx/models/dir/phone_number_remove_params.rb

@@ -14,13 +14,20 @@ module Telnyx
         required :dir_id, String
 
         # @!attribute phone_numbers
+        #   The phone numbers to remove from this brand, in E.164 format, up to 100 per
+        #   request. They must currently be attached to this brand.
         #
         #   @return [Array<String>]
         required :phone_numbers, Telnyx::Internal::Type::ArrayOf[String]
 
         # @!method initialize(dir_id:, phone_numbers:, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::Dir::PhoneNumberRemoveParams} for more details.
+        #
         #   @param dir_id [String]
-        #   @param phone_numbers [Array<String>]
+        #
+        #   @param phone_numbers [Array<String>] The phone numbers to remove from this brand, in E.164 format, up to 100 per requ
+        #
         #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
       end
     end

data/lib/telnyx/models/dir/reference_update_params.rb

@@ -24,31 +24,33 @@ module Telnyx
         required :slot, Integer
 
         # @!attribute email
-        #   Reference contact email address.
+        #   The reference's email address. We email them scheduling and dial-in instructions
+        #   before we call, so use an address they check.
         #
         #   @return [String, nil]
         optional :email, String
 
         # @!attribute full_name
-        #   Full name of the reference contact.
+        #   The full name of the person we should contact as your reference.
         #
         #   @return [String, nil]
         optional :full_name, String
 
         # @!attribute job_title
-        #   Job title of the reference contact.
+        #   The reference contact's job title, for example CFO or Owner.
         #
         #   @return [String, nil]
         optional :job_title, String, nil?: true
 
         # @!attribute organization
-        #   Organization the reference contact belongs to.
+        #   The name of the organization the reference contact works for.
         #
         #   @return [String, nil]
         optional :organization, String, nil?: true
 
         # @!attribute phone_e164
-        #   Reference phone number in E.164 format.
+        #   The reference's phone number in E.164 format, for example +14155550123. We call
+        #   this number during their local business hours.
         #
         #   @return [String, nil]
         optional :phone_e164, String
@@ -60,31 +62,35 @@ module Telnyx
         optional :relationship_to_registrant, String, nil?: true
 
         # @!attribute timezone
-        #   IANA timezone id for the reference.
+        #   The reference's IANA time zone, for example America/New_York. We only call
+        #   during their local 8am to 9pm hours, which is why we need it.
         #
         #   @return [String, nil]
         optional :timezone, String
 
         # @!method initialize(dir_id:, ref_type:, slot:, email: nil, full_name: nil, job_title: nil, organization: nil, phone_e164: nil, relationship_to_registrant: nil, timezone: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::Dir::ReferenceUpdateParams} for more details.
+        #
         #   @param dir_id [String]
         #
         #   @param ref_type [Symbol, Telnyx::Models::Dir::ReferenceUpdateParams::RefType]
         #
         #   @param slot [Integer]
         #
-        #   @param email [String] Reference contact email address.
+        #   @param email [String] The reference's email address. We email them scheduling and dial-in instructions
         #
-        #   @param full_name [String] Full name of the reference contact.
+        #   @param full_name [String] The full name of the person we should contact as your reference.
         #
-        #   @param job_title [String, nil] Job title of the reference contact.
+        #   @param job_title [String, nil] The reference contact's job title, for example CFO or Owner.
         #
-        #   @param organization [String, nil] Organization the reference contact belongs to.
+        #   @param organization [String, nil] The name of the organization the reference contact works for.
         #
-        #   @param phone_e164 [String] Reference phone number in E.164 format.
+        #   @param phone_e164 [String] The reference's phone number in E.164 format, for example +14155550123. We call
         #
         #   @param relationship_to_registrant [String, nil] How the reference contact is related to the registering business.
         #
-        #   @param timezone [String] IANA timezone id for the reference.
+        #   @param timezone [String] The reference's IANA time zone, for example America/New_York. We only call durin
         #
         #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
 

data/lib/telnyx/models/dir.rb

@@ -83,10 +83,21 @@ module Telnyx
       #   - `infringement_claimed` - a trademark/impersonation claim is open against this
       #     DIR.
       #   - `permanently_rejected` - terminal; cannot be resubmitted.
+      #   - `delete_requested` - you have requested deletion; the DIR still exists and
+      #     Telnyx is completing the removal (de-registration and cleanup). A verified DIR
+      #     keeps serving its branded identity, and keeps billing, until the removal
+      #     finishes.
       #
       #   @return [Symbol, Telnyx::Models::DirStatus, nil]
       optional :status, enum: -> { Telnyx::DirStatus }
 
+      # @!attribute webhook_url
+      #   `https://` URL that receives webhook notifications for this DIR's
+      #   compliance-review outcomes. `null` when not subscribed.
+      #
+      #   @return [String, nil]
+      optional :webhook_url, String, nil?: true
+
       response_only do
         # @!attribute id
         #
@@ -98,6 +109,13 @@ module Telnyx
         #   @return [Time, nil]
         optional :created_at, Time
 
+        # @!attribute delete_requested_at
+        #   When deletion was requested. Set once the DIR enters `delete_requested`; `null`
+        #   otherwise.
+        #
+        #   @return [Time, nil]
+        optional :delete_requested_at, Time, nil?: true
+
         # @!attribute expiring_at
         #
         #   @return [Time, nil]
@@ -124,7 +142,7 @@ module Telnyx
         optional :verified_at, Time, nil?: true
       end
 
-      # @!method initialize(id: nil, authorizer_email: nil, authorizer_name: nil, call_reasons: nil, certify_brand_is_accurate: nil, certify_ip_ownership: nil, certify_no_shaft_content: nil, created_at: nil, display_name: nil, documents: nil, enterprise_id: nil, expiring_at: nil, logo_url: nil, rejected_at: nil, rejection_reasons: nil, reselling: nil, status: nil, submitted_at: nil, updated_at: nil, verified_at: nil)
+      # @!method initialize(id: nil, authorizer_email: nil, authorizer_name: nil, call_reasons: nil, certify_brand_is_accurate: nil, certify_ip_ownership: nil, certify_no_shaft_content: nil, created_at: nil, delete_requested_at: nil, display_name: nil, documents: nil, enterprise_id: nil, expiring_at: nil, logo_url: nil, rejected_at: nil, rejection_reasons: nil, reselling: nil, status: nil, submitted_at: nil, updated_at: nil, verified_at: nil, webhook_url: nil)
       #   Some parameter documentations has been truncated, see {Telnyx::Models::DirAPI}
       #   for more details.
       #
@@ -144,6 +162,8 @@ module Telnyx
       #
       #   @param created_at [Time]
       #
+      #   @param delete_requested_at [Time, nil] When deletion was requested. Set once the DIR enters `delete_requested`; `null`
+      #
       #   @param display_name [String]
       #
       #   @param documents [Array<Telnyx::Models::Document>, nil]
@@ -167,6 +187,8 @@ module Telnyx
       #   @param updated_at [Time]
       #
       #   @param verified_at [Time, nil]
+      #
+      #   @param webhook_url [String, nil] `https://` URL that receives webhook notifications for this DIR's compliance-rev
 
       class CallReason < Telnyx::Internal::Type::BaseModel
         # @!attribute reason

data/lib/telnyx/models/dir_bpo_loa_params.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    # @see Telnyx::Resources::Dir#bpo_loa
+    class DirBpoLoaParams < Telnyx::Internal::Type::BaseModel
+      extend Telnyx::Internal::Type::RequestParameters::Converter
+      include Telnyx::Internal::Type::RequestParameters
+
+      # @!attribute dir_id
+      #
+      #   @return [String]
+      required :dir_id, String
+
+      # @!attribute bpo_enterprise_id
+      #   The approved BPO enterprise the Brand Owner is authorizing. Must be a BPO
+      #   account on the caller's organization that has already been approved.
+      #
+      #   @return [String]
+      required :bpo_enterprise_id, String
+
+      # @!attribute signature
+      #   Optional. When provided the rendered PDF embeds the signature image, printed
+      #   name, and signed-at date. When absent the PDF is returned unsigned so the Brand
+      #   Owner can sign externally and the BPO can upload it via the Documents API.
+      #
+      #   @return [Telnyx::Models::SignaturePayload, nil]
+      optional :signature, -> { Telnyx::SignaturePayload }
+
+      # @!method initialize(dir_id:, bpo_enterprise_id:, signature: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::DirBpoLoaParams} for more details.
+      #
+      #   @param dir_id [String]
+      #
+      #   @param bpo_enterprise_id [String] The approved BPO enterprise the Brand Owner is authorizing. Must be a BPO accoun
+      #
+      #   @param signature [Telnyx::Models::SignaturePayload] Optional. When provided the rendered PDF embeds the signature image, printed nam
+      #
+      #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/telnyx/models/dir_delete_response.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    # @see Telnyx::Resources::Dir#delete
+    class DirDeleteResponse < Telnyx::Internal::Type::BaseModel
+      # @!attribute data
+      #
+      #   @return [Telnyx::Models::DirDeleteResponse::Data]
+      required :data, -> { Telnyx::Models::DirDeleteResponse::Data }
+
+      # @!method initialize(data:)
+      #   @param data [Telnyx::Models::DirDeleteResponse::Data]
+
+      # @see Telnyx::Models::DirDeleteResponse#data
+      class Data < Telnyx::Internal::Type::BaseModel
+        # @!attribute id
+        #   Id of the DIR whose deletion was requested.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute status
+        #   Always `delete_requested`: the DIR has been queued for removal, not yet removed.
+        #
+        #   @return [Symbol, Telnyx::Models::DirDeleteResponse::Data::Status]
+        required :status, enum: -> { Telnyx::Models::DirDeleteResponse::Data::Status }
+
+        # @!method initialize(id:, status:)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::DirDeleteResponse::Data} for more details.
+        #
+        #   @param id [String] Id of the DIR whose deletion was requested.
+        #
+        #   @param status [Symbol, Telnyx::Models::DirDeleteResponse::Data::Status] Always `delete_requested`: the DIR has been queued for removal, not yet removed.
+
+        # Always `delete_requested`: the DIR has been queued for removal, not yet removed.
+        #
+        # @see Telnyx::Models::DirDeleteResponse::Data#status
+        module Status
+          extend Telnyx::Internal::Type::Enum
+
+          DELETE_REQUESTED = :delete_requested
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end