twilio-ruby 5.39.2 → 5.60.0

data/lib/twilio-ruby/rest/verify/v2/service/entity.rb

@@ -12,7 +12,7 @@ module Twilio
       class V2 < Version
         class ServiceContext < InstanceContext
           ##
-          # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
+          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class EntityList < ListResource
             ##
             # Initialize the EntityList
@@ -30,14 +30,14 @@ module Twilio
             ##
             # Create the EntityInstance
             # @param [String] identity The unique external identifier for the Entity of the
-            #   Service
-            # @param [String] twilio_sandbox_mode The Twilio-Sandbox-Mode HTTP request header
+            #   Service. This identifier should be immutable, not PII, length between 8 and 64
+            #   characters, and generated by your external system, such as your user's UUID,
+            #   GUID, or SID. It can only contain dash (-) separated alphanumeric characters.
             # @return [EntityInstance] Created EntityInstance
-            def create(identity: nil, twilio_sandbox_mode: :unset)
+            def create(identity: nil)
               data = Twilio::Values.of({'Identity' => identity, })
-              headers = Twilio::Values.of({'Twilio-Sandbox-Mode' => twilio_sandbox_mode, })
 
-              payload = @version.create('POST', @uri, data: data, headers: headers)
+              payload = @version.create('POST', @uri, data: data)
 
               EntityInstance.new(@version, payload, service_sid: @solution[:service_sid], )
             end
@@ -46,7 +46,6 @@ module Twilio
             # Lists EntityInstance records from the API as a list.
             # Unlike stream(), this operation is eager and will load `limit` records into
             # memory before returning.
-            # @param [String] twilio_sandbox_mode The Twilio-Sandbox-Mode HTTP request header
             # @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
@@ -54,15 +53,14 @@ 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(twilio_sandbox_mode: :unset, limit: nil, page_size: nil)
-              self.stream(twilio_sandbox_mode: twilio_sandbox_mode, limit: limit, page_size: page_size).entries
+            def list(limit: nil, page_size: nil)
+              self.stream(limit: limit, page_size: page_size).entries
             end
 
             ##
             # Streams EntityInstance records from the API as an Enumerable.
             # This operation lazily loads records as efficiently as possible until the limit
             # is reached.
-            # @param [String] twilio_sandbox_mode The Twilio-Sandbox-Mode HTTP request header
             # @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,10 +68,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(twilio_sandbox_mode: :unset, limit: nil, page_size: nil)
+            def stream(limit: nil, page_size: nil)
               limits = @version.read_limits(limit, page_size)
 
-              page = self.page(twilio_sandbox_mode: twilio_sandbox_mode, page_size: limits[:page_size], )
+              page = self.page(page_size: limits[:page_size], )
 
               @version.stream(page, limit: limits[:limit], page_limit: limits[:page_limit])
             end
@@ -95,20 +93,18 @@ module Twilio
             ##
             # Retrieve a single page of EntityInstance records from the API.
             # Request is executed immediately.
-            # @param [String] twilio_sandbox_mode The Twilio-Sandbox-Mode HTTP request header
             # @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 EntityInstance
-            def page(twilio_sandbox_mode: :unset, page_token: :unset, page_number: :unset, page_size: :unset)
+            def page(page_token: :unset, page_number: :unset, page_size: :unset)
               params = Twilio::Values.of({
                   'PageToken' => page_token,
                   'Page' => page_number,
                   'PageSize' => page_size,
               })
-              headers = Twilio::Values.of({'Twilio-Sandbox-Mode' => twilio_sandbox_mode, })
 
-              response = @version.page('GET', @uri, params: params, headers: headers)
+              response = @version.page('GET', @uri, params: params)
 
               EntityPage.new(@version, response, @solution)
             end
@@ -134,7 +130,7 @@ module Twilio
           end
 
           ##
-          # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
+          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class EntityPage < Page
             ##
             # Initialize the EntityPage
@@ -165,14 +161,16 @@ module Twilio
           end
 
           ##
-          # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
+          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class EntityContext < InstanceContext
             ##
             # Initialize the EntityContext
             # @param [Version] version Version that contains the resource
             # @param [String] service_sid The unique SID identifier of the Service.
             # @param [String] identity The unique external identifier for the Entity of the
-            #   Service
+            #   Service. This identifier should be immutable, not PII, length between 8 and 64
+            #   characters, and generated by your external system, such as your user's UUID,
+            #   GUID, or SID. It can only contain dash (-) separated alphanumeric characters.
             # @return [EntityContext] EntityContext
             def initialize(version, service_sid, identity)
               super(version)
@@ -183,27 +181,22 @@ module Twilio
 
               # Dependents
               @factors = nil
+              @new_factors = nil
               @challenges = nil
             end
 
             ##
             # Delete the EntityInstance
-            # @param [String] twilio_sandbox_mode The Twilio-Sandbox-Mode HTTP request header
             # @return [Boolean] true if delete succeeds, false otherwise
-            def delete(twilio_sandbox_mode: :unset)
-              headers = Twilio::Values.of({'Twilio-Sandbox-Mode' => twilio_sandbox_mode, })
-
-               @version.delete('DELETE', @uri, headers: headers)
+            def delete
+               @version.delete('DELETE', @uri)
             end
 
             ##
             # Fetch the EntityInstance
-            # @param [String] twilio_sandbox_mode The Twilio-Sandbox-Mode HTTP request header
             # @return [EntityInstance] Fetched EntityInstance
-            def fetch(twilio_sandbox_mode: :unset)
-              headers = Twilio::Values.of({'Twilio-Sandbox-Mode' => twilio_sandbox_mode, })
-
-              payload = @version.fetch('GET', @uri, headers: headers)
+            def fetch
+              payload = @version.fetch('GET', @uri)
 
               EntityInstance.new(
                   @version,
@@ -235,6 +228,22 @@ module Twilio
               @factors
             end
 
+            ##
+            # Access the new_factors
+            # @return [NewFactorList]
+            # @return [NewFactorContext]
+            def new_factors
+              unless @new_factors
+                @new_factors = NewFactorList.new(
+                    @version,
+                    service_sid: @solution[:service_sid],
+                    identity: @solution[:identity],
+                )
+              end
+
+              @new_factors
+            end
+
             ##
             # Access the challenges
             # @return [ChallengeList]
@@ -273,7 +282,7 @@ module Twilio
           end
 
           ##
-          # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
+          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class EntityInstance < InstanceResource
             ##
             # Initialize the EntityInstance
@@ -281,7 +290,9 @@ module Twilio
             # @param [Hash] payload payload that contains response from Twilio
             # @param [String] service_sid The unique SID identifier of the Service.
             # @param [String] identity The unique external identifier for the Entity of the
-            #   Service
+            #   Service. This identifier should be immutable, not PII, length between 8 and 64
+            #   characters, and generated by your external system, such as your user's UUID,
+            #   GUID, or SID. It can only contain dash (-) separated alphanumeric characters.
             # @return [EntityInstance] EntityInstance
             def initialize(version, payload, service_sid: nil, identity: nil)
               super(version)
@@ -364,18 +375,16 @@ module Twilio
 
             ##
             # Delete the EntityInstance
-            # @param [String] twilio_sandbox_mode The Twilio-Sandbox-Mode HTTP request header
             # @return [Boolean] true if delete succeeds, false otherwise
-            def delete(twilio_sandbox_mode: :unset)
-              context.delete(twilio_sandbox_mode: twilio_sandbox_mode, )
+            def delete
+              context.delete
             end
 
             ##
             # Fetch the EntityInstance
-            # @param [String] twilio_sandbox_mode The Twilio-Sandbox-Mode HTTP request header
             # @return [EntityInstance] Fetched EntityInstance
-            def fetch(twilio_sandbox_mode: :unset)
-              context.fetch(twilio_sandbox_mode: twilio_sandbox_mode, )
+            def fetch
+              context.fetch
             end
 
             ##
@@ -385,6 +394,13 @@ module Twilio
               context.factors
             end
 
+            ##
+            # Access the new_factors
+            # @return [new_factors] new_factors
+            def new_factors
+              context.new_factors
+            end
+
             ##
             # Access the challenges
             # @return [challenges] challenges

data/lib/twilio-ruby/rest/verify/v2/service/messaging_configuration.rb

@@ -16,7 +16,7 @@ module Twilio
             # Initialize the MessagingConfigurationList
             # @param [Version] version Version that contains the resource
             # @param [String] service_sid The SID of the
-            #   [Service](https://www.twilio.com/docs/verify/api/service) that the resource is
+            #   {Service}[https://www.twilio.com/docs/verify/api/service] that the resource is
             #   associated with.
             # @return [MessagingConfigurationList] MessagingConfigurationList
             def initialize(version, service_sid: nil)
@@ -30,11 +30,11 @@ module Twilio
             ##
             # Create the MessagingConfigurationInstance
             # @param [String] country 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 this configuration will be applied to. If this is a global
             #   configuration, Country will take the value `all`.
-            # @param [String] messaging_service_sid The SID of the [Messaging
-            #   Service](https://www.twilio.com/docs/sms/services/api) to be used to send SMS to
+            # @param [String] messaging_service_sid The SID of the {Messaging
+            #   Service}[https://www.twilio.com/docs/sms/services/api] to be used to send SMS to
             #   the country of this configuration.
             # @return [MessagingConfigurationInstance] Created MessagingConfigurationInstance
             def create(country: nil, messaging_service_sid: nil)
@@ -166,10 +166,10 @@ module Twilio
             # Initialize the MessagingConfigurationContext
             # @param [Version] version Version that contains the resource
             # @param [String] service_sid The SID of the
-            #   [Service](https://www.twilio.com/docs/verify/api/service) that the resource is
+            #   {Service}[https://www.twilio.com/docs/verify/api/service] that the resource is
             #   associated with.
             # @param [String] country 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 this configuration will be applied to. If this is a global
             #   configuration, Country will take the value `all`.
             # @return [MessagingConfigurationContext] MessagingConfigurationContext
@@ -183,8 +183,8 @@ module Twilio
 
             ##
             # Update the MessagingConfigurationInstance
-            # @param [String] messaging_service_sid The SID of the [Messaging
-            #   Service](https://www.twilio.com/docs/sms/services/api) to be used to send SMS to
+            # @param [String] messaging_service_sid The SID of the {Messaging
+            #   Service}[https://www.twilio.com/docs/sms/services/api] to be used to send SMS to
             #   the country of this configuration.
             # @return [MessagingConfigurationInstance] Updated MessagingConfigurationInstance
             def update(messaging_service_sid: nil)
@@ -242,10 +242,10 @@ module Twilio
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
             # @param [String] service_sid The SID of the
-            #   [Service](https://www.twilio.com/docs/verify/api/service) that the resource is
+            #   {Service}[https://www.twilio.com/docs/verify/api/service] that the resource is
             #   associated with.
             # @param [String] country 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 this configuration will be applied to. If this is a global
             #   configuration, Country will take the value `all`.
             # @return [MessagingConfigurationInstance] MessagingConfigurationInstance
@@ -327,8 +327,8 @@ module Twilio
 
             ##
             # Update the MessagingConfigurationInstance
-            # @param [String] messaging_service_sid The SID of the [Messaging
-            #   Service](https://www.twilio.com/docs/sms/services/api) to be used to send SMS to
+            # @param [String] messaging_service_sid The SID of the {Messaging
+            #   Service}[https://www.twilio.com/docs/sms/services/api] to be used to send SMS to
             #   the country of this configuration.
             # @return [MessagingConfigurationInstance] Updated MessagingConfigurationInstance
             def update(messaging_service_sid: nil)

data/lib/twilio-ruby/rest/verify/v2/service/rate_limit/bucket.rb

@@ -17,7 +17,7 @@ module Twilio
               # Initialize the BucketList
               # @param [Version] version Version that contains the resource
               # @param [String] service_sid The SID of the
-              #   [Service](https://www.twilio.com/docs/verify/api/service) the resource is
+              #   {Service}[https://www.twilio.com/docs/verify/api/service] the resource is
               #   associated with.
               # @param [String] rate_limit_sid The Twilio-provided string that uniquely
               #   identifies the Rate Limit resource.
@@ -175,7 +175,7 @@ module Twilio
               # Initialize the BucketContext
               # @param [Version] version Version that contains the resource
               # @param [String] service_sid The SID of the
-              #   [Service](https://www.twilio.com/docs/verify/api/service) the resource is
+              #   {Service}[https://www.twilio.com/docs/verify/api/service] the resource is
               #   associated with.
               # @param [String] rate_limit_sid The Twilio-provided string that uniquely
               #   identifies the Rate Limit resource.
@@ -252,7 +252,7 @@ module Twilio
               # @param [Version] version Version that contains the resource
               # @param [Hash] payload payload that contains response from Twilio
               # @param [String] service_sid The SID of the
-              #   [Service](https://www.twilio.com/docs/verify/api/service) the resource is
+              #   {Service}[https://www.twilio.com/docs/verify/api/service] the resource is
               #   associated with.
               # @param [String] rate_limit_sid The Twilio-provided string that uniquely
               #   identifies the Rate Limit resource.

data/lib/twilio-ruby/rest/verify/v2/service/rate_limit.rb

@@ -16,7 +16,7 @@ module Twilio
             # Initialize the RateLimitList
             # @param [Version] version Version that contains the resource
             # @param [String] service_sid The SID of the
-            #   [Service](https://www.twilio.com/docs/verify/api/service) the resource is
+            #   {Service}[https://www.twilio.com/docs/verify/api/service] the resource is
             #   associated with.
             # @return [RateLimitList] RateLimitList
             def initialize(version, service_sid: nil)
@@ -163,7 +163,7 @@ module Twilio
             # Initialize the RateLimitContext
             # @param [Version] version Version that contains the resource
             # @param [String] service_sid The SID of the
-            #   [Service](https://www.twilio.com/docs/verify/api/service) the resource is
+            #   {Service}[https://www.twilio.com/docs/verify/api/service] the resource is
             #   associated with.
             # @param [String] sid The Twilio-provided string that uniquely identifies the Rate
             #   Limit resource to fetch.
@@ -250,7 +250,7 @@ module Twilio
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
             # @param [String] service_sid The SID of the
-            #   [Service](https://www.twilio.com/docs/verify/api/service) the resource is
+            #   {Service}[https://www.twilio.com/docs/verify/api/service] the resource is
             #   associated with.
             # @param [String] sid The Twilio-provided string that uniquely identifies the Rate
             #   Limit resource to fetch.

data/lib/twilio-ruby/rest/verify/v2/service/verification.rb

@@ -16,7 +16,7 @@ module Twilio
             # Initialize the VerificationList
             # @param [Version] version Version that contains the resource
             # @param [String] service_sid The SID of the
-            #   [Service](https://www.twilio.com/docs/verify/api/service) the resource is
+            #   {Service}[https://www.twilio.com/docs/verify/api/service] the resource is
             #   associated with.
             # @return [VerificationList] VerificationList
             def initialize(version, service_sid: nil)
@@ -30,20 +30,24 @@ module Twilio
             ##
             # Create the VerificationInstance
             # @param [String] to The phone number or
-            #   [email](https://www.twilio.com/docs/verify/email) to verify. Phone numbers must
-            #   be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).
+            #   {email}[https://www.twilio.com/docs/verify/email] to verify. Phone numbers must
+            #   be in {E.164 format}[https://www.twilio.com/docs/glossary/what-e164].
             # @param [String] channel The verification method to use. Can be:
-            #   [`email`](https://www.twilio.com/docs/verify/email), `sms` or `call`.
+            #   {`email`}[https://www.twilio.com/docs/verify/email], `sms`, `whatsapp` or
+            #   `call`.
+            # @param [String] custom_friendly_name A custom user defined friendly name that
+            #   overwrites the existing one in the verification message
             # @param [String] custom_message The text of a custom message to use for the
             #   verification.
             # @param [String] send_digits The digits to send after a phone call is answered,
             #   for example, to dial an extension. For more information, see the Programmable
             #   Voice documentation of
-            #   [sendDigits](https://www.twilio.com/docs/voice/twiml/number#attributes-sendDigits).
-            # @param [String] locale The locale to use for the verification SMS or call. Can
-            #   be: `af`, `ar`, `ca`, `cs`, `da`, `de`, `el`, `en`, `en-GB`, `es`, `fi`, `fr`,
-            #   `he`, `hi`, `hr`, `hu`, `id`, `it`, `ja`, `ko`, `ms`, `nb`, `nl`, `pl`, `pt`,
-            #   `pr-BR`, `ro`, `ru`, `sv`, `th`, `tl`, `tr`, `vi`, `zh`, `zh-CN`, or `zh-HK.`
+            #   {sendDigits}[https://www.twilio.com/docs/voice/twiml/number#attributes-sendDigits].
+            # @param [String] locale The locale to use for the verification SMS, WhatsApp or
+            #   call. Can be: `af`, `ar`, `ca`, `cs`, `da`, `de`, `el`, `en`, `en-GB`, `es`,
+            #   `fi`, `fr`, `he`, `hi`, `hr`, `hu`, `id`, `it`, `ja`, `ko`, `ms`, `nb`, `nl`,
+            #   `pl`, `pt`, `pr-BR`, `ro`, `ru`, `sv`, `th`, `tl`, `tr`, `vi`, `zh`, `zh-CN`, or
+            #   `zh-HK.`
             # @param [String] custom_code A pre-generated code to use for verification. The
             #   code can be between 4 and 10 characters, inclusive.
             # @param [String] amount The amount of the associated PSD2 compliant transaction.
@@ -51,20 +55,23 @@ module Twilio
             # @param [String] payee The payee of the associated PSD2 compliant transaction.
             #   Requires the PSD2 Service flag enabled.
             # @param [Hash] rate_limits The custom key-value pairs of Programmable Rate
-            #   Limits. Keys correspond to `unique_name` fields defined when [creating your Rate
-            #   Limit](https://www.twilio.com/docs/verify/api/service-rate-limits). Associated
+            #   Limits. Keys correspond to `unique_name` fields defined when {creating your Rate
+            #   Limit}[https://www.twilio.com/docs/verify/api/service-rate-limits]. Associated
             #   value pairs represent values in the request that you are rate limiting on. You
             #   may include multiple Rate Limit values in each request.
             # @param [Hash] channel_configuration
-            #   [`email`](https://www.twilio.com/docs/verify/email) channel configuration in
+            #   {`email`}[https://www.twilio.com/docs/verify/email] channel configuration in
             #   json format. Must include 'from' and 'from_name'.
-            # @param [String] app_hash Your [App
-            #   Hash](https://developers.google.com/identity/sms-retriever/verify#computing_your_apps_hash_string) to be appended at the end of your verification SMS body. Applies only to SMS. Example SMS body: `<#> Your AppName verification code is: 1234 He42w354ol9`.
+            # @param [String] app_hash Your {App
+            #   Hash}[https://developers.google.com/identity/sms-retriever/verify#computing_your_apps_hash_string]
+            #   to be appended at the end of your verification SMS body. Applies only to SMS.
+            #   Example SMS body: `<#> Your AppName verification code is: 1234 He42w354ol9`.
             # @return [VerificationInstance] Created VerificationInstance
-            def create(to: nil, channel: nil, custom_message: :unset, send_digits: :unset, locale: :unset, custom_code: :unset, amount: :unset, payee: :unset, rate_limits: :unset, channel_configuration: :unset, app_hash: :unset)
+            def create(to: nil, channel: nil, custom_friendly_name: :unset, custom_message: :unset, send_digits: :unset, locale: :unset, custom_code: :unset, amount: :unset, payee: :unset, rate_limits: :unset, channel_configuration: :unset, app_hash: :unset)
               data = Twilio::Values.of({
                   'To' => to,
                   'Channel' => channel,
+                  'CustomFriendlyName' => custom_friendly_name,
                   'CustomMessage' => custom_message,
                   'SendDigits' => send_digits,
                   'Locale' => locale,
@@ -122,7 +129,7 @@ module Twilio
             # Initialize the VerificationContext
             # @param [Version] version Version that contains the resource
             # @param [String] service_sid The SID of the verification
-            #   [Service](https://www.twilio.com/docs/verify/api/service) to fetch the resource
+            #   {Service}[https://www.twilio.com/docs/verify/api/service] to fetch the resource
             #   from.
             # @param [String] sid The Twilio-provided string that uniquely identifies the
             #   Verification resource to fetch.
@@ -188,7 +195,7 @@ module Twilio
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
             # @param [String] service_sid The SID of the
-            #   [Service](https://www.twilio.com/docs/verify/api/service) the resource is
+            #   {Service}[https://www.twilio.com/docs/verify/api/service] the resource is
             #   associated with.
             # @param [String] sid The Twilio-provided string that uniquely identifies the
             #   Verification resource to fetch.
@@ -291,7 +298,7 @@ module Twilio
             end
 
             ##
-            # @return [Hash] An array of verification attempt objects.
+            # @return [Array[Hash]] An array of verification attempt objects.
             def send_code_attempts
               @properties['send_code_attempts']
             end

data/lib/twilio-ruby/rest/verify/v2/service/verification_check.rb

@@ -16,7 +16,7 @@ module Twilio
             # Initialize the VerificationCheckList
             # @param [Version] version Version that contains the resource
             # @param [String] service_sid The SID of the
-            #   [Service](https://www.twilio.com/docs/verify/api/service) the resource is
+            #   {Service}[https://www.twilio.com/docs/verify/api/service] the resource is
             #   associated with.
             # @return [VerificationCheckList] VerificationCheckList
             def initialize(version, service_sid: nil)
@@ -31,12 +31,12 @@ module Twilio
             # Create the VerificationCheckInstance
             # @param [String] code The 4-10 character string being verified.
             # @param [String] to The phone number or
-            #   [email](https://www.twilio.com/docs/verify/email) to verify. Either this
+            #   {email}[https://www.twilio.com/docs/verify/email] to verify. Either this
             #   parameter or the `verification_sid` must be specified. Phone numbers must be in
-            #   [E.164 format](https://www.twilio.com/docs/glossary/what-e164).
+            #   {E.164 format}[https://www.twilio.com/docs/glossary/what-e164].
             # @param [String] verification_sid A SID that uniquely identifies the Verification
             #   Check. Either this parameter or the `to` phone
-            #   number/[email](https://www.twilio.com/docs/verify/email) must be specified.
+            #   number/{email}[https://www.twilio.com/docs/verify/email] must be specified.
             # @param [String] amount The amount of the associated PSD2 compliant transaction.
             #   Requires the PSD2 Service flag enabled.
             # @param [String] payee The payee of the associated PSD2 compliant transaction.
@@ -98,7 +98,7 @@ module Twilio
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
             # @param [String] service_sid The SID of the
-            #   [Service](https://www.twilio.com/docs/verify/api/service) the resource is
+            #   {Service}[https://www.twilio.com/docs/verify/api/service] the resource is
             #   associated with.
             # @return [VerificationCheckInstance] VerificationCheckInstance
             def initialize(version, payload, service_sid: nil)