twilio-ruby 5.27.0 → 5.27.1

data/lib/twilio-ruby/rest/taskrouter/v1/workspace/workspace_statistics.rb

@@ -15,7 +15,7 @@ module Twilio
             ##
             # Initialize the WorkspaceStatisticsList
             # @param [Version] version Version that contains the resource
-            # @param [String] workspace_sid The workspace_sid
+            # @param [String] workspace_sid The SID of the Workspace.
             # @return [WorkspaceStatisticsList] WorkspaceStatisticsList
             def initialize(version, workspace_sid: nil)
               super(version)
@@ -64,7 +64,7 @@ module Twilio
             ##
             # Initialize the WorkspaceStatisticsContext
             # @param [Version] version Version that contains the resource
-            # @param [String] workspace_sid The workspace_sid
+            # @param [String] workspace_sid The SID of the Workspace to fetch.
             # @return [WorkspaceStatisticsContext] WorkspaceStatisticsContext
             def initialize(version, workspace_sid)
               super(version)
@@ -76,23 +76,24 @@ module Twilio
 
             ##
             # Fetch a WorkspaceStatisticsInstance
-            # @param [String] minutes Filter cumulative statistics by up to 'x' minutes in the
-            #   past. This is helpful for statistics for the last 15 minutes, 240 minutes (4
-            #   hours), and 480 minutes (8 hours) to see trends. Defaults to 15 minutes.
-            # @param [Time] start_date Filter cumulative statistics by a start date. This is
-            #   helpful for defining a range of statistics to capture. Input is a GMT ISO 8601
-            #   Timestamp
-            # @param [Time] end_date Filter cumulative statistics by an end date. This is
-            #   helpful for defining a range of statistics to capture. Input is a GMT ISO 8601
-            #   Timestamp
-            # @param [String] task_channel Filter real-time and cumulative statistics by
-            #   TaskChannel. Takes in a Unique Name ("voice", "sms", "default", etc.) or a
-            #   TaskChannelSid.
-            # @param [String] split_by_wait_time A comma separated values for viewing splits
-            #   of tasks canceled and accepted above the given threshold in seconds. Ex: "5,30"
-            #   would show splits of tasks that were canceled or accepted before or after 5
-            #   seconds and respectively, 30 seconds. This is great for showing short abandoned
-            #   tasks or tasks that failed to meet your SLA.
+            # @param [String] minutes Only calculate statistics since this many minutes in the
+            #   past. The default 15 minutes. This is helpful for displaying statistics for the
+            #   last 15 minutes, 240 minutes (4 hours), and 480 minutes (8 hours) to see trends.
+            # @param [Time] start_date Only calculate statistics from this date and time and
+            #   later, specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
+            # @param [Time] end_date Only calculate statistics from this date and time and
+            #   earlier, specified in GMT as an [ISO
+            #   8601](https://en.wikipedia.org/wiki/ISO_8601) date-time.
+            # @param [String] task_channel Only calculate statistics on this TaskChannel. Can
+            #   be the TaskChannel's SID or its `unique_name`, such as `voice`, `sms`, or
+            #   `default`.
+            # @param [String] split_by_wait_time A comma separated list of values that
+            #   describes the thresholds, in seconds, to calculate statistics on. For each
+            #   threshold specified, the number of Tasks canceled and reservations accepted
+            #   above and below the specified thresholds in seconds are computed. For example,
+            #   `5,30` would show splits of Tasks that were canceled or accepted before and
+            #   after 5 seconds and before and after 30 seconds. This can be used to show short
+            #   abandoned Tasks or Tasks that failed to meet an SLA.
             # @return [WorkspaceStatisticsInstance] Fetched WorkspaceStatisticsInstance
             def fetch(minutes: :unset, start_date: :unset, end_date: :unset, task_channel: :unset, split_by_wait_time: :unset)
               params = Twilio::Values.of({
@@ -132,7 +133,7 @@ module Twilio
             # Initialize the WorkspaceStatisticsInstance
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
-            # @param [String] workspace_sid The workspace_sid
+            # @param [String] workspace_sid The SID of the Workspace.
             # @return [WorkspaceStatisticsInstance] WorkspaceStatisticsInstance
             def initialize(version, payload, workspace_sid: nil)
               super(version)
@@ -163,54 +164,55 @@ module Twilio
             end
 
             ##
-            # @return [Hash] The realtime
+            # @return [Hash] n object that contains the real-time statistics for the Workspace
             def realtime
               @properties['realtime']
             end
 
             ##
-            # @return [Hash] The cumulative
+            # @return [Hash] An object that contains the cumulative statistics for the Workspace
             def cumulative
               @properties['cumulative']
             end
 
             ##
-            # @return [String] The account_sid
+            # @return [String] The SID of the Account that created the resource
             def account_sid
               @properties['account_sid']
             end
 
             ##
-            # @return [String] The workspace_sid
+            # @return [String] The SID of the Workspace
             def workspace_sid
               @properties['workspace_sid']
             end
 
             ##
-            # @return [String] The url
+            # @return [String] The absolute URL of the Workspace statistics resource
             def url
               @properties['url']
             end
 
             ##
             # Fetch a WorkspaceStatisticsInstance
-            # @param [String] minutes Filter cumulative statistics by up to 'x' minutes in the
-            #   past. This is helpful for statistics for the last 15 minutes, 240 minutes (4
-            #   hours), and 480 minutes (8 hours) to see trends. Defaults to 15 minutes.
-            # @param [Time] start_date Filter cumulative statistics by a start date. This is
-            #   helpful for defining a range of statistics to capture. Input is a GMT ISO 8601
-            #   Timestamp
-            # @param [Time] end_date Filter cumulative statistics by an end date. This is
-            #   helpful for defining a range of statistics to capture. Input is a GMT ISO 8601
-            #   Timestamp
-            # @param [String] task_channel Filter real-time and cumulative statistics by
-            #   TaskChannel. Takes in a Unique Name ("voice", "sms", "default", etc.) or a
-            #   TaskChannelSid.
-            # @param [String] split_by_wait_time A comma separated values for viewing splits
-            #   of tasks canceled and accepted above the given threshold in seconds. Ex: "5,30"
-            #   would show splits of tasks that were canceled or accepted before or after 5
-            #   seconds and respectively, 30 seconds. This is great for showing short abandoned
-            #   tasks or tasks that failed to meet your SLA.
+            # @param [String] minutes Only calculate statistics since this many minutes in the
+            #   past. The default 15 minutes. This is helpful for displaying statistics for the
+            #   last 15 minutes, 240 minutes (4 hours), and 480 minutes (8 hours) to see trends.
+            # @param [Time] start_date Only calculate statistics from this date and time and
+            #   later, specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
+            # @param [Time] end_date Only calculate statistics from this date and time and
+            #   earlier, specified in GMT as an [ISO
+            #   8601](https://en.wikipedia.org/wiki/ISO_8601) date-time.
+            # @param [String] task_channel Only calculate statistics on this TaskChannel. Can
+            #   be the TaskChannel's SID or its `unique_name`, such as `voice`, `sms`, or
+            #   `default`.
+            # @param [String] split_by_wait_time A comma separated list of values that
+            #   describes the thresholds, in seconds, to calculate statistics on. For each
+            #   threshold specified, the number of Tasks canceled and reservations accepted
+            #   above and below the specified thresholds in seconds are computed. For example,
+            #   `5,30` would show splits of Tasks that were canceled or accepted before and
+            #   after 5 seconds and before and after 30 seconds. This can be used to show short
+            #   abandoned Tasks or Tasks that failed to meet an SLA.
             # @return [WorkspaceStatisticsInstance] Fetched WorkspaceStatisticsInstance
             def fetch(minutes: :unset, start_date: :unset, end_date: :unset, task_channel: :unset, split_by_wait_time: :unset)
               context.fetch(

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

@@ -31,13 +31,14 @@ module Twilio
           # @param [String] domain_name The unique address you reserve on Twilio to which
           #   you route your SIP traffic. Domain names can contain letters, digits, and `-`
           #   and must end with `pstn.twilio.com`. See [Termination
-          #   Settings](https://www.twilio.com/docs/sip-trunking/getting-started#termination)
-          #   for more information.
+          #   Settings](https://www.twilio.com/docs/sip-trunking#termination) for more
+          #   information.
           # @param [String] disaster_recovery_url The URL we should call using the
           #   `disaster_recovery_method` if an error occurs while sending SIP traffic towards
           #   the configured Origination URL. We retrieve TwiML from the URL and execute the
           #   instructions like any other normal TwiML call. See [Disaster
-          #   Recovery](https://www.twilio.com/docs/sip-trunking/getting-started#disaster-recovery) for more information.
+          #   Recovery](https://www.twilio.com/docs/sip-trunking#disaster-recovery) for more
+          #   information.
           # @param [String] disaster_recovery_method The HTTP method we should use to call
           #   the `disaster_recovery_url`. Can be: `GET` or `POST`.
           # @param [trunk.RecordingSetting] recording The recording settings for the trunk.
@@ -46,12 +47,13 @@ module Twilio
           #   will be recorded. The only way to change recording parameters is on a
           #   sub-resource of a Trunk after it has been created.
           #   e.g.`/Trunks/[Trunk_SID]/Recording -XPOST -d'Mode=record-from-answer'`. See
-          #   [Recording](https://www.twilio.com/docs/sip-trunking/getting-started#recording)
-          #   for more information.
+          #   [Recording](https://www.twilio.com/docs/sip-trunking#recording) for more
+          #   information.
           # @param [Boolean] secure Whether Secure Trunking is enabled for the trunk. If
           #   enabled, all calls going through the trunk will be secure using SRTP for media
           #   and TLS for signaling. If disabled, then RTP will be used for media. See [Secure
-          #   Trunking](https://www.twilio.com/docs/sip-trunking/getting-started#securetrunking) for more information.
+          #   Trunking](https://www.twilio.com/docs/sip-trunking#securetrunking) for more
+          #   information.
           # @param [Boolean] cnam_lookup_enabled Whether Caller ID Name (CNAM) lookup should
           #   be enabled for the trunk. If enabled, all inbound calls to the SIP Trunk from
           #   the United States and Canada automatically perform a CNAM Lookup and display
@@ -247,25 +249,27 @@ module Twilio
           # @param [String] domain_name The unique address you reserve on Twilio to which
           #   you route your SIP traffic. Domain names can contain letters, digits, and `-`
           #   and must end with `pstn.twilio.com`. See [Termination
-          #   Settings](https://www.twilio.com/docs/sip-trunking/getting-started#termination)
-          #   for more information.
+          #   Settings](https://www.twilio.com/docs/sip-trunking#termination) for more
+          #   information.
           # @param [String] disaster_recovery_url The URL we should call using the
           #   `disaster_recovery_method` if an error occurs while sending SIP traffic towards
           #   the configured Origination URL. We retrieve TwiML from the URL and execute the
           #   instructions like any other normal TwiML call. See [Disaster
-          #   Recovery](https://www.twilio.com/docs/sip-trunking/getting-started#disaster-recovery) for more information.
+          #   Recovery](https://www.twilio.com/docs/sip-trunking#disaster-recovery) for more
+          #   information.
           # @param [String] disaster_recovery_method The HTTP method we should use to call
           #   the `disaster_recovery_url`. Can be: `GET` or `POST`.
           # @param [trunk.RecordingSetting] recording The recording settings for the trunk.
           #   Can be: `do-not-record`, `record-from-ringing`, `record-from-answer`. If set to
           #   `record-from-ringing` or `record-from-answer`, all calls going through the trunk
           #   will be recorded. See
-          #   [Recording](https://www.twilio.com/docs/sip-trunking/getting-started#recording)
-          #   for more information.
+          #   [Recording](https://www.twilio.com/docs/sip-trunking#recording) for more
+          #   information.
           # @param [Boolean] secure Whether Secure Trunking is enabled for the trunk. If
           #   enabled, all calls going through the trunk will be secure using SRTP for media
           #   and TLS for signaling. If disabled, then RTP will be used for media. See [Secure
-          #   Trunking](https://www.twilio.com/docs/sip-trunking/getting-started#securetrunking) for more information.
+          #   Trunking](https://www.twilio.com/docs/sip-trunking#securetrunking) for more
+          #   information.
           # @param [Boolean] cnam_lookup_enabled Whether Caller ID Name (CNAM) lookup should
           #   be enabled for the trunk. If enabled, all inbound calls to the SIP Trunk from
           #   the United States and Canada automatically perform a CNAM Lookup and display
@@ -554,25 +558,27 @@ module Twilio
           # @param [String] domain_name The unique address you reserve on Twilio to which
           #   you route your SIP traffic. Domain names can contain letters, digits, and `-`
           #   and must end with `pstn.twilio.com`. See [Termination
-          #   Settings](https://www.twilio.com/docs/sip-trunking/getting-started#termination)
-          #   for more information.
+          #   Settings](https://www.twilio.com/docs/sip-trunking#termination) for more
+          #   information.
           # @param [String] disaster_recovery_url The URL we should call using the
           #   `disaster_recovery_method` if an error occurs while sending SIP traffic towards
           #   the configured Origination URL. We retrieve TwiML from the URL and execute the
           #   instructions like any other normal TwiML call. See [Disaster
-          #   Recovery](https://www.twilio.com/docs/sip-trunking/getting-started#disaster-recovery) for more information.
+          #   Recovery](https://www.twilio.com/docs/sip-trunking#disaster-recovery) for more
+          #   information.
           # @param [String] disaster_recovery_method The HTTP method we should use to call
           #   the `disaster_recovery_url`. Can be: `GET` or `POST`.
           # @param [trunk.RecordingSetting] recording The recording settings for the trunk.
           #   Can be: `do-not-record`, `record-from-ringing`, `record-from-answer`. If set to
           #   `record-from-ringing` or `record-from-answer`, all calls going through the trunk
           #   will be recorded. See
-          #   [Recording](https://www.twilio.com/docs/sip-trunking/getting-started#recording)
-          #   for more information.
+          #   [Recording](https://www.twilio.com/docs/sip-trunking#recording) for more
+          #   information.
           # @param [Boolean] secure Whether Secure Trunking is enabled for the trunk. If
           #   enabled, all calls going through the trunk will be secure using SRTP for media
           #   and TLS for signaling. If disabled, then RTP will be used for media. See [Secure
-          #   Trunking](https://www.twilio.com/docs/sip-trunking/getting-started#securetrunking) for more information.
+          #   Trunking](https://www.twilio.com/docs/sip-trunking#securetrunking) for more
+          #   information.
           # @param [Boolean] cnam_lookup_enabled Whether Caller ID Name (CNAM) lookup should
           #   be enabled for the trunk. If enabled, all inbound calls to the SIP Trunk from
           #   the United States and Canada automatically perform a CNAM Lookup and display

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

@@ -30,9 +30,9 @@ module Twilio
             # Retrieve a single page of CredentialListInstance records from the API.
             # Request is executed immediately.
             # @param [String] credential_list_sid The SID of the [Credential
-            #   List](https://www.twilio.com/docs/api/rest/credential-list) that you want to
-            #   associate with the trunk. Once associated, we will authenticate access to the
-            #   trunk against this list.
+            #   List](https://www.twilio.com/docs/voice/sip/api/sip-credentiallist-resource)
+            #   that you want to associate with the trunk. Once associated, we will authenticate
+            #   access to the trunk against this list.
             # @return [CredentialListInstance] Newly created CredentialListInstance
             def create(credential_list_sid: nil)
               data = Twilio::Values.of({'CredentialListSid' => credential_list_sid, })

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

@@ -29,8 +29,7 @@ module Twilio
             # Retrieve a single page of IpAccessControlListInstance records from the API.
             # Request is executed immediately.
             # @param [String] ip_access_control_list_sid The SID of the [IP Access Control
-            #   List](https://www.twilio.com/docs/api/rest/ip-access-control-list) that you want
-            #   to associate with the trunk.
+            #   List](https://www.twilio.com/docs/voice/sip/api/sip-ipaccesscontrollist-resource) that you want to associate with the trunk.
             # @return [IpAccessControlListInstance] Newly created IpAccessControlListInstance
             def create(ip_access_control_list_sid: nil)
               data = Twilio::Values.of({'IpAccessControlListSid' => ip_access_control_list_sid, })

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

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

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

@@ -18,8 +18,8 @@ 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-beta/service-beta) that the
-            #   resource is associated with.
+            #   [Service](https://www.twilio.com/docs/verify/api/service) that the resource is
+            #   associated with.
             # @return [MessagingConfigurationList] MessagingConfigurationList
             def initialize(version, service_sid: nil)
               super(version)
@@ -37,8 +37,8 @@ module Twilio
             #   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/api/messaging/services) to be used to send
-            #   SMS to the country of this configuration.
+            #   Service](https://www.twilio.com/docs/sms/services/api) to be used to send SMS to
+            #   the country of this configuration.
             # @return [MessagingConfigurationInstance] Newly created MessagingConfigurationInstance
             def create(country: nil, messaging_service_sid: nil)
               data = Twilio::Values.of({'Country' => country, 'MessagingServiceSid' => messaging_service_sid, })
@@ -179,8 +179,8 @@ 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-beta/service-beta) that the
-            #   resource is associated with.
+            #   [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
             #   the country this configuration will be applied to. If this is a global
@@ -197,8 +197,8 @@ module Twilio
             ##
             # Update the MessagingConfigurationInstance
             # @param [String] messaging_service_sid The SID of the [Messaging
-            #   Service](https://www.twilio.com/docs/api/messaging/services) to be used to send
-            #   SMS to the country of this configuration.
+            #   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 = Twilio::Values.of({'MessagingServiceSid' => messaging_service_sid, })
@@ -267,8 +267,8 @@ 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-beta/service-beta) that the
-            #   resource is associated with.
+            #   [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
             #   the country this configuration will be applied to. If this is a global
@@ -353,8 +353,8 @@ module Twilio
             ##
             # Update the MessagingConfigurationInstance
             # @param [String] messaging_service_sid The SID of the [Messaging
-            #   Service](https://www.twilio.com/docs/api/messaging/services) to be used to send
-            #   SMS to the country of this configuration.
+            #   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)
               context.update(messaging_service_sid: messaging_service_sid, )

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

@@ -18,8 +18,8 @@ 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-beta/service-beta) the resource
-            #   is associated with.
+            #   [Service](https://www.twilio.com/docs/verify/api/service) the resource is
+            #   associated with.
             # @return [RateLimitList] RateLimitList
             def initialize(version, service_sid: nil)
               super(version)
@@ -176,8 +176,8 @@ 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-beta/service-beta) the resource
-            #   is associated with.
+            #   [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.
             # @return [RateLimitContext] RateLimitContext
@@ -275,8 +275,8 @@ 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-beta/service-beta) the resource
-            #   is associated with.
+            #   [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.
             # @return [RateLimitInstance] RateLimitInstance

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

@@ -19,8 +19,8 @@ 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-beta/service-beta) the resource
-              #   is associated with.
+              #   [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.
               # @return [BucketList] BucketList
@@ -188,8 +188,8 @@ 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-beta/service-beta) the resource
-              #   is associated with.
+              #   [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.
               # @param [String] sid A 34 character string that uniquely identifies this Bucket.
@@ -277,8 +277,8 @@ 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-beta/service-beta) the resource
-              #   is associated with.
+              #   [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.
               # @param [String] sid A 34 character string that uniquely identifies this Bucket.

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

@@ -32,7 +32,8 @@ module Twilio
             ##
             # Retrieve a single page of VerificationInstance records from the API.
             # Request is executed immediately.
-            # @param [String] to The phone number to verify.
+            # @param [String] to The phone number 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: `sms` or `call`.
             # @param [String] custom_message The text of a custom message to use for the
             #   verification.

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

@@ -34,7 +34,8 @@ module Twilio
             # Request is executed immediately.
             # @param [String] code The 4-10 character string being verified.
             # @param [String] to The phone number to verify. Either this parameter or the
-            #   `verification_sid` must be specified
+            #   `verification_sid` must be specified. Phone numbers must be in [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 must be specified.
             # @param [String] amount The amount of the associated PSD2 compliant transaction.

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

@@ -29,8 +29,8 @@ module Twilio
       end
 
       ##
-      # @param [String] sid `HKxx…xx` A system-generated 34-character string that
-      #   uniquely identifies this Composition Hook.
+      # @param [String] sid The unique string that we created to identify the
+      #   CompositionHook resource.
       # @return [Twilio::REST::Video::V1::CompositionHookInstance] if sid was passed.
       # @return [Twilio::REST::Video::V1::CompositionHookList]
       def composition_hooks(sid=:unset)
@@ -44,8 +44,8 @@ module Twilio
       end
 
       ##
-      # @param [String] sid `RTxx…xx` A system-generated 34-character string that
-      #   uniquely identifies this Recording.
+      # @param [String] sid The unique string that we created to identify the Recording
+      #   resource.
       # @return [Twilio::REST::Video::V1::RecordingInstance] if sid was passed.
       # @return [Twilio::REST::Video::V1::RecordingList]
       def recordings(sid=:unset)
@@ -59,8 +59,8 @@ module Twilio
       end
 
       ##
-      # @param [String] sid `CJxx…xx` A system-generated 34-character string that
-      #   uniquely identifies this Composition.
+      # @param [String] sid The unique string that we created to identify the
+      #   Composition resource.
       # @return [Twilio::REST::Video::V1::CompositionInstance] if sid was passed.
       # @return [Twilio::REST::Video::V1::CompositionList]
       def compositions(sid=:unset)
@@ -68,8 +68,8 @@ module Twilio
       end
 
       ##
-      # @param [String] sid A system-generated 34-character string that uniquely
-      #   identifies this resource.
+      # @param [String] sid The unique string that we created to identify the Room
+      #   resource.
       # @return [Twilio::REST::Video::V1::RoomInstance] if sid was passed.
       # @return [Twilio::REST::Video::V1::RoomList]
       def rooms(sid=:unset)