telnyx 5.68.2 → 5.70.0

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

@@ -43,6 +43,7 @@ module Telnyx
             insight_settings: Telnyx::AI::InsightSettings::OrHash,
             llm_api_key_ref: String,
             messaging_settings: Telnyx::AI::MessagingSettings::OrHash,
+            observability_settings: Telnyx::AI::ObservabilityReq::OrHash,
             privacy_settings: Telnyx::AI::PrivacySettings::OrHash,
             telephony_settings: Telnyx::AI::TelephonySettings::OrHash,
             tool_ids: T::Array[String],
@@ -100,6 +101,7 @@ module Telnyx
           # work with this integration.
           llm_api_key_ref: nil,
           messaging_settings: nil,
+          observability_settings: nil,
           privacy_settings: nil,
           telephony_settings: nil,
           tool_ids: nil,
@@ -150,6 +152,7 @@ module Telnyx
             messaging_settings: Telnyx::AI::MessagingSettings::OrHash,
             model: String,
             name: String,
+            observability_settings: Telnyx::AI::ObservabilityReq::OrHash,
             privacy_settings: Telnyx::AI::PrivacySettings::OrHash,
             promote_to_main: T::Boolean,
             telephony_settings: Telnyx::AI::TelephonySettings::OrHash,
@@ -209,6 +212,7 @@ module Telnyx
           # to see all of your available models,
           model: nil,
           name: nil,
+          observability_settings: nil,
           privacy_settings: nil,
           # Indicates whether the assistant should be promoted to the main version. Defaults
           # to true.

data/rbi/telnyx/resources/calls/actions.rbi

@@ -1963,6 +1963,7 @@ module Telnyx
             mute_dtmf: Telnyx::Calls::ActionTransferParams::MuteDtmf::OrSymbol,
             park_after_unbridge: String,
             preferred_codecs: String,
+            privacy: Telnyx::Calls::ActionTransferParams::Privacy::OrSymbol,
             record: Telnyx::Calls::ActionTransferParams::Record::OrSymbol,
             record_channels:
               Telnyx::Calls::ActionTransferParams::RecordChannels::OrSymbol,
@@ -2058,6 +2059,10 @@ module Telnyx
           # call. The codecs supported are `G722`, `PCMU`, `PCMA`, `G729`, `OPUS`, `VP8`,
           # `H264`, `AMR-WB`.
           preferred_codecs: nil,
+          # Indicates the privacy level to be used for the call. When set to `id`, caller ID
+          # information (name and number) will be hidden from the called party. When set to
+          # `none` or omitted, caller ID will be shown normally.
+          privacy: nil,
           # Start recording automatically after an event. Disabled by default.
           record: nil,
           # Defines which channel should be recorded ('single' or 'dual') when `record` is

data/rbi/telnyx/resources/calls.rbi

@@ -53,6 +53,7 @@ module Telnyx
           park_after_unbridge: String,
           preferred_codecs: String,
           prevent_double_bridge: T::Boolean,
+          privacy: Telnyx::CallDialParams::Privacy::OrSymbol,
           record: Telnyx::CallDialParams::Record::OrSymbol,
           record_channels: Telnyx::CallDialParams::RecordChannels::OrSymbol,
           record_custom_file_name: String,
@@ -177,6 +178,10 @@ module Telnyx
         # Prevents bridging and hangs up the call if the target is already bridged.
         # Disabled by default.
         prevent_double_bridge: nil,
+        # Indicates the privacy level to be used for the call. When set to `id`, caller ID
+        # information (name and number) will be hidden from the called party. When set to
+        # `none` or omitted, caller ID will be shown normally.
+        privacy: nil,
         # Start recording automatically after an event. Disabled by default.
         record: nil,
         # Defines which channel should be recorded ('single' or 'dual') when `record` is

data/rbi/telnyx/resources/enterprises/reputation/numbers.rbi

@@ -7,39 +7,6 @@ module Telnyx
         # Associate phone numbers with an enterprise for reputation monitoring and
         # retrieve reputation scores
         class Numbers
-          # Associate one or more phone numbers with an enterprise for Number Reputation
-          # monitoring.
-          #
-          # **Validations:**
-          #
-          # - Phone numbers must be in E.164 format (e.g., `+16035551234`)
-          # - Phone numbers must be in-service and belong to your account (verified via
-          #   Warehouse)
-          # - Phone numbers must be US local numbers
-          # - Phone numbers cannot already be associated with any enterprise
-          #
-          # **Note:** This operation is atomic — if any number fails validation, the entire
-          # request fails.
-          #
-          # **Maximum:** 100 phone numbers per request.
-          sig do
-            params(
-              enterprise_id: String,
-              phone_numbers: T::Array[String],
-              request_options: Telnyx::RequestOptions::OrHash
-            ).returns(
-              Telnyx::Models::Enterprises::Reputation::NumberCreateResponse
-            )
-          end
-          def create(
-            # Unique identifier of the enterprise (UUID)
-            enterprise_id,
-            # List of phone numbers to associate for reputation monitoring (max 100)
-            phone_numbers:,
-            request_options: {}
-          )
-          end
-
           # Get detailed reputation data for a specific phone number associated with an
           # enterprise.
           #
@@ -111,6 +78,39 @@ module Telnyx
           )
           end
 
+          # Associate one or more phone numbers with an enterprise for Number Reputation
+          # monitoring.
+          #
+          # **Validations:**
+          #
+          # - Phone numbers must be in E.164 format (e.g., `+16035551234`)
+          # - Phone numbers must be in-service and belong to your account (verified via
+          #   Warehouse)
+          # - Phone numbers must be US local numbers
+          # - Phone numbers cannot already be associated with any enterprise
+          #
+          # **Note:** This operation is atomic — if any number fails validation, the entire
+          # request fails.
+          #
+          # **Maximum:** 100 phone numbers per request.
+          sig do
+            params(
+              enterprise_id: String,
+              phone_numbers: T::Array[String],
+              request_options: Telnyx::RequestOptions::OrHash
+            ).returns(
+              Telnyx::Models::Enterprises::Reputation::NumberAssociateResponse
+            )
+          end
+          def associate(
+            # Unique identifier of the enterprise (UUID)
+            enterprise_id,
+            # List of phone numbers to associate for reputation monitoring (max 100)
+            phone_numbers:,
+            request_options: {}
+          )
+          end
+
           # Remove a phone number from Number Reputation monitoring for an enterprise.
           #
           # The number will no longer be tracked and reputation data will no longer be
@@ -122,7 +122,7 @@ module Telnyx
               request_options: Telnyx::RequestOptions::OrHash
             ).void
           end
-          def delete(
+          def disassociate(
             # Phone number in E.164 format
             phone_number,
             # Unique identifier of the enterprise (UUID)

data/rbi/telnyx/resources/enterprises/reputation.rbi

@@ -11,6 +11,47 @@ module Telnyx
         sig { returns(Telnyx::Resources::Enterprises::Reputation::Numbers) }
         attr_reader :numbers
 
+        # Retrieve the current Number Reputation settings for an enterprise.
+        #
+        # Returns the enrollment status (`pending`, `approved`, `rejected`, `deleted`),
+        # check frequency, and any rejection reasons.
+        #
+        # Returns `404` if reputation has not been enabled for this enterprise.
+        sig do
+          params(
+            enterprise_id: String,
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(Telnyx::Models::Enterprises::ReputationRetrieveResponse)
+        end
+        def retrieve(
+          # Unique identifier of the enterprise (UUID)
+          enterprise_id,
+          request_options: {}
+        )
+        end
+
+        # Disable Number Reputation for an enterprise.
+        #
+        # This will:
+        #
+        # - Delete the reputation settings record
+        # - Log the deletion for audit purposes
+        # - Stop all future automated reputation checks
+        #
+        # **Note:** Can only be performed on `approved` reputation settings.
+        sig do
+          params(
+            enterprise_id: String,
+            request_options: Telnyx::RequestOptions::OrHash
+          ).void
+        end
+        def disable(
+          # Unique identifier of the enterprise (UUID)
+          enterprise_id,
+          request_options: {}
+        )
+        end
+
         # Enable Number Reputation service for an enterprise.
         #
         # **Requirements:**
@@ -41,11 +82,11 @@ module Telnyx
             enterprise_id: String,
             loa_document_id: String,
             check_frequency:
-              Telnyx::Enterprises::ReputationCreateParams::CheckFrequency::OrSymbol,
+              Telnyx::Enterprises::ReputationEnableParams::CheckFrequency::OrSymbol,
             request_options: Telnyx::RequestOptions::OrHash
-          ).returns(Telnyx::Models::Enterprises::ReputationCreateResponse)
+          ).returns(Telnyx::Models::Enterprises::ReputationEnableResponse)
         end
-        def create(
+        def enable(
           # Unique identifier of the enterprise (UUID)
           enterprise_id,
           # ID of the signed Letter of Authorization (LOA) document uploaded to the document
@@ -57,47 +98,6 @@ module Telnyx
         )
         end
 
-        # Retrieve the current Number Reputation settings for an enterprise.
-        #
-        # Returns the enrollment status (`pending`, `approved`, `rejected`, `deleted`),
-        # check frequency, and any rejection reasons.
-        #
-        # Returns `404` if reputation has not been enabled for this enterprise.
-        sig do
-          params(
-            enterprise_id: String,
-            request_options: Telnyx::RequestOptions::OrHash
-          ).returns(Telnyx::Models::Enterprises::ReputationListResponse)
-        end
-        def list(
-          # Unique identifier of the enterprise (UUID)
-          enterprise_id,
-          request_options: {}
-        )
-        end
-
-        # Disable Number Reputation for an enterprise.
-        #
-        # This will:
-        #
-        # - Delete the reputation settings record
-        # - Log the deletion for audit purposes
-        # - Stop all future automated reputation checks
-        #
-        # **Note:** Can only be performed on `approved` reputation settings.
-        sig do
-          params(
-            enterprise_id: String,
-            request_options: Telnyx::RequestOptions::OrHash
-          ).void
-        end
-        def delete_all(
-          # Unique identifier of the enterprise (UUID)
-          enterprise_id,
-          request_options: {}
-        )
-        end
-
         # Update how often reputation data is automatically refreshed.
         #
         # **Note:** The enterprise must have `approved` reputation settings. Updating

data/rbi/telnyx/resources/pronunciation_dicts.rbi

@@ -0,0 +1,131 @@
+# typed: strong
+
+module Telnyx
+  module Resources
+    # Manage pronunciation dictionaries for text-to-speech synthesis. Dictionaries
+    # contain alias items (text replacement) and phoneme items (IPA pronunciation
+    # notation) that control how specific words are spoken.
+    class PronunciationDicts
+      # Create a new pronunciation dictionary for the authenticated organization. Each
+      # dictionary contains a list of items that control how specific words are spoken.
+      # Items can be alias type (text replacement) or phoneme type (IPA pronunciation
+      # notation).
+      #
+      # As an alternative to providing items directly as JSON, you can upload a
+      # dictionary file (PLS/XML or plain text format, max 1MB) using
+      # multipart/form-data. PLS files use the standard W3C Pronunciation Lexicon
+      # Specification XML format. Text files use a line-based format: `word=alias` for
+      # aliases, `word:/phoneme/` for IPA phonemes.
+      #
+      # Limits:
+      #
+      # - Maximum 50 dictionaries per organization
+      # - Maximum 100 items per dictionary
+      # - Text: max 200 characters
+      # - Alias/phoneme value: max 500 characters
+      # - File upload: max 1MB (1,048,576 bytes)
+      sig do
+        params(
+          items:
+            T::Array[
+              T.any(
+                Telnyx::PronunciationDictCreateParams::Item::Alias::OrHash,
+                Telnyx::PronunciationDictCreateParams::Item::Phoneme::OrHash
+              )
+            ],
+          name: String,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(Telnyx::Models::PronunciationDictCreateResponse)
+      end
+      def create(
+        # List of pronunciation items (alias or phoneme type). At least one item is
+        # required.
+        items:,
+        # Human-readable name. Must be unique within the organization.
+        name:,
+        request_options: {}
+      )
+      end
+
+      # Retrieve a single pronunciation dictionary by ID.
+      sig do
+        params(
+          id: String,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(Telnyx::Models::PronunciationDictRetrieveResponse)
+      end
+      def retrieve(
+        # The UUID of the pronunciation dictionary.
+        id,
+        request_options: {}
+      )
+      end
+
+      # Update the name and/or items of an existing pronunciation dictionary. Uses
+      # optimistic locking — if the dictionary was modified concurrently, the request
+      # returns 409 Conflict.
+      sig do
+        params(
+          id: String,
+          items:
+            T::Array[
+              T.any(
+                Telnyx::PronunciationDictUpdateParams::Item::Alias::OrHash,
+                Telnyx::PronunciationDictUpdateParams::Item::Phoneme::OrHash
+              )
+            ],
+          name: String,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(Telnyx::Models::PronunciationDictUpdateResponse)
+      end
+      def update(
+        # The UUID of the pronunciation dictionary.
+        id,
+        # Updated list of pronunciation items (alias or phoneme type).
+        items: nil,
+        # Updated dictionary name.
+        name: nil,
+        request_options: {}
+      )
+      end
+
+      # List all pronunciation dictionaries for the authenticated organization. Results
+      # are paginated using offset-based pagination.
+      sig do
+        params(
+          page_number: Integer,
+          page_size: Integer,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(
+          Telnyx::Internal::DefaultFlatPagination[
+            Telnyx::Models::PronunciationDictListResponse
+          ]
+        )
+      end
+      def list(
+        # Page number (1-based). Defaults to 1.
+        page_number: nil,
+        # Number of results per page. Defaults to 20, maximum 250.
+        page_size: nil,
+        request_options: {}
+      )
+      end
+
+      # Permanently delete a pronunciation dictionary.
+      sig do
+        params(id: String, request_options: Telnyx::RequestOptions::OrHash).void
+      end
+      def delete(
+        # The UUID of the pronunciation dictionary.
+        id,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: Telnyx::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/telnyx/resources/texml/accounts/calls.rbi

@@ -95,175 +95,19 @@ module Telnyx
           sig do
             params(
               account_sid: String,
-              application_sid: String,
-              from: String,
-              to: String,
-              async_amd: T::Boolean,
-              async_amd_status_callback: String,
-              async_amd_status_callback_method:
-                Telnyx::Texml::Accounts::CallCallsParams::AsyncAmdStatusCallbackMethod::OrSymbol,
-              caller_id: String,
-              cancel_playback_on_detect_message_end: T::Boolean,
-              cancel_playback_on_machine_detection: T::Boolean,
-              custom_headers:
-                T::Array[
-                  Telnyx::Texml::Accounts::CallCallsParams::CustomHeader::OrHash
-                ],
-              detection_mode:
-                Telnyx::Texml::Accounts::CallCallsParams::DetectionMode::OrSymbol,
-              fallback_url: String,
-              machine_detection:
-                Telnyx::Texml::Accounts::CallCallsParams::MachineDetection::OrSymbol,
-              machine_detection_silence_timeout: Integer,
-              machine_detection_speech_end_threshold: Integer,
-              machine_detection_speech_threshold: Integer,
-              machine_detection_timeout: Integer,
-              preferred_codecs: String,
-              record: T::Boolean,
-              recording_channels:
-                Telnyx::Texml::Accounts::CallCallsParams::RecordingChannels::OrSymbol,
-              recording_status_callback: String,
-              recording_status_callback_event: String,
-              recording_status_callback_method:
-                Telnyx::Texml::Accounts::CallCallsParams::RecordingStatusCallbackMethod::OrSymbol,
-              recording_timeout: Integer,
-              recording_track:
-                Telnyx::Texml::Accounts::CallCallsParams::RecordingTrack::OrSymbol,
-              send_recording_url: T::Boolean,
-              sip_auth_password: String,
-              sip_auth_username: String,
-              sip_region:
-                Telnyx::Texml::Accounts::CallCallsParams::SipRegion::OrSymbol,
-              status_callback: String,
-              status_callback_event:
-                Telnyx::Texml::Accounts::CallCallsParams::StatusCallbackEvent::OrSymbol,
-              status_callback_method:
-                Telnyx::Texml::Accounts::CallCallsParams::StatusCallbackMethod::OrSymbol,
-              supervise_call_sid: String,
-              supervising_role:
-                Telnyx::Texml::Accounts::CallCallsParams::SupervisingRole::OrSymbol,
-              texml: String,
-              time_limit: Integer,
-              timeout_seconds: Integer,
-              trim: Telnyx::Texml::Accounts::CallCallsParams::Trim::OrSymbol,
-              url: String,
-              url_method:
-                Telnyx::Texml::Accounts::CallCallsParams::URLMethod::OrSymbol,
+              body:
+                T.any(
+                  Telnyx::Texml::Accounts::CallCallsParams::Body::WithURL::OrHash,
+                  Telnyx::Texml::Accounts::CallCallsParams::Body::WithTeXml::OrHash,
+                  Telnyx::Texml::Accounts::CallCallsParams::Body::ApplicationDefault::OrHash
+                ),
               request_options: Telnyx::RequestOptions::OrHash
             ).returns(Telnyx::Models::Texml::Accounts::CallCallsResponse)
           end
           def calls(
             # The id of the account the resource belongs to.
             account_sid,
-            # The ID of the TeXML Application.
-            application_sid:,
-            # The phone number of the party that initiated the call. Phone numbers are
-            # formatted with a `+` and country code.
-            from:,
-            # The phone number of the called party. Phone numbers are formatted with a `+` and
-            # country code.
-            to:,
-            # Select whether to perform answering machine detection in the background. By
-            # default execution is blocked until Answering Machine Detection is completed.
-            async_amd: nil,
-            # URL destination for Telnyx to send AMD callback events to for the call.
-            async_amd_status_callback: nil,
-            # HTTP request type used for `AsyncAmdStatusCallback`. The default value is
-            # inherited from TeXML Application setting.
-            async_amd_status_callback_method: nil,
-            # To be used as the caller id name (SIP From Display Name) presented to the
-            # destination (`To` number). The string should have a maximum of 128 characters,
-            # containing only letters, numbers, spaces, and `-_~!.+` special characters. If
-            # ommited, the display name will be the same as the number in the `From` field.
-            caller_id: nil,
-            # Whether to cancel ongoing playback on `greeting ended` detection. Defaults to
-            # `true`.
-            cancel_playback_on_detect_message_end: nil,
-            # Whether to cancel ongoing playback on `machine` detection. Defaults to `true`.
-            cancel_playback_on_machine_detection: nil,
-            # Custom HTTP headers to be sent with the call. Each header should be an object
-            # with 'name' and 'value' properties.
-            custom_headers: nil,
-            # Allows you to chose between Premium and Standard detections.
-            detection_mode: nil,
-            # A failover URL for which Telnyx will retrieve the TeXML call instructions if the
-            # `Url` is not responding.
-            fallback_url: nil,
-            # Enables Answering Machine Detection.
-            machine_detection: nil,
-            # If initial silence duration is greater than this value, consider it a machine.
-            # Ignored when `premium` detection is used.
-            machine_detection_silence_timeout: nil,
-            # Silence duration threshold after a greeting message or voice for it be
-            # considered human. Ignored when `premium` detection is used.
-            machine_detection_speech_end_threshold: nil,
-            # Maximum threshold of a human greeting. If greeting longer than this value,
-            # considered machine. Ignored when `premium` detection is used.
-            machine_detection_speech_threshold: nil,
-            # Maximum timeout threshold in milliseconds for overall detection.
-            machine_detection_timeout: nil,
-            # The list of comma-separated codecs to be offered on a call.
-            preferred_codecs: nil,
-            # Whether to record the entire participant's call leg. Defaults to `false`.
-            record: nil,
-            # The number of channels in the final recording. Defaults to `mono`.
-            recording_channels: nil,
-            # The URL the recording callbacks will be sent to.
-            recording_status_callback: nil,
-            # The changes to the recording's state that should generate a call to
-            # `RecoridngStatusCallback`. Can be: `in-progress`, `completed` and `absent`.
-            # Separate multiple values with a space. Defaults to `completed`.
-            recording_status_callback_event: nil,
-            # HTTP request type used for `RecordingStatusCallback`. Defaults to `POST`.
-            recording_status_callback_method: nil,
-            # The number of seconds that Telnyx will wait for the recording to be stopped if
-            # silence is detected. The timer only starts when the speech is detected. Please
-            # note that the transcription is used to detect silence and the related charge
-            # will be applied. The minimum value is 0. The default value is 0 (infinite)
-            recording_timeout: nil,
-            # The audio track to record for the call. The default is `both`.
-            recording_track: nil,
-            # Whether to send RecordingUrl in webhooks.
-            send_recording_url: nil,
-            # The password to use for SIP authentication.
-            sip_auth_password: nil,
-            # The username to use for SIP authentication.
-            sip_auth_username: nil,
-            # Defines the SIP region to be used for the call.
-            sip_region: nil,
-            # URL destination for Telnyx to send status callback events to for the call.
-            status_callback: nil,
-            # The call events for which Telnyx should send a webhook. Multiple events can be
-            # defined when separated by a space.
-            status_callback_event: nil,
-            # HTTP request type used for `StatusCallback`.
-            status_callback_method: nil,
-            # The call control ID of the existing call to supervise. When provided, the
-            # created leg will be added to the specified call in supervising mode. Status
-            # callbacks and action callbacks will NOT be sent for the supervising leg.
-            supervise_call_sid: nil,
-            # The supervising role for the new leg. Determines the audio behavior: barge (hear
-            # both sides), whisper (only hear supervisor), monitor (hear both sides but
-            # supervisor muted). Default: barge
-            supervising_role: nil,
-            # TeXML to be used as instructions for the call. If provided, the call will
-            # execute these instructions instead of fetching from the Url.
-            texml: nil,
-            # The maximum duration of the call in seconds. The minimum value is 30 and the
-            # maximum value is 14400 (4 hours). Default is 14400 seconds.
-            time_limit: nil,
-            # The number of seconds to wait for the called party to answer the call before the
-            # call is canceled. The minimum value is 5 and the maximum value is 120. Default
-            # is 30 seconds.
-            timeout_seconds: nil,
-            # Whether to trim any leading and trailing silence from the recording. Defaults to
-            # `trim-silence`.
-            trim: nil,
-            # The URL from which Telnyx will retrieve the TeXML call instructions.
-            url: nil,
-            # HTTP request type used for `Url`. The default value is inherited from TeXML
-            # Application setting.
-            url_method: nil,
+            body:,
             request_options: {}
           )
           end