twilio-ruby 5.57.1 → 5.58.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 56ba46ce32ceced608bcb6b1ab335f0aa103da6d3a40dba1e0a59b97734fe4f7
-  data.tar.gz: 4104e0a452f0760f38a5ef1429553ad9a5f92c33a314e57d8f6e25c1689ada84
+  metadata.gz: e167e2f47babb9e5652b385ede76e80463adea6014e4f9792128e33404760e5c
+  data.tar.gz: 957a9a74c168c72927875320f8217d7c596b0d90a65dab5ed5ce5c2dd65862b9
 SHA512:
-  metadata.gz: 0d3edfca4bae4bad789f6ef2e5f15a161c115bb625e6a0912049c8f6054b05c40d4e41dd19544072be75a0e4f6d69f1b23fa41f3e8b3bee2453843f370c8c658
-  data.tar.gz: 294073c071626bd889f211b66d16f0f896c6e127d524385b9d8989684eced0d63cdd1b6d456537f9ccc78e8b2a71b45dfdb1b14ec4a86c1f3b90413a0f4c588b
+  metadata.gz: 43aef4541bc88db9f74877d012a55fc052891051ccbdc9360357af66c876cd11d2e48398fbf6ea617513a40f6f2f9bc721da6345c01971007b6484a06346046c
+  data.tar.gz: a099337f9ae57f2954bab11add9d43a29773ac77f3429f693a6f7845fdf5099147f1d2c1423dccc7d01e302f66e7ea2c86bb2f17c0fd35400fdb70533da1f66d

data/.gitignore

@@ -12,3 +12,5 @@ bin
 docs/_build
 *.bak
 *.iml
+
+coverage

data/.travis.yml

@@ -3,23 +3,35 @@ cache: bundler
 bundler_args: "--without development"
 rvm:
 - ruby-head
-- 3.0
-- 2.7
-- 2.6
-- 2.5
-- 2.4
 - jruby-9.2
+- 2.4
+- 2.5
+- 2.6
+- 2.7
+- 3.0
 services:
 - docker
 install: make install
-script: make test
+script:
+- make test
+- if [[ "$TRAVIS_BRANCH" == "main"  ||  "$TRAVIS_BRANCH" == "travis" ]] && [ "$TRAVIS_PULL_REQUEST"
+  == "false" ]; then echo "${DOCKER_PASSWORD}" | docker login -u "${DOCKER_USERNAME}"
+  --password-stdin; fi
 matrix:
+  include:
+    - language: ruby
+      rvm: '3.0'
+      # The below workaround is necessary because of the branch coverage inclusion in simplecov 0.18+
+      # more discussion here - https://community.sonarsource.com/t/ruby-coverage-simplecov-json-file-does-not-work/20909/7
+      after_success:
+        - ruby -rjson -e 'sqube = JSON.load(File.read("coverage/.resultset.json"))["RSpec"]["coverage"].transform_values {|lines| lines["lines"]}; total = { "RSpec" => { "coverage" => sqube, "timestamp" => Time.now.to_i }}; puts JSON.dump(total)' > coverage/.resultset.sonarqube.json
+        - sonar-scanner
   allow_failures:
   - rvm: ruby-head
   fast_finish: true
 deploy:
 - provider: script
-  script: echo "${DOCKER_PASSWORD}" | docker login -u "${DOCKER_USERNAME}" --password-stdin && make docker-build && make docker-push
+  script: make docker-build && make docker-push
   skip_cleanup: true
   on:
     tags: true
@@ -37,3 +49,8 @@ notifications:
     on_failure: change
     rooms:
       secure: HG7rC5VSDOZiLCkpTsC4ZImh1k59OPi6YEjYKhdGXItybLHa6Yh5C42WvSx3kVW3SeyLOm1CiaMv+pbBZUXStXYsl8eH69MbEZimhDWsPs/m+bh+gEISov22WNUs3ZfUqIXMIb6v18oXPp2Qa1gX5LUEAGoSxHWNmCAcHayWl7M=
+addons:
+  sonarcloud:
+    organization: twilio
+    token:
+      secure: OSEahx/yO/r9PdjXbASwJt+ogphxkDDpnlajWNCBTc+hoiEurGP/12CN0oQi7+iishIgIowqo5J9/+m1BQfsAv4fKST+t6mSazx27udiiM9am03lhviW8QSG6STADvtq6uJRqTXMk3WehoSidNRYXamVdCoBbqxCSaMX8MbMsN8=

data/CHANGES.md

@@ -1,6 +1,89 @@
 twilio-ruby changelog
 =====================
 
+[2021-09-22] Version 5.58.3
+---------------------------
+**Events**
+- Add segment sink
+
+**Messaging**
+- Add post_approval_required attribute in GET us_app_to_person_usecase api response
+- Add Identity Status, Russell 3000, Tax Exempt Status and Should Skip SecVet fields for Brand Registrations
+- Add Should Skip Secondary Vetting optional flag parameter to create Brand API
+
+
+[2021-09-08] Version 5.58.2
+---------------------------
+**Library - Fix**
+- [PR #568](https://github.com/twilio/twilio-ruby/pull/568): deprecation warning on Faraday. Thanks to [@ngouy](https://github.com/ngouy)!
+
+**Api**
+- Revert adding `siprec` resource
+- Add `siprec` resource
+
+**Messaging**
+- Add 'mock' as an optional field to brand_registration api
+- Add 'mock' as an optional field to us_app_to_person api
+- Adds more Use Cases in us_app_to_person_usecase api transaction and updates us_app_to_person_usecase docs
+
+**Verify**
+- Verify List Templates API endpoint added.
+
+
+[2021-08-25] Version 5.58.1
+---------------------------
+**Api**
+- Add Programmabled Voice SIP Refer call transfers (`calls-transfers`) to usage records
+- Add Flex Voice Usage category (`flex-usage`) to usage records
+
+**Conversations**
+- Add `Order` query parameter to Message resource read operation
+
+**Insights**
+- Added `partial` to enum processing_state_request
+- Added abnormal session filter in Call Summaries
+
+**Messaging**
+- Add brand_registration_sid as an optional query param for us_app_to_person_usecase api
+
+**Pricing**
+- add trunking_numbers resource (v2)
+- add trunking_country resource (v2)
+
+**Verify**
+- Changed to private beta the `TemplateSid` optional parameter on Verification creation.
+- Added the optional parameter `Order` to the list Challenges endpoint to define the list order.
+
+
+[2021-08-11] Version 5.58.0
+---------------------------
+**Library - Chore**
+- [PR #566](https://github.com/twilio/twilio-ruby/pull/566): integrate sonarcloud. Thanks to [@shwetha-manvinkurke](https://github.com/shwetha-manvinkurke)!
+
+**Library - Docs**
+- [PR #565](https://github.com/twilio/twilio-ruby/pull/565): update mms example to use media_url. Thanks to [@cnorm35](https://github.com/cnorm35)!
+
+**Api**
+- Corrected the `price`, `call_sid_to_coach`, and `uri` data types for Conference, Participant, and Recording **(breaking change)**
+- Made documentation for property `time_limit` in the call api public. **(breaking change)**
+- Added `domain_sid` in sip_credential_list_mapping and sip_ip_access_control_list_mapping APIs **(breaking change)**
+
+**Insights**
+- Added new endpoint to fetch Call Summaries
+
+**Messaging**
+- Add brand_type field to a2p brand_registration api
+- Revert brand registration api update to add brand_type field
+- Add brand_type field to a2p brand_registration api
+
+**Taskrouter**
+- Add `X-Rate-Limit-Limit`, `X-Rate-Limit-Remaining`, and `X-Rate-Limit-Config` as Response Headers to all TaskRouter endpoints
+
+**Verify**
+- Add `TemplateSid` optional parameter on Verification creation.
+- Include `whatsapp` as a channel type in the verifications API.
+
+
 [2021-07-28] Version 5.57.1
 ---------------------------
 **Conversations**

data/Gemfile

@@ -1,2 +1,3 @@
 source 'https://rubygems.org'
+gem 'simplecov', require: false, group: :test
 gemspec

data/README.md

@@ -35,13 +35,13 @@ This library supports the following Ruby implementations:
 To install using [Bundler][bundler] grab the latest stable version:
 
 ```ruby
-gem 'twilio-ruby', '~> 5.57.1'
+gem 'twilio-ruby', '~> 5.58.3'
 ```
 
 To manually install `twilio-ruby` via [Rubygems][rubygems] simply gem install:
 
 ```bash
-gem install twilio-ruby -v 5.57.1
+gem install twilio-ruby -v 5.58.3
 ```
 
 To build and install the development branch yourself from the latest source:

data/examples/examples.rb

@@ -69,7 +69,7 @@ puts @client.messages('SMXXXXXXXX').fetch.body
 @client.messages.create(
   from: '+14159341234',
   to: '+16105557069',
-  media_urls: 'http://example.com/media.png'
+  media_url: 'http://example.com/media.png'
 )
 
 ################ PHONE NUMBERS ################

data/lib/twilio-ruby/http/http_client.rb

@@ -31,7 +31,7 @@ module Twilio
           f.options.params_encoder = Faraday::FlatParamsEncoder
           f.request :url_encoded
           f.headers = request.headers
-          f.basic_auth(request.auth[0], request.auth[1])
+          f.request(:basic_auth, request.auth[0], request.auth[1])
           f.proxy = "#{@proxy_prot}://#{@proxy_auth}#{@proxy_path}" if @proxy_prot && @proxy_path
           f.options.open_timeout = request.timeout || @timeout
           f.options.timeout = request.timeout || @timeout

data/lib/twilio-ruby/rest/api/v2010/account/call.rb

@@ -151,6 +151,8 @@ module Twilio
             #   `inbound`, `outbound` or `both`. The default is `both`. `inbound` records the
             #   audio that is received by Twilio. `outbound` records the audio that is generated
             #   from Twilio. `both` records the audio that is received and generated by Twilio.
+            # @param [String] time_limit The maximum duration of the call in seconds.
+            #   Constraints depend on account and configuration.
             # @param [String] url The absolute URL that returns the TwiML instructions for the
             #   call. We will call this URL using the `method` when the call connects. For more
             #   information, see the {Url
@@ -162,7 +164,7 @@ module Twilio
             # @param [String] application_sid The SID of the Application resource that will
             #   handle the call, if the call will be handled by an application.
             # @return [CallInstance] Created CallInstance
-            def create(to: nil, from: nil, method: :unset, fallback_url: :unset, fallback_method: :unset, status_callback: :unset, status_callback_event: :unset, status_callback_method: :unset, send_digits: :unset, timeout: :unset, record: :unset, recording_channels: :unset, recording_status_callback: :unset, recording_status_callback_method: :unset, sip_auth_username: :unset, sip_auth_password: :unset, machine_detection: :unset, machine_detection_timeout: :unset, recording_status_callback_event: :unset, trim: :unset, caller_id: :unset, machine_detection_speech_threshold: :unset, machine_detection_speech_end_threshold: :unset, machine_detection_silence_timeout: :unset, async_amd: :unset, async_amd_status_callback: :unset, async_amd_status_callback_method: :unset, byoc: :unset, call_reason: :unset, call_token: :unset, recording_track: :unset, url: :unset, twiml: :unset, application_sid: :unset)
+            def create(to: nil, from: nil, method: :unset, fallback_url: :unset, fallback_method: :unset, status_callback: :unset, status_callback_event: :unset, status_callback_method: :unset, send_digits: :unset, timeout: :unset, record: :unset, recording_channels: :unset, recording_status_callback: :unset, recording_status_callback_method: :unset, sip_auth_username: :unset, sip_auth_password: :unset, machine_detection: :unset, machine_detection_timeout: :unset, recording_status_callback_event: :unset, trim: :unset, caller_id: :unset, machine_detection_speech_threshold: :unset, machine_detection_speech_end_threshold: :unset, machine_detection_silence_timeout: :unset, async_amd: :unset, async_amd_status_callback: :unset, async_amd_status_callback_method: :unset, byoc: :unset, call_reason: :unset, call_token: :unset, recording_track: :unset, time_limit: :unset, url: :unset, twiml: :unset, application_sid: :unset)
               data = Twilio::Values.of({
                   'To' => to,
                   'From' => from,
@@ -198,6 +200,7 @@ module Twilio
                   'CallReason' => call_reason,
                   'CallToken' => call_token,
                   'RecordingTrack' => recording_track,
+                  'TimeLimit' => time_limit,
               })
 
               payload = @version.create('POST', @uri, data: data)
@@ -488,8 +491,10 @@ module Twilio
             #   `POST`. If an `application_sid` parameter is present, this parameter is ignored.
             # @param [String] twiml TwiML instructions for the call Twilio will use without
             #   fetching Twiml from url. Twiml and url parameters are mutually exclusive
+            # @param [String] time_limit The maximum duration of the call in seconds.
+            #   Constraints depend on account and configuration.
             # @return [CallInstance] Updated CallInstance
-            def update(url: :unset, method: :unset, status: :unset, fallback_url: :unset, fallback_method: :unset, status_callback: :unset, status_callback_method: :unset, twiml: :unset)
+            def update(url: :unset, method: :unset, status: :unset, fallback_url: :unset, fallback_method: :unset, status_callback: :unset, status_callback_method: :unset, twiml: :unset, time_limit: :unset)
               data = Twilio::Values.of({
                   'Url' => url,
                   'Method' => method,
@@ -499,6 +504,7 @@ module Twilio
                   'StatusCallback' => status_callback,
                   'StatusCallbackMethod' => status_callback_method,
                   'Twiml' => twiml,
+                  'TimeLimit' => time_limit,
               })
 
               payload = @version.update('POST', @uri, data: data)
@@ -874,8 +880,10 @@ module Twilio
             #   `POST`. If an `application_sid` parameter is present, this parameter is ignored.
             # @param [String] twiml TwiML instructions for the call Twilio will use without
             #   fetching Twiml from url. Twiml and url parameters are mutually exclusive
+            # @param [String] time_limit The maximum duration of the call in seconds.
+            #   Constraints depend on account and configuration.
             # @return [CallInstance] Updated CallInstance
-            def update(url: :unset, method: :unset, status: :unset, fallback_url: :unset, fallback_method: :unset, status_callback: :unset, status_callback_method: :unset, twiml: :unset)
+            def update(url: :unset, method: :unset, status: :unset, fallback_url: :unset, fallback_method: :unset, status_callback: :unset, status_callback_method: :unset, twiml: :unset, time_limit: :unset)
               context.update(
                   url: url,
                   method: method,
@@ -885,6 +893,7 @@ module Twilio
                   status_callback: status_callback,
                   status_callback_method: status_callback_method,
                   twiml: twiml,
+                  time_limit: time_limit,
               )
             end
 

data/lib/twilio-ruby/rest/api/v2010/account/conference/participant.rb

@@ -167,8 +167,10 @@ module Twilio
               #   `inbound`, `outbound` or `both`. The default is `both`. `inbound` records the
               #   audio that is received by Twilio. `outbound` records the audio that is sent from
               #   Twilio. `both` records the audio that is received and sent by Twilio.
+              # @param [String] time_limit The maximum duration of the call in seconds.
+              #   Constraints depend on account and configuration.
               # @return [ParticipantInstance] Created ParticipantInstance
-              def create(from: nil, to: nil, status_callback: :unset, status_callback_method: :unset, status_callback_event: :unset, label: :unset, timeout: :unset, record: :unset, muted: :unset, beep: :unset, start_conference_on_enter: :unset, end_conference_on_exit: :unset, wait_url: :unset, wait_method: :unset, early_media: :unset, max_participants: :unset, conference_record: :unset, conference_trim: :unset, conference_status_callback: :unset, conference_status_callback_method: :unset, conference_status_callback_event: :unset, recording_channels: :unset, recording_status_callback: :unset, recording_status_callback_method: :unset, sip_auth_username: :unset, sip_auth_password: :unset, region: :unset, conference_recording_status_callback: :unset, conference_recording_status_callback_method: :unset, recording_status_callback_event: :unset, conference_recording_status_callback_event: :unset, coaching: :unset, call_sid_to_coach: :unset, jitter_buffer_size: :unset, byoc: :unset, caller_id: :unset, call_reason: :unset, recording_track: :unset)
+              def create(from: nil, to: nil, status_callback: :unset, status_callback_method: :unset, status_callback_event: :unset, label: :unset, timeout: :unset, record: :unset, muted: :unset, beep: :unset, start_conference_on_enter: :unset, end_conference_on_exit: :unset, wait_url: :unset, wait_method: :unset, early_media: :unset, max_participants: :unset, conference_record: :unset, conference_trim: :unset, conference_status_callback: :unset, conference_status_callback_method: :unset, conference_status_callback_event: :unset, recording_channels: :unset, recording_status_callback: :unset, recording_status_callback_method: :unset, sip_auth_username: :unset, sip_auth_password: :unset, region: :unset, conference_recording_status_callback: :unset, conference_recording_status_callback_method: :unset, recording_status_callback_event: :unset, conference_recording_status_callback_event: :unset, coaching: :unset, call_sid_to_coach: :unset, jitter_buffer_size: :unset, byoc: :unset, caller_id: :unset, call_reason: :unset, recording_track: :unset, time_limit: :unset)
                 data = Twilio::Values.of({
                     'From' => from,
                     'To' => to,
@@ -208,6 +210,7 @@ module Twilio
                     'CallerId' => caller_id,
                     'CallReason' => call_reason,
                     'RecordingTrack' => recording_track,
+                    'TimeLimit' => time_limit,
                 })
 
                 payload = @version.create('POST', @uri, data: data)

data/lib/twilio-ruby/rest/api/v2010/account/conference/recording.rb

@@ -282,7 +282,7 @@ module Twilio
                     'start_time' => Twilio.deserialize_rfc2822(payload['start_time']),
                     'duration' => payload['duration'],
                     'sid' => payload['sid'],
-                    'price' => payload['price'].to_f,
+                    'price' => payload['price'],
                     'price_unit' => payload['price_unit'],
                     'status' => payload['status'],
                     'channels' => payload['channels'].to_i,

data/lib/twilio-ruby/rest/api/v2010/account/sip/domain/credential_list_mapping.rb

@@ -19,8 +19,8 @@ module Twilio
                 # @param [Version] version Version that contains the resource
                 # @param [String] account_sid The unique id of the Account that is responsible for
                 #   this resource.
-                # @param [String] domain_sid The unique string that that we created to identify
-                #   the SipDomain resource.
+                # @param [String] domain_sid The unique string that is created to identify the
+                #   SipDomain resource.
                 # @return [CredentialListMappingList] CredentialListMappingList
                 def initialize(version, account_sid: nil, domain_sid: nil)
                   super(version)
@@ -233,8 +233,8 @@ module Twilio
                 # @param [Hash] payload payload that contains response from Twilio
                 # @param [String] account_sid The unique id of the Account that is responsible for
                 #   this resource.
-                # @param [String] domain_sid The unique string that that we created to identify
-                #   the SipDomain resource.
+                # @param [String] domain_sid The unique string that is created to identify the
+                #   SipDomain resource.
                 # @param [String] sid A 34 character string that uniquely identifies the resource
                 #   to fetch.
                 # @return [CredentialListMappingInstance] CredentialListMappingInstance
@@ -246,10 +246,10 @@ module Twilio
                       'account_sid' => payload['account_sid'],
                       'date_created' => Twilio.deserialize_rfc2822(payload['date_created']),
                       'date_updated' => Twilio.deserialize_rfc2822(payload['date_updated']),
+                      'domain_sid' => payload['domain_sid'],
                       'friendly_name' => payload['friendly_name'],
                       'sid' => payload['sid'],
                       'uri' => payload['uri'],
-                      'subresource_uris' => payload['subresource_uris'],
                   }
 
                   # Context
@@ -295,6 +295,12 @@ module Twilio
                   @properties['date_updated']
                 end
 
+                ##
+                # @return [String] The unique string that identifies the SipDomain resource.
+                def domain_sid
+                  @properties['domain_sid']
+                end
+
                 ##
                 # @return [String] A human readable descriptive text for this resource, up to 64 characters long.
                 def friendly_name
@@ -313,12 +319,6 @@ module Twilio
                   @properties['uri']
                 end
 
-                ##
-                # @return [String] The credentials associated with this resource.
-                def subresource_uris
-                  @properties['subresource_uris']
-                end
-
                 ##
                 # Fetch the CredentialListMappingInstance
                 # @return [CredentialListMappingInstance] Fetched CredentialListMappingInstance

data/lib/twilio-ruby/rest/api/v2010/account/sip/domain/ip_access_control_list_mapping.rb

@@ -19,8 +19,8 @@ module Twilio
                 # @param [Version] version Version that contains the resource
                 # @param [String] account_sid The unique id of the Account that is responsible for
                 #   this resource.
-                # @param [String] domain_sid The unique string that that we created to identify
-                #   the SipDomain resource.
+                # @param [String] domain_sid The unique string that is created to identify the
+                #   SipDomain resource.
                 # @return [IpAccessControlListMappingList] IpAccessControlListMappingList
                 def initialize(version, account_sid: nil, domain_sid: nil)
                   super(version)
@@ -232,8 +232,8 @@ module Twilio
                 # @param [Hash] payload payload that contains response from Twilio
                 # @param [String] account_sid The unique id of the Account that is responsible for
                 #   this resource.
-                # @param [String] domain_sid The unique string that that we created to identify
-                #   the SipDomain resource.
+                # @param [String] domain_sid The unique string that is created to identify the
+                #   SipDomain resource.
                 # @param [String] sid A 34 character string that uniquely identifies the resource
                 #   to fetch.
                 # @return [IpAccessControlListMappingInstance] IpAccessControlListMappingInstance
@@ -245,10 +245,10 @@ module Twilio
                       'account_sid' => payload['account_sid'],
                       'date_created' => Twilio.deserialize_rfc2822(payload['date_created']),
                       'date_updated' => Twilio.deserialize_rfc2822(payload['date_updated']),
+                      'domain_sid' => payload['domain_sid'],
                       'friendly_name' => payload['friendly_name'],
                       'sid' => payload['sid'],
                       'uri' => payload['uri'],
-                      'subresource_uris' => payload['subresource_uris'],
                   }
 
                   # Context
@@ -294,6 +294,12 @@ module Twilio
                   @properties['date_updated']
                 end
 
+                ##
+                # @return [String] The unique string that identifies the SipDomain resource.
+                def domain_sid
+                  @properties['domain_sid']
+                end
+
                 ##
                 # @return [String] A human readable descriptive text for this resource, up to 64 characters long.
                 def friendly_name
@@ -312,12 +318,6 @@ module Twilio
                   @properties['uri']
                 end
 
-                ##
-                # @return [String] The list of IP addresses associated with this domain.
-                def subresource_uris
-                  @properties['subresource_uris']
-                end
-
                 ##
                 # Fetch the IpAccessControlListMappingInstance
                 # @return [IpAccessControlListMappingInstance] Fetched IpAccessControlListMappingInstance

data/lib/twilio-ruby/rest/conversations/v1/conversation/message.rb

@@ -63,6 +63,8 @@ module Twilio
             # Lists MessageInstance records from the API as a list.
             # Unlike stream(), this operation is eager and will load `limit` records into
             # memory before returning.
+            # @param [message.OrderType] order The sort order of the returned messages. Can
+            #   be: `asc` (ascending) or `desc` (descending), with `asc` as the default.
             # @param [Integer] limit Upper limit for the number of records to return. stream()
             #    guarantees to never return more than limit.  Default is no limit
             # @param [Integer] page_size Number of records to fetch per request, when
@@ -70,14 +72,16 @@ module Twilio
             #    but a limit is defined, stream() will attempt to read the limit with the most
             #    efficient page size, i.e. min(limit, 1000)
             # @return [Array] Array of up to limit results
-            def list(limit: nil, page_size: nil)
-              self.stream(limit: limit, page_size: page_size).entries
+            def list(order: :unset, limit: nil, page_size: nil)
+              self.stream(order: order, limit: limit, page_size: page_size).entries
             end
 
             ##
             # Streams MessageInstance records from the API as an Enumerable.
             # This operation lazily loads records as efficiently as possible until the limit
             # is reached.
+            # @param [message.OrderType] order The sort order of the returned messages. Can
+            #   be: `asc` (ascending) or `desc` (descending), with `asc` as the default.
             # @param [Integer] limit Upper limit for the number of records to return. stream()
             #    guarantees to never return more than limit. Default is no limit.
             # @param [Integer] page_size Number of records to fetch per request, when
@@ -85,10 +89,10 @@ module Twilio
             #    but a limit is defined, stream() will attempt to read the limit with the most
             #    efficient page size, i.e. min(limit, 1000)
             # @return [Enumerable] Enumerable that will yield up to limit results
-            def stream(limit: nil, page_size: nil)
+            def stream(order: :unset, limit: nil, page_size: nil)
               limits = @version.read_limits(limit, page_size)
 
-              page = self.page(page_size: limits[:page_size], )
+              page = self.page(order: order, page_size: limits[:page_size], )
 
               @version.stream(page, limit: limits[:limit], page_limit: limits[:page_limit])
             end
@@ -110,12 +114,15 @@ module Twilio
             ##
             # Retrieve a single page of MessageInstance records from the API.
             # Request is executed immediately.
+            # @param [message.OrderType] order The sort order of the returned messages. Can
+            #   be: `asc` (ascending) or `desc` (descending), with `asc` as the default.
             # @param [String] page_token PageToken provided by the API
             # @param [Integer] page_number Page Number, this value is simply for client state
             # @param [Integer] page_size Number of records to return, defaults to 50
             # @return [Page] Page of MessageInstance
-            def page(page_token: :unset, page_number: :unset, page_size: :unset)
+            def page(order: :unset, page_token: :unset, page_number: :unset, page_size: :unset)
               params = Twilio::Values.of({
+                  'Order' => order,
                   'PageToken' => page_token,
                   'Page' => page_number,
                   'PageSize' => page_size,

data/lib/twilio-ruby/rest/conversations/v1/service/conversation/message.rb

@@ -72,6 +72,8 @@ module Twilio
               # Lists MessageInstance records from the API as a list.
               # Unlike stream(), this operation is eager and will load `limit` records into
               # memory before returning.
+              # @param [message.OrderType] order The sort order of the returned messages. Can
+              #   be: `asc` (ascending) or `desc` (descending), with `asc` as the default.
               # @param [Integer] limit Upper limit for the number of records to return. stream()
               #    guarantees to never return more than limit.  Default is no limit
               # @param [Integer] page_size Number of records to fetch per request, when
@@ -79,14 +81,16 @@ module Twilio
               #    but a limit is defined, stream() will attempt to read the limit with the most
               #    efficient page size, i.e. min(limit, 1000)
               # @return [Array] Array of up to limit results
-              def list(limit: nil, page_size: nil)
-                self.stream(limit: limit, page_size: page_size).entries
+              def list(order: :unset, limit: nil, page_size: nil)
+                self.stream(order: order, limit: limit, page_size: page_size).entries
               end
 
               ##
               # Streams MessageInstance records from the API as an Enumerable.
               # This operation lazily loads records as efficiently as possible until the limit
               # is reached.
+              # @param [message.OrderType] order The sort order of the returned messages. Can
+              #   be: `asc` (ascending) or `desc` (descending), with `asc` as the default.
               # @param [Integer] limit Upper limit for the number of records to return. stream()
               #    guarantees to never return more than limit. Default is no limit.
               # @param [Integer] page_size Number of records to fetch per request, when
@@ -94,10 +98,10 @@ module Twilio
               #    but a limit is defined, stream() will attempt to read the limit with the most
               #    efficient page size, i.e. min(limit, 1000)
               # @return [Enumerable] Enumerable that will yield up to limit results
-              def stream(limit: nil, page_size: nil)
+              def stream(order: :unset, limit: nil, page_size: nil)
                 limits = @version.read_limits(limit, page_size)
 
-                page = self.page(page_size: limits[:page_size], )
+                page = self.page(order: order, page_size: limits[:page_size], )
 
                 @version.stream(page, limit: limits[:limit], page_limit: limits[:page_limit])
               end
@@ -119,12 +123,15 @@ module Twilio
               ##
               # Retrieve a single page of MessageInstance records from the API.
               # Request is executed immediately.
+              # @param [message.OrderType] order The sort order of the returned messages. Can
+              #   be: `asc` (ascending) or `desc` (descending), with `asc` as the default.
               # @param [String] page_token PageToken provided by the API
               # @param [Integer] page_number Page Number, this value is simply for client state
               # @param [Integer] page_size Number of records to return, defaults to 50
               # @return [Page] Page of MessageInstance
-              def page(page_token: :unset, page_number: :unset, page_size: :unset)
+              def page(order: :unset, page_token: :unset, page_number: :unset, page_size: :unset)
                 params = Twilio::Values.of({
+                    'Order' => order,
                     'PageToken' => page_token,
                     'Page' => page_number,
                     'PageSize' => page_size,