twilio-ruby 5.26.0 → 5.27.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA256:
-  metadata.gz: 55c89da2b5143eb59bd22cd782d0e30f6dbb6aaceccf75c7c8f39f4909025163
-  data.tar.gz: 42e084bbdade6e00d00a2bc48d349f3192ae0743b0fa4e94e762303845aa2a8a
+SHA1:
+  metadata.gz: baa7dce555a4ad4de4227461d7a72ec110497c8b
+  data.tar.gz: bbc2be81ddf4ba27d70771882365d9a7e6f37e1e
 SHA512:
-  metadata.gz: 96053dc3a647f44894727c1497d0dc866a27bae51f84bfddf53a85bc9a306250b929f29e271ddcd7a61ed46f65bb541fbe8ba6e851303d4015ef8a634fa531f0
-  data.tar.gz: 8021f6aad6b54029a6e5ded5280e72b8d918d6c1c74e3819cccf8deb809df3f3340e3a762cbe7d25354de17e0e370fab4edeb0ec8419d807aa76e3a7108ae10b
+  metadata.gz: a5346f6f6ca92b82f445cd38581da67d1db3fd3c4dd23b8e05c14a59473ce2bf6e4cc523b070bd747d01391ec14bb9c2219a4383eeba01878f7dc08c83e1edf0
+  data.tar.gz: 9c4308bdc71dc730ec1aee203759aa5d0c00f56889efe315d37b0e95cef5a0d0cc6e338923afd0ebbdba1fd6fcd0c0a511a64a2c31a733bfc60bae34d1b353eb

data/.travis.yml

@@ -5,11 +5,10 @@ bundler_args: --without development
 
 rvm:
   - ruby-head
-  - 2.5.0
-  - 2.4.0
-  - 2.3.0
-  - 2.2.0
-  - jruby-9.1.9.0
+  - 2.6
+  - 2.5
+  - 2.4
+  - jruby
 
 services:
   - docker
@@ -26,4 +25,4 @@ deploy:
   skip_cleanup: true
   on:
     tags: true
-    rvm: "2.4.0"
+    rvm: "2.4"

data/CHANGES.md

@@ -1,6 +1,27 @@
 twilio-ruby changelog
 =====================
 
+[2019-09-18] Version 5.27.0
+----------------------------
+**Library**
+- [PR #470](https://github.com/twilio/twilio-ruby/pull/470): breaking: Catch and wrap Faraday client errors. Thanks to [@childish-sambino](https://github.com/childish-sambino)! **(breaking change)**
+- [PR #471](https://github.com/twilio/twilio-ruby/pull/471): Drop support for Ruby < 2.4 and add 2.6. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+- [PR #468](https://github.com/twilio/twilio-ruby/pull/468): Add URI encoding for phone numbers. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+- [PR #469](https://github.com/twilio/twilio-ruby/pull/469): Add TwiML FaxResponse require to top-level file. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+- [PR #450](https://github.com/twilio/twilio-ruby/pull/450): Update encode64 to strict_encode64 in RequestValidator#build_signature_for. Thanks to [@kitallis](https://github.com/kitallis)!
+- [PR #467](https://github.com/twilio/twilio-ruby/pull/467): Add a global configuration for the HTTP client. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+- [PR #466](https://github.com/twilio/twilio-ruby/pull/466): Use the 'base_url' instead of the 'host' for HTTP client URL. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+
+**Numbers**
+- Add v2 of the Identites API
+
+**Preview**
+- Changed authentication method for SDK Trusted Comms endpoints: `/CPS`, `/CurrentCall`, and `/Devices`. Please use `Authorization: Bearer <xCNAM JWT>` **(breaking change)**
+
+**Voice**
+- Add Recordings endpoints
+
+
 [2019-09-04] Version 5.26.0
 ----------------------------
 **Library**

data/README.md

@@ -29,13 +29,13 @@ in-line code documentation here in the library.
 To install using [Bundler][bundler] grab the latest stable version:
 
 ```ruby
-gem 'twilio-ruby', '~> 5.26.0'
+gem 'twilio-ruby', '~> 5.27.0'
 ```
 
 To manually install `twilio-ruby` via [Rubygems][rubygems] simply gem install:
 
 ```bash
-gem install twilio-ruby -v 5.26.0
+gem install twilio-ruby -v 5.27.0
 ```
 
 To build and install the development branch yourself from the latest source:
@@ -46,6 +46,10 @@ cd twilio-ruby
 make install
 ```
 
+## Versions
+
+`twilio-ruby` uses a modified version of [Semantic Versioning](https://semver.org) for all changes. [See this document](VERSIONS.md) for details.
+
 ### Migration from 4.x
 
 [Upgrade Guide][upgrade]
@@ -78,7 +82,7 @@ auth_token = 'yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy'
 ### Make a Call
 
 ```ruby
-@client.api.account.calls.create(
+@client.calls.create(
   from: '+14159341234',
   to: '+16105557069',
   url: 'http://example.com'
@@ -88,7 +92,7 @@ auth_token = 'yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy'
 ### Send an SMS
 
 ```ruby
-@client.api.account.messages.create(
+@client.messages.create(
   from: '+14159341234',
   to: '+16105557069',
   body: 'Hey there!'
@@ -98,7 +102,7 @@ auth_token = 'yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy'
 ### List your SMS Messages
 
 ```ruby
-@client.api.account.messages.list
+@client.messages.list(limit: 20)
 ```
 
 ### Fetch a single SMS message by Sid
@@ -106,22 +110,30 @@ auth_token = 'yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy'
 ```ruby
 # put the message sid you want to retrieve here:
 message_sid = 'SMxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
-@client.api.account.messages(message_sid).fetch
+@client.messages(message_sid).fetch
 ```
 
 ### Customizing your HTTP Client
 
-twilio-ruby uses [Faraday][faraday] to make HTTP requests. You can tell
-Twilio::REST::Client to use any of the Faraday adapters like so:
+`twilio-ruby` uses [Faraday][faraday] to make HTTP requests. You can tell `Twilio::REST::Client` to use any of the Faraday adapters like so:
 
 ```ruby
 @client.http_client.adapter = :typhoeus
 ```
 
-## Getting Started With Client Capability Tokens
+### Handling Errors
+
+```ruby
+begin
+  messages = @client.messages.list(limit: 20)
+rescue Twilio::REST::TwilioError => e
+  puts e.message
+end
+```
+
+### Getting Started With Client Capability Tokens
 
-If you just need to generate a Capability Token for use with Twilio Client, you
-can do this:
+If you just need to generate a Capability Token for use with Twilio Client, you can do this:
 
 ```ruby
 require 'twilio-ruby'
@@ -145,8 +157,7 @@ capability.add_scope(incoming_scope)
 @token = capability.to_s
 ```
 
-There is a slightly more detailed document in the [Capability][capability]
-section of the wiki.
+There is a slightly more detailed document in the [Capability][capability] section of the wiki.
 
 ### Generating TwiML
 
@@ -182,13 +193,11 @@ This will print the following (except for the whitespace):
 
 ## Supported Ruby Versions
 
-This library supports and is [tested against][travis] the following Ruby
-implementations:
+This library supports and is [tested against][travis] the following Ruby implementations:
 
-- Ruby 2.5.0
-- Ruby 2.4.0
-- Ruby 2.3.0
-- Ruby 2.2.0
+- Ruby 2.6.X
+- Ruby 2.5.X
+- Ruby 2.4.X
 
 [apidocs]: https://www.twilio.com/docs/api
 [twiml]: https://www.twilio.com/docs/api/twiml

data/VERSIONS.md

@@ -5,11 +5,11 @@ all changes to the helper library. It is strongly encouraged that you pin at
 least the major version and potentially the minor version to avoid pulling in
 breaking changes.
 
-Semantic Versions take the form of `MAJOR`.`MINOR`.`PATCH`
+Semantic Versions take the form of `MAJOR.MINOR.PATCH`
 
-When bugs are fixed in the library in a backwards compatible way, the `PATCH`
+When bugs are fixed in the library in a backwards-compatible way, the `PATCH`
 level will be incremented by one. When new features are added to the library
-in a backwards compatible way, the `PATCH` level will be incremented by one.
+in a backwards-compatible way, the `PATCH` level will be incremented by one.
 `PATCH` changes should _not_ break your code and are generally safe for upgrade.
 
 When a new large feature set comes online or a small breaking change is
@@ -19,8 +19,8 @@ change for upgrade. These backwards-incompatible changes will generally be
 limited to a small number of function signature changes.
 
 The `MAJOR` version is used to indicate the family of technology represented by
-the helper library. Breaking changes that requires extensive reworking of code
-will case the `MAJOR` version to be incremented by one, and the `MINOR` and
+the helper library. Breaking changes that require extensive reworking of code
+will cause the `MAJOR` version to be incremented by one, and the `MINOR` and
 `PATCH` versions will be reset to zero. Twilio understands that this can be very
 disruptive, so we will only introduce this type of breaking change when
 absolutely necessary. New `MAJOR` versions will be communicated in advance with
@@ -28,9 +28,8 @@ absolutely necessary. New `MAJOR` versions will be communicated in advance with
 
 ## Supported Versions
 
-`twilio-ruby` follows an evergreen model of support. New features and
-functionality will only be added to the current version. The current version -
-1 will continue to be supported with bug fixes and security updates, but no new
-features.
+Only the current `MAJOR` version of `twilio-ruby` is supported. New
+features, functionality, bug fixes, and security updates will only be added to
+the current `MAJOR` version.
 
-[semver]: http://semver.org/
+[semver]: https://semver.org

data/lib/twilio-ruby.rb

@@ -23,8 +23,9 @@ require 'twilio-ruby/security/request_validator'
 require 'twilio-ruby/util/configuration'
 
 require 'twilio-ruby/twiml/twiml'
-require 'twilio-ruby/twiml/voice_response'
+require 'twilio-ruby/twiml/fax_response'
 require 'twilio-ruby/twiml/messaging_response'
+require 'twilio-ruby/twiml/voice_response'
 
 Dir[File.dirname(__FILE__) + '/twilio-ruby/http/**/*.rb'].each do |file|
   require file
@@ -45,7 +46,7 @@ end
 module Twilio
   extend SingleForwardable
 
-  def_delegators :configuration, :account_sid, :auth_token
+  def_delegators :configuration, :account_sid, :auth_token, :http_client
 
   ##
   # Pre-configure with account SID and auth token so that you don't need to
@@ -59,5 +60,6 @@ module Twilio
   def self.configuration
     @configuration ||= Util::Configuration.new
   end
+
   private_class_method :configuration
 end

data/lib/twilio-ruby/framework/domain.rb

@@ -20,7 +20,7 @@ module Twilio
         url = uri.match(/^http/) ? uri : absolute_url(uri)
 
         @client.request(
-          @host,
+          @base_url,
           @port,
           method,
           url,

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

@@ -36,10 +36,8 @@ module Twilio
 
         @last_request = request
         @last_response = nil
-        response = @connection.send(request.method.downcase.to_sym,
-                                    request.url,
-                                    request.method == 'GET' ? request.params : request.data)
 
+        response = send(request)
         if response.body && !response.body.empty?
           object = response.body
         elsif response.status == 400
@@ -52,6 +50,14 @@ module Twilio
         twilio_response
       end
 
+      def send(request)
+        @connection.send(request.method.downcase.to_sym,
+                         request.url,
+                         request.method == 'GET' ? request.params : request.data)
+      rescue Faraday::ClientError => e
+        raise Twilio::REST::TwilioError, e
+      end
+
       def request(host, port, method, url, params = {}, data = {}, headers = {}, auth = nil, timeout = nil)
         request = Twilio::Request.new(host, port, method, url, params, data, headers, auth, timeout)
         _request(request)

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

@@ -16,7 +16,7 @@ module Twilio
             # Initialize the AddressList
             # @param [Version] version Version that contains the resource
             # @param [String] account_sid The SID of the
-            #   [Account](https://www.twilio.com/docs/api/rest/account) that is responsible for
+            #   [Account](https://www.twilio.com/docs/iam/api/account) that is responsible for
             #   the Address resource.
             # @return [AddressList] AddressList
             def initialize(version, account_sid: nil)
@@ -222,7 +222,7 @@ module Twilio
             # Initialize the AddressContext
             # @param [Version] version Version that contains the resource
             # @param [String] account_sid The SID of the
-            #   [Account](https://www.twilio.com/docs/api/rest/account) that is responsible for
+            #   [Account](https://www.twilio.com/docs/iam/api/account) that is responsible for
             #   the Address resource to fetch.
             # @param [String] sid The Twilio-provided string that uniquely identifies the
             #   Address resource to fetch.
@@ -334,7 +334,7 @@ module Twilio
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
             # @param [String] account_sid The SID of the
-            #   [Account](https://www.twilio.com/docs/api/rest/account) that is responsible for
+            #   [Account](https://www.twilio.com/docs/iam/api/account) that is responsible for
             #   the Address resource.
             # @param [String] sid The Twilio-provided string that uniquely identifies the
             #   Address resource to fetch.

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

@@ -17,7 +17,7 @@ module Twilio
               # Initialize the DependentPhoneNumberList
               # @param [Version] version Version that contains the resource
               # @param [String] account_sid The SID of the
-              #   [Account](https://www.twilio.com/docs/api/rest/account) that created the
+              #   [Account](https://www.twilio.com/docs/iam/api/account) that created the
               #   DependentPhoneNumber resource.
               # @param [String] address_sid The unique string that that we created to identify
               #   the Address resource.
@@ -159,7 +159,7 @@ module Twilio
               # @param [Version] version Version that contains the resource
               # @param [Hash] payload payload that contains response from Twilio
               # @param [String] account_sid The SID of the
-              #   [Account](https://www.twilio.com/docs/api/rest/account) that created the
+              #   [Account](https://www.twilio.com/docs/iam/api/account) that created the
               #   DependentPhoneNumber resource.
               # @param [String] address_sid The unique string that that we created to identify
               #   the Address resource.

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

@@ -16,7 +16,7 @@ module Twilio
             # Initialize the ApplicationList
             # @param [Version] version Version that contains the resource
             # @param [String] account_sid The SID of the
-            #   [Account](https://www.twilio.com/docs/api/rest/account) that created the
+            #   [Account](https://www.twilio.com/docs/iam/api/account) that created the
             #   Application resource.
             # @return [ApplicationList] ApplicationList
             def initialize(version, account_sid: nil)
@@ -221,7 +221,7 @@ module Twilio
             # Initialize the ApplicationContext
             # @param [Version] version Version that contains the resource
             # @param [String] account_sid The SID of the
-            #   [Account](https://www.twilio.com/docs/api/rest/account) that created the
+            #   [Account](https://www.twilio.com/docs/iam/api/account) that created the
             #   Application resource to fetch.
             # @param [String] sid The Twilio-provided string that uniquely identifies the
             #   Application resource to fetch.
@@ -350,7 +350,7 @@ module Twilio
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
             # @param [String] account_sid The SID of the
-            #   [Account](https://www.twilio.com/docs/api/rest/account) that created the
+            #   [Account](https://www.twilio.com/docs/iam/api/account) that created the
             #   Application resource.
             # @param [String] sid The Twilio-provided string that uniquely identifies the
             #   Application resource to fetch.

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

@@ -16,7 +16,7 @@ module Twilio
             # Initialize the AuthorizedConnectAppList
             # @param [Version] version Version that contains the resource
             # @param [String] account_sid The SID of the
-            #   [Account](https://www.twilio.com/docs/api/rest/account) that created the
+            #   [Account](https://www.twilio.com/docs/iam/api/account) that created the
             #   AuthorizedConnectApp resource.
             # @return [AuthorizedConnectAppList] AuthorizedConnectAppList
             def initialize(version, account_sid: nil)
@@ -150,7 +150,7 @@ module Twilio
             # Initialize the AuthorizedConnectAppContext
             # @param [Version] version Version that contains the resource
             # @param [String] account_sid The SID of the
-            #   [Account](https://www.twilio.com/docs/api/rest/account) that created the
+            #   [Account](https://www.twilio.com/docs/iam/api/account) that created the
             #   AuthorizedConnectApp resource to fetch.
             # @param [String] connect_app_sid The SID of the Connect App to fetch.
             # @return [AuthorizedConnectAppContext] AuthorizedConnectAppContext
@@ -203,7 +203,7 @@ module Twilio
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
             # @param [String] account_sid The SID of the
-            #   [Account](https://www.twilio.com/docs/api/rest/account) that created the
+            #   [Account](https://www.twilio.com/docs/iam/api/account) that created the
             #   AuthorizedConnectApp resource.
             # @param [String] connect_app_sid The SID of the Connect App to fetch.
             # @return [AuthorizedConnectAppInstance] AuthorizedConnectAppInstance

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

@@ -149,7 +149,7 @@ module Twilio
             # Initialize the AvailablePhoneNumberCountryContext
             # @param [Version] version Version that contains the resource
             # @param [String] account_sid The SID of the
-            #   [Account](https://www.twilio.com/docs/api/rest/account) requesting the available
+            #   [Account](https://www.twilio.com/docs/iam/api/account) requesting the available
             #   phone number Country resource.
             # @param [String] country_code The
             #   [ISO-3166-1](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code of

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

@@ -38,7 +38,7 @@ module Twilio
               # @param [String] contains The pattern on which to match phone numbers. Valid
               #   characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any
               #   single digit. For examples, see [Example
-              #   2](https://www.twilio.com/docs/api/rest/available-phone-numbers#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/api/rest/available-phone-numbers#local-get-basic-example-3). If specified, this value must have at least two characters.
+              #   2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3). If specified, this value must have at least two characters.
               # @param [Boolean] sms_enabled Whether the phone numbers can receive text
               #   messages. Can be: `true` or `false`.
               # @param [Boolean] mms_enabled Whether the phone numbers can receive MMS messages.
@@ -46,14 +46,14 @@ module Twilio
               # @param [Boolean] voice_enabled Whether the phone numbers can receive calls. Can
               #   be: `true` or `false`.
               # @param [Boolean] exclude_all_address_required Whether to exclude phone numbers
-              #   that require an [Address](https://www.twilio.com/docs/usage/api/addresses). Can
+              #   that require an [Address](https://www.twilio.com/docs/usage/api/address). Can
               #   be: `true` or `false` and the default is `false`.
               # @param [Boolean] exclude_local_address_required Whether to exclude phone numbers
-              #   that require a local [Address](https://www.twilio.com/docs/usage/api/addresses).
+              #   that require a local [Address](https://www.twilio.com/docs/usage/api/address).
               #   Can be: `true` or `false` and the default is `false`.
               # @param [Boolean] exclude_foreign_address_required Whether to exclude phone
               #   numbers that require a foreign
-              #   [Address](https://www.twilio.com/docs/usage/api/addresses). Can be: `true` or
+              #   [Address](https://www.twilio.com/docs/usage/api/address). Can be: `true` or
               #   `false` and the default is `false`.
               # @param [Boolean] beta Whether to read phone numbers that are new to the Twilio
               #   platform. Can be: `true` or `false` and the default is `true`.
@@ -76,9 +76,9 @@ module Twilio
               #   a phone number search within the same rate center as that number. Requires
               #   `in_lata` to be set as well. Applies to only phone numbers in the US and Canada.
               # @param [String] in_lata Limit results to a specific local access and transport
-              #   area ([LATA](http://en.wikipedia.org/wiki/Local_access_and_transport_area)).
+              #   area ([LATA](https://en.wikipedia.org/wiki/Local_access_and_transport_area)).
               #   Given a phone number, search within the same
-              #   [LATA](http://en.wikipedia.org/wiki/Local_access_and_transport_area) as that
+              #   [LATA](https://en.wikipedia.org/wiki/Local_access_and_transport_area) as that
               #   number. Applies to only phone numbers in the US and Canada.
               # @param [String] in_locality Limit results to a particular locality or city.
               #   Given a phone number, search within the same Locality as that number.
@@ -125,7 +125,7 @@ module Twilio
               # @param [String] contains The pattern on which to match phone numbers. Valid
               #   characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any
               #   single digit. For examples, see [Example
-              #   2](https://www.twilio.com/docs/api/rest/available-phone-numbers#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/api/rest/available-phone-numbers#local-get-basic-example-3). If specified, this value must have at least two characters.
+              #   2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3). If specified, this value must have at least two characters.
               # @param [Boolean] sms_enabled Whether the phone numbers can receive text
               #   messages. Can be: `true` or `false`.
               # @param [Boolean] mms_enabled Whether the phone numbers can receive MMS messages.
@@ -133,14 +133,14 @@ module Twilio
               # @param [Boolean] voice_enabled Whether the phone numbers can receive calls. Can
               #   be: `true` or `false`.
               # @param [Boolean] exclude_all_address_required Whether to exclude phone numbers
-              #   that require an [Address](https://www.twilio.com/docs/usage/api/addresses). Can
+              #   that require an [Address](https://www.twilio.com/docs/usage/api/address). Can
               #   be: `true` or `false` and the default is `false`.
               # @param [Boolean] exclude_local_address_required Whether to exclude phone numbers
-              #   that require a local [Address](https://www.twilio.com/docs/usage/api/addresses).
+              #   that require a local [Address](https://www.twilio.com/docs/usage/api/address).
               #   Can be: `true` or `false` and the default is `false`.
               # @param [Boolean] exclude_foreign_address_required Whether to exclude phone
               #   numbers that require a foreign
-              #   [Address](https://www.twilio.com/docs/usage/api/addresses). Can be: `true` or
+              #   [Address](https://www.twilio.com/docs/usage/api/address). Can be: `true` or
               #   `false` and the default is `false`.
               # @param [Boolean] beta Whether to read phone numbers that are new to the Twilio
               #   platform. Can be: `true` or `false` and the default is `true`.
@@ -163,9 +163,9 @@ module Twilio
               #   a phone number search within the same rate center as that number. Requires
               #   `in_lata` to be set as well. Applies to only phone numbers in the US and Canada.
               # @param [String] in_lata Limit results to a specific local access and transport
-              #   area ([LATA](http://en.wikipedia.org/wiki/Local_access_and_transport_area)).
+              #   area ([LATA](https://en.wikipedia.org/wiki/Local_access_and_transport_area)).
               #   Given a phone number, search within the same
-              #   [LATA](http://en.wikipedia.org/wiki/Local_access_and_transport_area) as that
+              #   [LATA](https://en.wikipedia.org/wiki/Local_access_and_transport_area) as that
               #   number. Applies to only phone numbers in the US and Canada.
               # @param [String] in_locality Limit results to a particular locality or city.
               #   Given a phone number, search within the same Locality as that number.
@@ -228,7 +228,7 @@ module Twilio
               # @param [String] contains The pattern on which to match phone numbers. Valid
               #   characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any
               #   single digit. For examples, see [Example
-              #   2](https://www.twilio.com/docs/api/rest/available-phone-numbers#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/api/rest/available-phone-numbers#local-get-basic-example-3). If specified, this value must have at least two characters.
+              #   2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3). If specified, this value must have at least two characters.
               # @param [Boolean] sms_enabled Whether the phone numbers can receive text
               #   messages. Can be: `true` or `false`.
               # @param [Boolean] mms_enabled Whether the phone numbers can receive MMS messages.
@@ -236,14 +236,14 @@ module Twilio
               # @param [Boolean] voice_enabled Whether the phone numbers can receive calls. Can
               #   be: `true` or `false`.
               # @param [Boolean] exclude_all_address_required Whether to exclude phone numbers
-              #   that require an [Address](https://www.twilio.com/docs/usage/api/addresses). Can
+              #   that require an [Address](https://www.twilio.com/docs/usage/api/address). Can
               #   be: `true` or `false` and the default is `false`.
               # @param [Boolean] exclude_local_address_required Whether to exclude phone numbers
-              #   that require a local [Address](https://www.twilio.com/docs/usage/api/addresses).
+              #   that require a local [Address](https://www.twilio.com/docs/usage/api/address).
               #   Can be: `true` or `false` and the default is `false`.
               # @param [Boolean] exclude_foreign_address_required Whether to exclude phone
               #   numbers that require a foreign
-              #   [Address](https://www.twilio.com/docs/usage/api/addresses). Can be: `true` or
+              #   [Address](https://www.twilio.com/docs/usage/api/address). Can be: `true` or
               #   `false` and the default is `false`.
               # @param [Boolean] beta Whether to read phone numbers that are new to the Twilio
               #   platform. Can be: `true` or `false` and the default is `true`.
@@ -266,9 +266,9 @@ module Twilio
               #   a phone number search within the same rate center as that number. Requires
               #   `in_lata` to be set as well. Applies to only phone numbers in the US and Canada.
               # @param [String] in_lata Limit results to a specific local access and transport
-              #   area ([LATA](http://en.wikipedia.org/wiki/Local_access_and_transport_area)).
+              #   area ([LATA](https://en.wikipedia.org/wiki/Local_access_and_transport_area)).
               #   Given a phone number, search within the same
-              #   [LATA](http://en.wikipedia.org/wiki/Local_access_and_transport_area) as that
+              #   [LATA](https://en.wikipedia.org/wiki/Local_access_and_transport_area) as that
               #   number. Applies to only phone numbers in the US and Canada.
               # @param [String] in_locality Limit results to a particular locality or city.
               #   Given a phone number, search within the same Locality as that number.