telnyx 5.104.0 → 5.105.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2154962c4e4f5afd97c711f82206b39e6850e15b9380af208f7b7ef3ae60fa7b
-  data.tar.gz: '068f80cd9166458d035233bd8a77428c6df724341d9fdaf58b4dc229fdc9e5f0'
+  metadata.gz: 00c56398477600183f977eeff58815a2cc7aaa8c9698ff8f56b59b27590bdd35
+  data.tar.gz: c2d9c2b3c47e12c4360a49835a7dcc46e68113a83b83d19ee2ae6ee27fc1b86e
 SHA512:
-  metadata.gz: d0a6a1b2d40ab8fc74e635912e6b9e8399ded26087a7c3fd7615257466c62846545e5d9eb03d49628fbce130382432d34cc64e636bafe9a318ba00a0f7effc58
-  data.tar.gz: 962b77ba9d3e53c837a067298b335e291d4dba926eff6d3b4b89e5961bb400582363a546e9bed4d90489cb9a714abb84cfdc7845be01e9e933a036d4b9e4b4d1
+  metadata.gz: fce247576924b863af47b999bc829f893d9fd60dfc2678b6589eb6ae54f61ba447c1575516d324e8cdc2ff348bbb38be6e101ec74caa5f4d170f3b678d7d4a7d
+  data.tar.gz: 5a26d164a5e24c72e4d6d83e18ad6a0339ee98d3e5c09379021a24203130c4e5267cdf308030271005e02e3f6465e6213a3d13bdcbb39b80e2bf660ba6d3702d

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 5.105.0 (2026-05-08)
+
+Full Changelog: [v5.104.0...v5.105.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.104.0...v5.105.0)
+
+### Features
+
+* Document per-endpoint media encryption for call control ([3423cf7](https://github.com/team-telnyx/telnyx-ruby/commit/3423cf75cd3f3102fced8d3e69c794159211f0b1))
+
 ## 5.104.0 (2026-05-08)
 
 Full Changelog: [v5.103.1...v5.104.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.103.1...v5.104.0)

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.104.0"
+gem "telnyx", "~> 5.105.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/telnyx/models/call_dial_params.rb

@@ -23,7 +23,11 @@ module Telnyx
 
       # @!attribute to
       #   The DID or SIP URI to dial out to. Multiple DID or SIP URIs can be provided
-      #   using an array of strings
+      #   using an array of strings. For SIP URI destinations, append `;secure=true` or
+      #   `;secure=srtp` to enable SRTP media encryption for that endpoint, or
+      #   `;secure=dtls` to enable DTLS media encryption for that endpoint. If
+      #   `media_encryption` is set to `SRTP` or `DTLS`, it takes precedence over any
+      #   per-endpoint `secure` URI parameter.
       #
       #   @return [String, Array<String>]
       required :to, union: -> { Telnyx::CallDialParams::To }
@@ -161,7 +165,11 @@ module Telnyx
       optional :link_to, String
 
       # @!attribute media_encryption
-      #   Defines whether media should be encrypted on the call.
+      #   Defines whether media should be encrypted on the call. For SIP URI destinations,
+      #   media encryption can also be requested per endpoint with the `secure` URI
+      #   parameter: `;secure=true` or `;secure=srtp` enables SRTP, and `;secure=dtls`
+      #   enables DTLS. This parameter, when set to `SRTP` or `DTLS`, takes precedence
+      #   over the per-endpoint `secure` value.
       #
       #   @return [Symbol, Telnyx::Models::CallDialParams::MediaEncryption, nil]
       optional :media_encryption, enum: -> { Telnyx::CallDialParams::MediaEncryption }
@@ -492,7 +500,7 @@ module Telnyx
       #
       #   @param link_to [String] Use another call's control id for sharing the same call session id
       #
-      #   @param media_encryption [Symbol, Telnyx::Models::CallDialParams::MediaEncryption] Defines whether media should be encrypted on the call.
+      #   @param media_encryption [Symbol, Telnyx::Models::CallDialParams::MediaEncryption] Defines whether media should be encrypted on the call. For SIP URI destinations,
       #
       #   @param media_name [String] The media_name of a file to be played back to the callee when the call is answer
       #
@@ -578,7 +586,11 @@ module Telnyx
       #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
 
       # The DID or SIP URI to dial out to. Multiple DID or SIP URIs can be provided
-      # using an array of strings
+      # using an array of strings. For SIP URI destinations, append `;secure=true` or
+      # `;secure=srtp` to enable SRTP media encryption for that endpoint, or
+      # `;secure=dtls` to enable DTLS media encryption for that endpoint. If
+      # `media_encryption` is set to `SRTP` or `DTLS`, it takes precedence over any
+      # per-endpoint `secure` URI parameter.
       module To
         extend Telnyx::Internal::Type::Union
 
@@ -937,7 +949,11 @@ module Telnyx
         #   @param timeout [Integer] Maximum time in seconds to wait for a detection result before timing out.
       end
 
-      # Defines whether media should be encrypted on the call.
+      # Defines whether media should be encrypted on the call. For SIP URI destinations,
+      # media encryption can also be requested per endpoint with the `secure` URI
+      # parameter: `;secure=true` or `;secure=srtp` enables SRTP, and `;secure=dtls`
+      # enables DTLS. This parameter, when set to `SRTP` or `DTLS`, takes precedence
+      # over the per-endpoint `secure` value.
       module MediaEncryption
         extend Telnyx::Internal::Type::Enum
 

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

@@ -14,7 +14,11 @@ module Telnyx
         required :call_control_id, String
 
         # @!attribute to
-        #   The DID or SIP URI to dial out to.
+        #   The DID or SIP URI to dial out to. For SIP URI destinations, append
+        #   `;secure=true` or `;secure=srtp` to enable SRTP media encryption for that
+        #   endpoint, or `;secure=dtls` to enable DTLS media encryption for that endpoint.
+        #   If `media_encryption` is set to `SRTP` or `DTLS`, it takes precedence over any
+        #   per-endpoint `secure` URI parameter.
         #
         #   @return [String]
         required :to, String
@@ -95,7 +99,11 @@ module Telnyx
         optional :from_display_name, String
 
         # @!attribute media_encryption
-        #   Defines whether media should be encrypted on the new call leg.
+        #   Defines whether media should be encrypted on the new call leg. For SIP URI
+        #   destinations, media encryption can also be requested per endpoint with the
+        #   `secure` URI parameter: `;secure=true` or `;secure=srtp` enables SRTP, and
+        #   `;secure=dtls` enables DTLS. This parameter, when set to `SRTP` or `DTLS`, takes
+        #   precedence over the per-endpoint `secure` value.
         #
         #   @return [Symbol, Telnyx::Models::Calls::ActionTransferParams::MediaEncryption, nil]
         optional :media_encryption, enum: -> { Telnyx::Calls::ActionTransferParams::MediaEncryption }
@@ -306,7 +314,7 @@ module Telnyx
         #
         #   @param call_control_id [String]
         #
-        #   @param to [String] The DID or SIP URI to dial out to.
+        #   @param to [String] The DID or SIP URI to dial out to. For SIP URI destinations, append `;secure=tru
         #
         #   @param answering_machine_detection [Symbol, Telnyx::Models::Calls::ActionTransferParams::AnsweringMachineDetection] Enables Answering Machine Detection. When a call is answered, Telnyx runs real-t
         #
@@ -326,7 +334,7 @@ module Telnyx
         #
         #   @param from_display_name [String] The `from_display_name` string to be used as the caller id name (SIP From Displa
         #
-        #   @param media_encryption [Symbol, Telnyx::Models::Calls::ActionTransferParams::MediaEncryption] Defines whether media should be encrypted on the new call leg.
+        #   @param media_encryption [Symbol, Telnyx::Models::Calls::ActionTransferParams::MediaEncryption] Defines whether media should be encrypted on the new call leg. For SIP URI desti
         #
         #   @param media_name [String] The media_name of a file to be played back when the transfer destination answers
         #
@@ -501,7 +509,11 @@ module Telnyx
           #   @param total_analysis_time_millis [Integer] Maximum timeout threshold for overall detection.
         end
 
-        # Defines whether media should be encrypted on the new call leg.
+        # Defines whether media should be encrypted on the new call leg. For SIP URI
+        # destinations, media encryption can also be requested per endpoint with the
+        # `secure` URI parameter: `;secure=true` or `;secure=srtp` enables SRTP, and
+        # `;secure=dtls` enables DTLS. This parameter, when set to `SRTP` or `DTLS`, takes
+        # precedence over the per-endpoint `secure` value.
         module MediaEncryption
           extend Telnyx::Internal::Type::Enum
 

data/lib/telnyx/resources/calls/actions.rb

@@ -1625,7 +1625,7 @@ module Telnyx
         #
         # @param call_control_id [String] Unique identifier and token for controlling the call
         #
-        # @param to [String] The DID or SIP URI to dial out to.
+        # @param to [String] The DID or SIP URI to dial out to. For SIP URI destinations, append `;secure=tru
         #
         # @param answering_machine_detection [Symbol, Telnyx::Models::Calls::ActionTransferParams::AnsweringMachineDetection] Enables Answering Machine Detection. When a call is answered, Telnyx runs real-t
         #
@@ -1645,7 +1645,7 @@ module Telnyx
         #
         # @param from_display_name [String] The `from_display_name` string to be used as the caller id name (SIP From Displa
         #
-        # @param media_encryption [Symbol, Telnyx::Models::Calls::ActionTransferParams::MediaEncryption] Defines whether media should be encrypted on the new call leg.
+        # @param media_encryption [Symbol, Telnyx::Models::Calls::ActionTransferParams::MediaEncryption] Defines whether media should be encrypted on the new call leg. For SIP URI desti
         #
         # @param media_name [String] The media_name of a file to be played back when the transfer destination answers
         #

data/lib/telnyx/resources/calls.rb

@@ -75,7 +75,7 @@ module Telnyx
       #
       # @param link_to [String] Use another call's control id for sharing the same call session id
       #
-      # @param media_encryption [Symbol, Telnyx::Models::CallDialParams::MediaEncryption] Defines whether media should be encrypted on the call.
+      # @param media_encryption [Symbol, Telnyx::Models::CallDialParams::MediaEncryption] Defines whether media should be encrypted on the call. For SIP URI destinations,
       #
       # @param media_name [String] The media_name of a file to be played back to the callee when the call is answer
       #

data/lib/telnyx/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Telnyx
-  VERSION = "5.104.0"
+  VERSION = "5.105.0"
 end

data/rbi/telnyx/models/call_dial_params.rbi

@@ -22,7 +22,11 @@ module Telnyx
       attr_accessor :from
 
       # The DID or SIP URI to dial out to. Multiple DID or SIP URIs can be provided
-      # using an array of strings
+      # using an array of strings. For SIP URI destinations, append `;secure=true` or
+      # `;secure=srtp` to enable SRTP media encryption for that endpoint, or
+      # `;secure=dtls` to enable DTLS media encryption for that endpoint. If
+      # `media_encryption` is set to `SRTP` or `DTLS`, it takes precedence over any
+      # per-endpoint `secure` URI parameter.
       sig { returns(Telnyx::CallDialParams::To::Variants) }
       attr_accessor :to
 
@@ -201,7 +205,11 @@ module Telnyx
       sig { params(link_to: String).void }
       attr_writer :link_to
 
-      # Defines whether media should be encrypted on the call.
+      # Defines whether media should be encrypted on the call. For SIP URI destinations,
+      # media encryption can also be requested per endpoint with the `secure` URI
+      # parameter: `;secure=true` or `;secure=srtp` enables SRTP, and `;secure=dtls`
+      # enables DTLS. This parameter, when set to `SRTP` or `DTLS`, takes precedence
+      # over the per-endpoint `secure` value.
       sig do
         returns(T.nilable(Telnyx::CallDialParams::MediaEncryption::OrSymbol))
       end
@@ -711,7 +719,11 @@ module Telnyx
         # number). The number should be in +E164 format.
         from:,
         # The DID or SIP URI to dial out to. Multiple DID or SIP URIs can be provided
-        # using an array of strings
+        # using an array of strings. For SIP URI destinations, append `;secure=true` or
+        # `;secure=srtp` to enable SRTP media encryption for that endpoint, or
+        # `;secure=dtls` to enable DTLS media encryption for that endpoint. If
+        # `media_encryption` is set to `SRTP` or `DTLS`, it takes precedence over any
+        # per-endpoint `secure` URI parameter.
         to:,
         # Enables Answering Machine Detection. Telnyx offers Premium and Standard
         # detections. With Premium detection, when a call is answered, Telnyx runs
@@ -780,7 +792,11 @@ module Telnyx
         from_display_name: nil,
         # Use another call's control id for sharing the same call session id
         link_to: nil,
-        # Defines whether media should be encrypted on the call.
+        # Defines whether media should be encrypted on the call. For SIP URI destinations,
+        # media encryption can also be requested per endpoint with the `secure` URI
+        # parameter: `;secure=true` or `;secure=srtp` enables SRTP, and `;secure=dtls`
+        # enables DTLS. This parameter, when set to `SRTP` or `DTLS`, takes precedence
+        # over the per-endpoint `secure` value.
         media_encryption: nil,
         # The media_name of a file to be played back to the callee when the call is
         # answered. The media_name must point to a file previously uploaded to
@@ -990,7 +1006,11 @@ module Telnyx
       end
 
       # The DID or SIP URI to dial out to. Multiple DID or SIP URIs can be provided
-      # using an array of strings
+      # using an array of strings. For SIP URI destinations, append `;secure=true` or
+      # `;secure=srtp` to enable SRTP media encryption for that endpoint, or
+      # `;secure=dtls` to enable DTLS media encryption for that endpoint. If
+      # `media_encryption` is set to `SRTP` or `DTLS`, it takes precedence over any
+      # per-endpoint `secure` URI parameter.
       module To
         extend Telnyx::Internal::Type::Union
 
@@ -1637,7 +1657,11 @@ module Telnyx
         end
       end
 
-      # Defines whether media should be encrypted on the call.
+      # Defines whether media should be encrypted on the call. For SIP URI destinations,
+      # media encryption can also be requested per endpoint with the `secure` URI
+      # parameter: `;secure=true` or `;secure=srtp` enables SRTP, and `;secure=dtls`
+      # enables DTLS. This parameter, when set to `SRTP` or `DTLS`, takes precedence
+      # over the per-endpoint `secure` value.
       module MediaEncryption
         extend Telnyx::Internal::Type::Enum
 

data/rbi/telnyx/models/calls/action_transfer_params.rbi

@@ -18,7 +18,11 @@ module Telnyx
         sig { returns(String) }
         attr_accessor :call_control_id
 
-        # The DID or SIP URI to dial out to.
+        # The DID or SIP URI to dial out to. For SIP URI destinations, append
+        # `;secure=true` or `;secure=srtp` to enable SRTP media encryption for that
+        # endpoint, or `;secure=dtls` to enable DTLS media encryption for that endpoint.
+        # If `media_encryption` is set to `SRTP` or `DTLS`, it takes precedence over any
+        # per-endpoint `secure` URI parameter.
         sig { returns(String) }
         attr_accessor :to
 
@@ -128,7 +132,11 @@ module Telnyx
         sig { params(from_display_name: String).void }
         attr_writer :from_display_name
 
-        # Defines whether media should be encrypted on the new call leg.
+        # Defines whether media should be encrypted on the new call leg. For SIP URI
+        # destinations, media encryption can also be requested per endpoint with the
+        # `secure` URI parameter: `;secure=true` or `;secure=srtp` enables SRTP, and
+        # `;secure=dtls` enables DTLS. This parameter, when set to `SRTP` or `DTLS`, takes
+        # precedence over the per-endpoint `secure` value.
         sig do
           returns(
             T.nilable(
@@ -559,7 +567,11 @@ module Telnyx
         end
         def self.new(
           call_control_id:,
-          # The DID or SIP URI to dial out to.
+          # The DID or SIP URI to dial out to. For SIP URI destinations, append
+          # `;secure=true` or `;secure=srtp` to enable SRTP media encryption for that
+          # endpoint, or `;secure=dtls` to enable DTLS media encryption for that endpoint.
+          # If `media_encryption` is set to `SRTP` or `DTLS`, it takes precedence over any
+          # per-endpoint `secure` URI parameter.
           to:,
           # Enables Answering Machine Detection. When a call is answered, Telnyx runs
           # real-time detection to determine if it was picked up by a human or a machine and
@@ -598,7 +610,11 @@ module Telnyx
           # -\_~!.+ special characters. If ommited, the display name will be the same as the
           # number in the `from` field.
           from_display_name: nil,
-          # Defines whether media should be encrypted on the new call leg.
+          # Defines whether media should be encrypted on the new call leg. For SIP URI
+          # destinations, media encryption can also be requested per endpoint with the
+          # `secure` URI parameter: `;secure=true` or `;secure=srtp` enables SRTP, and
+          # `;secure=dtls` enables DTLS. This parameter, when set to `SRTP` or `DTLS`, takes
+          # precedence over the per-endpoint `secure` value.
           media_encryption: nil,
           # The media_name of a file to be played back when the transfer destination answers
           # before bridging the call. The media_name must point to a file previously
@@ -970,7 +986,11 @@ module Telnyx
           end
         end
 
-        # Defines whether media should be encrypted on the new call leg.
+        # Defines whether media should be encrypted on the new call leg. For SIP URI
+        # destinations, media encryption can also be requested per endpoint with the
+        # `secure` URI parameter: `;secure=true` or `;secure=srtp` enables SRTP, and
+        # `;secure=dtls` enables DTLS. This parameter, when set to `SRTP` or `DTLS`, takes
+        # precedence over the per-endpoint `secure` value.
         module MediaEncryption
           extend Telnyx::Internal::Type::Enum
 

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

@@ -2035,7 +2035,11 @@ module Telnyx
         def transfer(
           # Unique identifier and token for controlling the call
           call_control_id,
-          # The DID or SIP URI to dial out to.
+          # The DID or SIP URI to dial out to. For SIP URI destinations, append
+          # `;secure=true` or `;secure=srtp` to enable SRTP media encryption for that
+          # endpoint, or `;secure=dtls` to enable DTLS media encryption for that endpoint.
+          # If `media_encryption` is set to `SRTP` or `DTLS`, it takes precedence over any
+          # per-endpoint `secure` URI parameter.
           to:,
           # Enables Answering Machine Detection. When a call is answered, Telnyx runs
           # real-time detection to determine if it was picked up by a human or a machine and
@@ -2074,7 +2078,11 @@ module Telnyx
           # -\_~!.+ special characters. If ommited, the display name will be the same as the
           # number in the `from` field.
           from_display_name: nil,
-          # Defines whether media should be encrypted on the new call leg.
+          # Defines whether media should be encrypted on the new call leg. For SIP URI
+          # destinations, media encryption can also be requested per endpoint with the
+          # `secure` URI parameter: `;secure=true` or `;secure=srtp` enables SRTP, and
+          # `;secure=dtls` enables DTLS. This parameter, when set to `SRTP` or `DTLS`, takes
+          # precedence over the per-endpoint `secure` value.
           media_encryption: nil,
           # The media_name of a file to be played back when the transfer destination answers
           # before bridging the call. The media_name must point to a file previously

data/rbi/telnyx/resources/calls.rbi

@@ -117,7 +117,11 @@ module Telnyx
         # number). The number should be in +E164 format.
         from:,
         # The DID or SIP URI to dial out to. Multiple DID or SIP URIs can be provided
-        # using an array of strings
+        # using an array of strings. For SIP URI destinations, append `;secure=true` or
+        # `;secure=srtp` to enable SRTP media encryption for that endpoint, or
+        # `;secure=dtls` to enable DTLS media encryption for that endpoint. If
+        # `media_encryption` is set to `SRTP` or `DTLS`, it takes precedence over any
+        # per-endpoint `secure` URI parameter.
         to:,
         # Enables Answering Machine Detection. Telnyx offers Premium and Standard
         # detections. With Premium detection, when a call is answered, Telnyx runs
@@ -186,7 +190,11 @@ module Telnyx
         from_display_name: nil,
         # Use another call's control id for sharing the same call session id
         link_to: nil,
-        # Defines whether media should be encrypted on the call.
+        # Defines whether media should be encrypted on the call. For SIP URI destinations,
+        # media encryption can also be requested per endpoint with the `secure` URI
+        # parameter: `;secure=true` or `;secure=srtp` enables SRTP, and `;secure=dtls`
+        # enables DTLS. This parameter, when set to `SRTP` or `DTLS`, takes precedence
+        # over the per-endpoint `secure` value.
         media_encryption: nil,
         # The media_name of a file to be played back to the callee when the call is
         # answered. The media_name must point to a file previously uploaded to

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: telnyx
 version: !ruby/object:Gem::Version
-  version: 5.104.0
+  version: 5.105.0
 platform: ruby
 authors:
 - Telnyx