twilio-ruby 5.39.3 → 5.40.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 841eb384db83b5c1a3a721c97098684d75d6d5b1ffb859131406d021a4622979
-  data.tar.gz: 7947f0f1a27572f6fc89029d822b58e91c7f27e60f04382a396677afdad1155c
+  metadata.gz: 8479716e0775fc4f9ba20ccb92d92b9207c8363c100206df4329034f40e9c822
+  data.tar.gz: 9ecf86d0fe73d49a94d2c8e2e9d1712ee9270e73286ceb92edc2e1a1d35fb19f
 SHA512:
-  metadata.gz: b87be38b318fd24a402aaadb4127a34813380889563b77f6b531bcb63d02990f4de2b68fbe10d76bcc1ce6c81889e31922533094efbeb2510b5653b7a52d5453
-  data.tar.gz: 1a054d5e499e9561aa6549dcf63b93da6890e34e99d0449ad8d61bd3cfbde7f79cc4e4c61e0d58a51a463fe735a708b46b38cd264c7f8f4f1d0d1ce6b5c6bd8b
+  metadata.gz: 408171ca407783e4586f23471770f92633719e331c3853a7a3843250c8f58165494c72369e055919efb3330dc69b16798de1ec5c9db77cdd91a594eb4b8dac8d
+  data.tar.gz: c345b99f3215e4ac16eeb294986e13a8adf94c84ef74066713ec75afe2724956bd04fe7c1d46a4b11a4ef6df4613d155ccb3c442f5ab0a61b88a9f49197ad330

data/CHANGES.md

@@ -1,6 +1,117 @@
 twilio-ruby changelog
 =====================
 
+[2020-09-28] Version 5.40.4
+---------------------------
+**Library - Docs**
+- [PR #535](https://github.com/twilio/twilio-ruby/pull/535): convert markdown links to RDoc formatted links. Thanks to [@JenniferMah](https://github.com/JenniferMah)!
+
+**Api**
+- Add optional property `call_reason` in the participant create request
+- Make sip-domain-service endpoints available in stage-au1 and prod-au1
+
+**Messaging**
+- Removed beta feature gate from WhatsApp Templates API
+
+**Serverless**
+- Add Build Status endpoint
+
+**Video**
+- [Rooms] Add new room type "go" for WebRTC Go
+
+
+[2020-09-21] Version 5.40.3
+---------------------------
+**Library - Fix**
+- [PR #534](https://github.com/twilio/twilio-ruby/pull/534): allow API redirect responses. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+
+**Accounts**
+- Add Auth Token rotation API
+
+**Conversations**
+- Change resource path for Webhook Configuration
+
+**Events**
+- Schemas API get all Schemas names and versions
+
+
+[2020-09-16] Version 5.40.2
+---------------------------
+**Library - Fix**
+- [PR #530](https://github.com/twilio/twilio-ruby/pull/530): drop the page limit calculation. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+
+**Conversations**
+- Expose Configuration and Service Configuration resources
+- Add Unique Name support for Conversations
+- Add Services Push Notification resource
+- Add Service scoped Conversation resources
+- Support Identity in Users resource endpoint
+
+**Messaging**
+- GA Deactivation List API
+- Add domain cert API's(fetch, update, create) for link tracker
+
+**Numbers**
+- Add API endpoint for Supporting Document deletion
+
+**Proxy**
+- Updated usage of FailOnParticipantConflict param to apply only to accounts with ProxyAllowParticipantConflict account flag
+
+**Supersim**
+- Add `AccountSid` parameter to Sim resource update request
+- Add `ready` status as an available status for a Sim resource
+
+
+[2020-09-02] Version 5.40.1
+---------------------------
+**Library - Chore**
+- [PR #529](https://github.com/twilio/twilio-ruby/pull/529): sort files for deterministic require order. Thanks to [@eshanholtz](https://github.com/eshanholtz)!
+
+**Ai**
+- Initial release
+
+**Bulkexports**
+- removing public beta feature flag from BulkExports Jobs API
+
+**Messaging**
+- Add Deactivation List API
+- Added page token parameter for fetch in WhatsApp Templates API
+
+**Numbers**
+- Add API endpoint for End User deletion
+
+**Routes**
+- Add Resource Route Configurations API
+- Add Route Configurations API
+- Initial Release
+
+**Trunking**
+- Added `transfer_mode` property on Trunks.
+
+
+[2020-08-19] Version 5.40.0
+---------------------------
+**Library - Chore**
+- [PR #526](https://github.com/twilio/twilio-ruby/pull/526): update GitHub branch references to use HEAD. Thanks to [@thinkingserious](https://github.com/thinkingserious)!
+
+**Conversations**
+- Allow Identity addition to Participants
+
+**Events**
+- Sinks API Get all Sinks
+
+**Proxy**
+- Clarified usage of FailOnParticipantConflict param as experimental
+- Add FailOnParticipantConflict param to Proxy Session create and Proxy Participant create
+
+**Supersim**
+- Add fleet, network, and isoCountryCode to the UsageRecords resource
+- Change sort order of UsageRecords from ascending to descending with respect to start time field, records are now returned newest to oldest
+
+**Wireless**
+- Removed `Start` and `End` parameters from the Data Sessions list endpoint. **(breaking change)**
+
+
 [2020-08-05] Version 5.39.3
 ---------------------------
 **Messaging**
@@ -504,7 +615,7 @@ twilio-ruby changelog
 **Library**
 - [PR #481](https://github.com/twilio/twilio-ruby/pull/481): added request validation for urls with and without ports. Thanks to [@eshanholtz](https://github.com/eshanholtz)!
 - [PR #480](https://github.com/twilio/twilio-ruby/pull/480): Update resources after sorting. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
-- [PR #479](https://github.com/twilio/twilio-ruby/pull/479): Auto-deploy via Travis CI upon tagged commit to master. Thanks to [@thinkingserious](https://github.com/thinkingserious)!
+- [PR #479](https://github.com/twilio/twilio-ruby/pull/479): Auto-deploy via Travis CI upon tagged commit to main. Thanks to [@thinkingserious](https://github.com/thinkingserious)!
 
 **Api**
 - Add new usage categories to the public api `sms-messages-carrierfees` and `mms-messages-carrierfees`

data/CONTRIBUTING.md

@@ -105,7 +105,7 @@ Before you submit your pull request consider the following guidelines:
 * Make your changes in a new git branch:
 
     ```shell
-    git checkout -b my-fix-branch master
+    git checkout -b my-fix-branch main
     ```
 
 * Create your patch, **including appropriate test cases**.
@@ -132,7 +132,7 @@ Before you submit your pull request consider the following guidelines:
     git push origin my-fix-branch
     ```
 
-In GitHub, send a pull request to `twilio-ruby:master`.
+In GitHub, send a pull request to `twilio-ruby:main`.
 If we suggest changes, then:
 
 * Make the required updates.

data/README.md

@@ -34,13 +34,13 @@ This library supports the following Ruby implementations:
 To install using [Bundler][bundler] grab the latest stable version:
 
 ```ruby
-gem 'twilio-ruby', '~> 5.39.3'
+gem 'twilio-ruby', '~> 5.40.4'
 ```
 
 To manually install `twilio-ruby` via [Rubygems][rubygems] simply gem install:
 
 ```bash
-gem install twilio-ruby -v 5.39.3
+gem install twilio-ruby -v 5.40.4
 ```
 
 To build and install the development branch yourself from the latest source:
@@ -214,7 +214,6 @@ If you've instead found a bug in the library or would like new features added, g
 [libdocs]: https://www.twilio.com/docs/libraries/ruby
 [refdocs]: https://twilio.github.io/twilio-ruby
 [capability]: https://github.com/twilio/twilio-ruby/wiki/JWT-Tokens
-[examples]: https://github.com/twilio/twilio-ruby/blob/master/examples
 [wiki]: https://github.com/twilio/twilio-ruby/wiki
 [bundler]: https://bundler.io
 [rubygems]: https://rubygems.org

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

@@ -68,7 +68,8 @@ module Twilio
           timeout
         )
 
-        if response.status_code < 200 || response.status_code >= 300
+        # Note that 3XX response codes are allowed for fetches.
+        if response.status_code < 200 || response.status_code >= 400
           raise exception(response, 'Unable to fetch record')
         end
 
@@ -112,18 +113,13 @@ module Twilio
       end
 
       def read_limits(limit = nil, page_size = nil)
-        page_limit = nil
-
-        unless limit.nil?
-          # If there is no user-specified page_size, pick the most network efficient size
+        unless limit.nil? || page_size
           page_size = limit
-          page_limit = (limit / page_size.to_f).ceil
         end
 
         {
           limit: limit || nil,
-          page_size: page_size || nil,
-          page_limit: page_limit
+          page_size: page_size || nil
         }
       end
 

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

@@ -71,7 +71,7 @@ module Twilio
 
       ##
       # @param [String] country_code The
-      #   [ISO-3166-1](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code of
+      #   {ISO-3166-1}[https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2] country code of
       #   the country.
       # @return [Twilio::REST::Api::V2010::AccountContext::AvailablePhoneNumberCountryInstance] if country_code was passed.
       # @return [Twilio::REST::Api::V2010::AccountContext::AvailablePhoneNumberCountryList]

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/iam/api/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)
@@ -215,7 +215,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/iam/api/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.
@@ -317,7 +317,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/iam/api/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/iam/api/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.
@@ -157,7 +157,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/iam/api/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/iam/api/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)
@@ -214,7 +214,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/iam/api/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.
@@ -278,8 +278,9 @@ module Twilio
             #   occurs while retrieving or executing the TwiML from `sms_url`.
             # @param [String] sms_fallback_method The HTTP method we should use to call
             #   `sms_fallback_url`. Can be: `GET` or `POST`.
-            # @param [String] sms_status_callback The URL we should call using a POST method
-            #   to send status information about SMS messages sent by the application.
+            # @param [String] sms_status_callback Same as message_status_callback: The URL we
+            #   should call using a POST method to send status information about SMS messages
+            #   sent by the application. Deprecated, included for backwards compatibility.
             # @param [String] message_status_callback The URL we should call using a POST
             #   method to send message status information to your application.
             # @return [ApplicationInstance] Updated ApplicationInstance
@@ -333,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/iam/api/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.
@@ -545,8 +546,9 @@ module Twilio
             #   occurs while retrieving or executing the TwiML from `sms_url`.
             # @param [String] sms_fallback_method The HTTP method we should use to call
             #   `sms_fallback_url`. Can be: `GET` or `POST`.
-            # @param [String] sms_status_callback The URL we should call using a POST method
-            #   to send status information about SMS messages sent by the application.
+            # @param [String] sms_status_callback Same as message_status_callback: The URL we
+            #   should call using a POST method to send status information about SMS messages
+            #   sent by the application. Deprecated, included for backwards compatibility.
             # @param [String] message_status_callback The URL we should call using a POST
             #   method to send message status information to your application.
             # @return [ApplicationInstance] Updated ApplicationInstance

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/iam/api/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)
@@ -148,7 +148,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/iam/api/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
@@ -195,7 +195,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/iam/api/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

@@ -147,10 +147,10 @@ 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/iam/api/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
+            #   {ISO-3166-1}[https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2] country code of
             #   the country to fetch available phone number information about.
             # @return [AvailablePhoneNumberCountryContext] AvailablePhoneNumberCountryContext
             def initialize(version, account_sid, country_code)
@@ -319,7 +319,7 @@ module Twilio
             # @param [String] account_sid A 34 character string that uniquely identifies this
             #   resource.
             # @param [String] country_code The
-            #   [ISO-3166-1](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code of
+            #   {ISO-3166-1}[https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2] country code of
             #   the country to fetch available phone number information about.
             # @return [AvailablePhoneNumberCountryInstance] AvailablePhoneNumberCountryInstance
             def initialize(version, payload, account_sid: nil, country_code: nil)

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

@@ -18,7 +18,7 @@ module Twilio
               # @param [Version] version Version that contains the resource
               # @param [String] account_sid The account_sid
               # @param [String] country_code The
-              #   [ISO-3166-1](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code of
+              #   {ISO-3166-1}[https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2] country code of
               #   the country.
               # @return [LocalList] LocalList
               def initialize(version, account_sid: nil, country_code: nil)
@@ -37,8 +37,11 @@ module Twilio
               #   only phone numbers in the US and Canada.
               # @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/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.
+              #   single digit. For examples, see {Example
+              #   2}[https://www.twilio.com/docs/phone-numbers/api/availablephonenumberlocal-resource?code-sample=code-find-phone-numbers-by-number-pattern]
+              #   and {Example
+              #   3}[https://www.twilio.com/docs/phone-numbers/api/availablephonenumberlocal-resource?code-sample=code-find-phone-numbers-by-character-pattern].
+              #   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 +49,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/address). 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/address).
+              #   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/address). 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 +79,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](https://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](https://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.
@@ -124,8 +127,11 @@ module Twilio
               #   only phone numbers in the US and Canada.
               # @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/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.
+              #   single digit. For examples, see {Example
+              #   2}[https://www.twilio.com/docs/phone-numbers/api/availablephonenumberlocal-resource?code-sample=code-find-phone-numbers-by-number-pattern]
+              #   and {Example
+              #   3}[https://www.twilio.com/docs/phone-numbers/api/availablephonenumberlocal-resource?code-sample=code-find-phone-numbers-by-character-pattern].
+              #   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 +139,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/address). 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/address).
+              #   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/address). 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 +169,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](https://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](https://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.
@@ -227,8 +233,11 @@ module Twilio
               #   only phone numbers in the US and Canada.
               # @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/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.
+              #   single digit. For examples, see {Example
+              #   2}[https://www.twilio.com/docs/phone-numbers/api/availablephonenumberlocal-resource?code-sample=code-find-phone-numbers-by-number-pattern]
+              #   and {Example
+              #   3}[https://www.twilio.com/docs/phone-numbers/api/availablephonenumberlocal-resource?code-sample=code-find-phone-numbers-by-character-pattern].
+              #   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 +245,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/address). 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/address).
+              #   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/address). 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 +275,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](https://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](https://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.
@@ -369,7 +378,7 @@ module Twilio
               # @param [Hash] payload payload that contains response from Twilio
               # @param [String] account_sid The account_sid
               # @param [String] country_code The
-              #   [ISO-3166-1](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code of
+              #   {ISO-3166-1}[https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2] country code of
               #   the country.
               # @return [LocalInstance] LocalInstance
               def initialize(version, payload, account_sid: nil, country_code: nil)