twilio-ruby 5.8.0 → 5.8.1

data/lib/twilio-ruby/rest/trunking.rb

@@ -27,7 +27,8 @@ module Twilio
       end
 
       ##
-      # @param [String] sid The sid
+      # @param [String] sid A 34 character string that uniquely identifies the SIP Trunk
+      #   in Twilio.
       # @return [Twilio::REST::Trunking::V1::TrunkInstance] if sid was passed.
       # @return [Twilio::REST::Trunking::V1::TrunkList]
       def trunks(sid=:unset)

data/lib/twilio-ruby/rest/trunking/v1/trunk.rb

@@ -24,12 +24,28 @@ module Twilio
           ##
           # Retrieve a single page of TrunkInstance records from the API.
           # Request is executed immediately.
-          # @param [String] friendly_name The friendly_name
-          # @param [String] domain_name The domain_name
-          # @param [String] disaster_recovery_url The disaster_recovery_url
-          # @param [String] disaster_recovery_method The disaster_recovery_method
-          # @param [String] recording The recording
-          # @param [Boolean] secure The secure
+          # @param [String] friendly_name A human-readable name for the Trunk.
+          # @param [String] domain_name The unique address you reserve on Twilio to which
+          #   you route your SIP traffic. Domain names can contain letters, digits, and `-`
+          #   and must always end with `pstn.twilio.com`. See [Termination
+          #   Settings](https://www.twilio.com/docs/sip-trunking/getting-started#termination)
+          #   for more information.
+          # @param [String] disaster_recovery_url The HTTP URL that Twilio will request if
+          #   an error occurs while sending SIP traffic towards your configured Origination
+          #   URL. Twilio will retrieve TwiML from this URL and execute those instructions
+          #   like any other normal TwiML call. See [Disaster
+          #   Recovery](https://www.twilio.com/docs/sip-trunking/getting-started#disaster-recovery) for more information.
+          # @param [String] disaster_recovery_method The HTTP method Twilio will use when
+          #   requesting the `DisasterRecoveryUrl`. Either `GET` or `POST`.
+          # @param [String] recording The recording settings for this trunk. If turned on,
+          #   all calls going through this trunk will be recorded and the recording can either
+          #   start when the call is ringing or when the call is answered. See
+          #   [Recording](https://www.twilio.com/docs/sip-trunking/getting-started#recording)
+          #   for more information.
+          # @param [Boolean] secure The Secure Trunking  settings for this trunk. If turned
+          #   on, all calls going through this trunk will be secure using SRTP for media and
+          #   TLS for signalling. If turned off, then RTP will be used for media. See [Secure
+          #   Trunking](https://www.twilio.com/docs/sip-trunking/getting-started#securetrunking) for more information.
           # @return [TrunkInstance] Newly created TrunkInstance
           def create(friendly_name: :unset, domain_name: :unset, disaster_recovery_url: :unset, disaster_recovery_method: :unset, recording: :unset, secure: :unset)
             data = Twilio::Values.of({
@@ -212,12 +228,28 @@ module Twilio
 
           ##
           # Update the TrunkInstance
-          # @param [String] friendly_name The friendly_name
-          # @param [String] domain_name The domain_name
-          # @param [String] disaster_recovery_url The disaster_recovery_url
-          # @param [String] disaster_recovery_method The disaster_recovery_method
-          # @param [String] recording The recording
-          # @param [Boolean] secure The secure
+          # @param [String] friendly_name A human-readable name for the Trunk.
+          # @param [String] domain_name The unique address you reserve on Twilio to which
+          #   you route your SIP traffic. Domain names can contain letters, digits, and `-`
+          #   and must always end with `pstn.twilio.com`. See [Termination
+          #   Settings](https://www.twilio.com/docs/sip-trunking/getting-started#termination)
+          #   for more information.
+          # @param [String] disaster_recovery_url The HTTP URL that Twilio will request if
+          #   an error occurs while sending SIP traffic towards your configured Origination
+          #   URL. Twilio will retrieve TwiML from this URL and execute those instructions
+          #   like any other normal TwiML call. See [Disaster
+          #   Recovery](https://www.twilio.com/docs/sip-trunking/getting-started#disaster-recovery) for more information.
+          # @param [String] disaster_recovery_method The HTTP method Twilio will use when
+          #   requesting the `DisasterRecoveryUrl`. Either `GET` or `POST`.
+          # @param [String] recording The recording settings for this trunk. If turned on,
+          #   all calls going through this trunk will be recorded and the recording can either
+          #   start when the call is ringing or when the call is answered. See
+          #   [Recording](https://www.twilio.com/docs/sip-trunking/getting-started#recording)
+          #   for more information.
+          # @param [Boolean] secure The Secure Trunking  settings for this trunk. If turned
+          #   on, all calls going through this trunk will be secure using SRTP for media and
+          #   TLS for signalling. If turned off, then RTP will be used for media. See [Secure
+          #   Trunking](https://www.twilio.com/docs/sip-trunking/getting-started#securetrunking) for more information.
           # @return [TrunkInstance] Updated TrunkInstance
           def update(friendly_name: :unset, domain_name: :unset, disaster_recovery_url: :unset, disaster_recovery_method: :unset, recording: :unset, secure: :unset)
             data = Twilio::Values.of({
@@ -363,49 +395,49 @@ module Twilio
           end
 
           ##
-          # @return [String] The account_sid
+          # @return [String] The unique ID of the Account that owns this Trunk.
           def account_sid
             @properties['account_sid']
           end
 
           ##
-          # @return [String] The domain_name
+          # @return [String] The unique address you reserve on Twilio to which you route your SIP traffic.
           def domain_name
             @properties['domain_name']
           end
 
           ##
-          # @return [String] The disaster_recovery_method
+          # @return [String] The HTTP method Twilio will use when requesting the DisasterRecoveryUrl.
           def disaster_recovery_method
             @properties['disaster_recovery_method']
           end
 
           ##
-          # @return [String] The disaster_recovery_url
+          # @return [String] The HTTP URL that Twilio will request if an error occurs while sending SIP traffic towards your configured Origination URL.
           def disaster_recovery_url
             @properties['disaster_recovery_url']
           end
 
           ##
-          # @return [String] The friendly_name
+          # @return [String] A human-readable name for the Trunk.
           def friendly_name
             @properties['friendly_name']
           end
 
           ##
-          # @return [Boolean] The secure
+          # @return [Boolean] The Secure Trunking  settings for this trunk.
           def secure
             @properties['secure']
           end
 
           ##
-          # @return [Hash] The recording
+          # @return [Hash] The recording settings for this trunk.
           def recording
             @properties['recording']
           end
 
           ##
-          # @return [String] The auth_type
+          # @return [String] The types of authentication you have mapped to your domain.
           def auth_type
             @properties['auth_type']
           end
@@ -417,25 +449,25 @@ module Twilio
           end
 
           ##
-          # @return [Time] The date_created
+          # @return [Time] The date this Activity was created.
           def date_created
             @properties['date_created']
           end
 
           ##
-          # @return [Time] The date_updated
+          # @return [Time] The date this Activity was updated.
           def date_updated
             @properties['date_updated']
           end
 
           ##
-          # @return [String] The sid
+          # @return [String] A 34 character string that uniquely identifies the SIP Trunk in Twilio.
           def sid
             @properties['sid']
           end
 
           ##
-          # @return [String] The url
+          # @return [String] The URL for this resource, relative to https://trunking.
           def url
             @properties['url']
           end
@@ -462,12 +494,28 @@ module Twilio
 
           ##
           # Update the TrunkInstance
-          # @param [String] friendly_name The friendly_name
-          # @param [String] domain_name The domain_name
-          # @param [String] disaster_recovery_url The disaster_recovery_url
-          # @param [String] disaster_recovery_method The disaster_recovery_method
-          # @param [String] recording The recording
-          # @param [Boolean] secure The secure
+          # @param [String] friendly_name A human-readable name for the Trunk.
+          # @param [String] domain_name The unique address you reserve on Twilio to which
+          #   you route your SIP traffic. Domain names can contain letters, digits, and `-`
+          #   and must always end with `pstn.twilio.com`. See [Termination
+          #   Settings](https://www.twilio.com/docs/sip-trunking/getting-started#termination)
+          #   for more information.
+          # @param [String] disaster_recovery_url The HTTP URL that Twilio will request if
+          #   an error occurs while sending SIP traffic towards your configured Origination
+          #   URL. Twilio will retrieve TwiML from this URL and execute those instructions
+          #   like any other normal TwiML call. See [Disaster
+          #   Recovery](https://www.twilio.com/docs/sip-trunking/getting-started#disaster-recovery) for more information.
+          # @param [String] disaster_recovery_method The HTTP method Twilio will use when
+          #   requesting the `DisasterRecoveryUrl`. Either `GET` or `POST`.
+          # @param [String] recording The recording settings for this trunk. If turned on,
+          #   all calls going through this trunk will be recorded and the recording can either
+          #   start when the call is ringing or when the call is answered. See
+          #   [Recording](https://www.twilio.com/docs/sip-trunking/getting-started#recording)
+          #   for more information.
+          # @param [Boolean] secure The Secure Trunking  settings for this trunk. If turned
+          #   on, all calls going through this trunk will be secure using SRTP for media and
+          #   TLS for signalling. If turned off, then RTP will be used for media. See [Secure
+          #   Trunking](https://www.twilio.com/docs/sip-trunking/getting-started#securetrunking) for more information.
           # @return [TrunkInstance] Updated TrunkInstance
           def update(friendly_name: :unset, domain_name: :unset, disaster_recovery_url: :unset, disaster_recovery_method: :unset, recording: :unset, secure: :unset)
             context.update(

data/lib/twilio-ruby/rest/trunking/v1/trunk/origination_url.rb

@@ -13,7 +13,8 @@ module Twilio
             ##
             # Initialize the OriginationUrlList
             # @param [Version] version Version that contains the resource
-            # @param [String] trunk_sid The trunk_sid
+            # @param [String] trunk_sid The unique ID of the Trunk that owns this Origination
+            #   URL.
             # @return [OriginationUrlList] OriginationUrlList
             def initialize(version, trunk_sid: nil)
               super(version)
@@ -26,11 +27,18 @@ module Twilio
             ##
             # Retrieve a single page of OriginationUrlInstance records from the API.
             # Request is executed immediately.
-            # @param [String] weight The weight
-            # @param [String] priority The priority
-            # @param [Boolean] enabled The enabled
-            # @param [String] friendly_name The friendly_name
-            # @param [String] sip_url The sip_url
+            # @param [String] weight Weight is used to determine the share of load when more
+            #   than one URI has the same priority. Its values range from 1 to 65535. The higher
+            #   the value, the more load a URI is given. Defaults to 10.
+            # @param [String] priority Priority ranks the importance of the URI. Values range
+            #   from 0 to 65535, where the lowest number represents the highest importance.
+            #   Defaults to 10.
+            # @param [Boolean] enabled A boolean value indicating whether the URL is enabled
+            #   or disabled. Defaults to true.
+            # @param [String] friendly_name A human readable descriptive text, up to 64
+            #   characters long.
+            # @param [String] sip_url The SIP address you want Twilio to route your
+            #   Origination calls to. This must be a `sip:` schema.
             # @return [OriginationUrlInstance] Newly created OriginationUrlInstance
             def create(weight: nil, priority: nil, enabled: nil, friendly_name: nil, sip_url: nil)
               data = Twilio::Values.of({
@@ -212,11 +220,18 @@ module Twilio
 
             ##
             # Update the OriginationUrlInstance
-            # @param [String] weight The weight
-            # @param [String] priority The priority
-            # @param [Boolean] enabled The enabled
-            # @param [String] friendly_name The friendly_name
-            # @param [String] sip_url The sip_url
+            # @param [String] weight Weight is used to determine the share of load when more
+            #   than one URI has the same priority. Its values range from 1 to 65535. The higher
+            #   the value, the more load a URI is given. Defaults to 10.
+            # @param [String] priority Priority ranks the importance of the URI. Values range
+            #   from 0 to 65535, where the lowest number represents the highest importance.
+            #   Defaults to 10.
+            # @param [Boolean] enabled A boolean value indicating whether the URL is enabled
+            #   or disabled. Defaults to true.
+            # @param [String] friendly_name A human readable descriptive text, up to 64
+            #   characters long.
+            # @param [String] sip_url The SIP address you want Twilio to route your
+            #   Origination calls to. This must be a `sip:` schema. `sips` is NOT supported
             # @return [OriginationUrlInstance] Updated OriginationUrlInstance
             def update(weight: :unset, priority: :unset, enabled: :unset, friendly_name: :unset, sip_url: :unset)
               data = Twilio::Values.of({
@@ -254,7 +269,8 @@ module Twilio
             # Initialize the OriginationUrlInstance
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
-            # @param [String] trunk_sid The trunk_sid
+            # @param [String] trunk_sid The unique ID of the Trunk that owns this Origination
+            #   URL.
             # @param [String] sid The sid
             # @return [OriginationUrlInstance] OriginationUrlInstance
             def initialize(version, payload, trunk_sid: nil, sid: nil)
@@ -292,67 +308,67 @@ module Twilio
             end
 
             ##
-            # @return [String] The account_sid
+            # @return [String] The unique ID of the Account that owns this Origination URL.
             def account_sid
               @properties['account_sid']
             end
 
             ##
-            # @return [String] The sid
+            # @return [String] A 34 character string that uniquely identifies the Origination URL in this Twilio Trunk.
             def sid
               @properties['sid']
             end
 
             ##
-            # @return [String] The trunk_sid
+            # @return [String] The unique ID of the Trunk that owns this Origination URL.
             def trunk_sid
               @properties['trunk_sid']
             end
 
             ##
-            # @return [String] The weight
+            # @return [String] Weight is used to determine the share of load when more than one URI has the same priority.
             def weight
               @properties['weight']
             end
 
             ##
-            # @return [Boolean] The enabled
+            # @return [Boolean] A boolean value indicating whether the URL is enabled or disabled.
             def enabled
               @properties['enabled']
             end
 
             ##
-            # @return [String] The sip_url
+            # @return [String] The SIP address you want Twilio to route your Origination calls to.
             def sip_url
               @properties['sip_url']
             end
 
             ##
-            # @return [String] The friendly_name
+            # @return [String] A human readable descriptive text, up to 64 characters long.
             def friendly_name
               @properties['friendly_name']
             end
 
             ##
-            # @return [String] The priority
+            # @return [String] Priority ranks the importance of the URI.
             def priority
               @properties['priority']
             end
 
             ##
-            # @return [Time] The date_created
+            # @return [Time] The date this Activity was created.
             def date_created
               @properties['date_created']
             end
 
             ##
-            # @return [Time] The date_updated
+            # @return [Time] The date this Activity was updated.
             def date_updated
               @properties['date_updated']
             end
 
             ##
-            # @return [String] The url
+            # @return [String] The URL for this resource, relative to https://trunking.
             def url
               @properties['url']
             end
@@ -373,11 +389,18 @@ module Twilio
 
             ##
             # Update the OriginationUrlInstance
-            # @param [String] weight The weight
-            # @param [String] priority The priority
-            # @param [Boolean] enabled The enabled
-            # @param [String] friendly_name The friendly_name
-            # @param [String] sip_url The sip_url
+            # @param [String] weight Weight is used to determine the share of load when more
+            #   than one URI has the same priority. Its values range from 1 to 65535. The higher
+            #   the value, the more load a URI is given. Defaults to 10.
+            # @param [String] priority Priority ranks the importance of the URI. Values range
+            #   from 0 to 65535, where the lowest number represents the highest importance.
+            #   Defaults to 10.
+            # @param [Boolean] enabled A boolean value indicating whether the URL is enabled
+            #   or disabled. Defaults to true.
+            # @param [String] friendly_name A human readable descriptive text, up to 64
+            #   characters long.
+            # @param [String] sip_url The SIP address you want Twilio to route your
+            #   Origination calls to. This must be a `sip:` schema. `sips` is NOT supported
             # @return [OriginationUrlInstance] Updated OriginationUrlInstance
             def update(weight: :unset, priority: :unset, enabled: :unset, friendly_name: :unset, sip_url: :unset)
               context.update(

data/lib/twilio-ruby/rest/trunking/v1/trunk/phone_number.rb

@@ -26,7 +26,9 @@ module Twilio
             ##
             # Retrieve a single page of PhoneNumberInstance records from the API.
             # Request is executed immediately.
-            # @param [String] phone_number_sid The phone_number_sid
+            # @param [String] phone_number_sid The SID of the [Incoming Phone
+            #   Number](https://www.twilio.com/docs/api/rest/incoming-phone-numbers) that you
+            #   want to associate with this trunk.
             # @return [PhoneNumberInstance] Newly created PhoneNumberInstance
             def create(phone_number_sid: nil)
               data = Twilio::Values.of({'PhoneNumberSid' => phone_number_sid, })

data/lib/twilio-ruby/rest/video/v1/room/recording.rb

@@ -226,14 +226,15 @@ module Twilio
                   'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
                   'sid' => payload['sid'],
                   'source_sid' => payload['source_sid'],
-                  'size' => payload['size'] == nil ? payload['size'] : payload['size'].to_i,
+                  'size' => payload['size'],
+                  'url' => payload['url'],
                   'type' => payload['type'],
                   'duration' => payload['duration'] == nil ? payload['duration'] : payload['duration'].to_i,
                   'container_format' => payload['container_format'],
                   'codec' => payload['codec'],
                   'grouping_sids' => payload['grouping_sids'],
+                  'track_name' => payload['track_name'],
                   'room_sid' => payload['room_sid'],
-                  'url' => payload['url'],
                   'links' => payload['links'],
               }
 
@@ -289,6 +290,12 @@ module Twilio
               @properties['size']
             end
 
+            ##
+            # @return [String] The url
+            def url
+              @properties['url']
+            end
+
             ##
             # @return [room_recording.Type] The type
             def type
@@ -320,15 +327,15 @@ module Twilio
             end
 
             ##
-            # @return [String] The room_sid
-            def room_sid
-              @properties['room_sid']
+            # @return [String] The track_name
+            def track_name
+              @properties['track_name']
             end
 
             ##
-            # @return [String] The url
-            def url
-              @properties['url']
+            # @return [String] The room_sid
+            def room_sid
+              @properties['room_sid']
             end
 
             ##

data/lib/twilio-ruby/version.rb

@@ -1,3 +1,3 @@
 module Twilio
-    VERSION = '5.8.0'
+    VERSION = '5.8.1'
 end

data/spec/integration/pricing/v1/messaging/country_spec.rb

@@ -30,13 +30,13 @@ describe 'Country' do
       {
           "countries": [],
           "meta": {
-              "first_page_url": "https://pricing.twilio.com/v1/Messaging/Countries?Page=0&PageSize=50",
+              "first_page_url": "https://pricing.twilio.com/v1/Messaging/Countries?PageSize=50&Page=0",
               "key": "countries",
               "next_page_url": null,
               "page": 0,
-              "page_size": 0,
+              "page_size": 50,
               "previous_page_url": null,
-              "url": "https://pricing.twilio.com/v1/Messaging/Countries"
+              "url": "https://pricing.twilio.com/v1/Messaging/Countries?PageSize=50&Page=0"
           }
       }
       ]
@@ -57,17 +57,17 @@ describe 'Country' do
               {
                   "country": "country",
                   "iso_country": "US",
-                  "url": "http://www.example.com"
+                  "url": "https://pricing.twilio.com/v1/Messaging/Countries/US"
               }
           ],
           "meta": {
-              "first_page_url": "https://pricing.twilio.com/v1/Messaging/Countries?Page=0&PageSize=50",
+              "first_page_url": "https://pricing.twilio.com/v1/Messaging/Countries?PageSize=50&Page=0",
               "key": "countries",
               "next_page_url": null,
               "page": 0,
-              "page_size": 1,
+              "page_size": 50,
               "previous_page_url": null,
-              "url": "https://pricing.twilio.com/v1/Messaging/Countries"
+              "url": "https://pricing.twilio.com/v1/Messaging/Countries?PageSize=50&Page=0"
           }
       }
       ]
@@ -103,8 +103,8 @@ describe 'Country' do
           "country": "country",
           "inbound_sms_prices": [
               {
-                  "base_price": 0.05,
-                  "current_price": 0.05,
+                  "base_price": "0.05",
+                  "current_price": "0.05",
                   "number_type": "mobile"
               }
           ],
@@ -116,15 +116,15 @@ describe 'Country' do
                   "mnc": "bar",
                   "prices": [
                       {
-                          "base_price": 0.05,
-                          "current_price": 0.05,
+                          "base_price": "0.05",
+                          "current_price": "0.05",
                           "number_type": "mobile"
                       }
                   ]
               }
           ],
           "price_unit": "USD",
-          "url": "http://www.example.com"
+          "url": "https://pricing.twilio.com/v1/Messaging/Countries/US"
       }
       ]
     ))