twilio-ruby 5.40.3 → 5.44.0

data/lib/twilio-ruby/rest/chat/v2/service/channel/webhook.rb

@@ -17,10 +17,10 @@ module Twilio
               # Initialize the WebhookList
               # @param [Version] version Version that contains the resource
               # @param [String] service_sid The SID of the
-              #   [Service](https://www.twilio.com/docs/chat/rest/service-resource) the Channel
+              #   {Service}[https://www.twilio.com/docs/chat/rest/service-resource] the Channel
               #   Webhook resource is associated with.
               # @param [String] channel_sid The SID of the
-              #   [Channel](https://www.twilio.com/docs/chat/channels) the Channel Webhook
+              #   {Channel}[https://www.twilio.com/docs/chat/channels] the Channel Webhook
               #   resource belongs to.
               # @return [WebhookList] WebhookList
               def initialize(version, service_sid: nil, channel_sid: nil)
@@ -122,14 +122,14 @@ module Twilio
               # @param [String] configuration_filters The events that cause us to call the
               #   Channel Webhook. Used when `type` is `webhook`. This parameter takes only one
               #   event. To specify more than one event, repeat this parameter for each event. For
-              #   the list of possible events, see [Webhook Event
-              #   Triggers](https://www.twilio.com/docs/chat/webhook-events#webhook-event-trigger).
+              #   the list of possible events, see {Webhook Event
+              #   Triggers}[https://www.twilio.com/docs/chat/webhook-events#webhook-event-trigger].
               # @param [String] configuration_triggers A string that will cause us to call the
               #   webhook when it is present in a message body. This parameter takes only one
               #   trigger string. To specify more than one, repeat this parameter for each trigger
               #   string up to a total of 5 trigger strings. Used only when `type` = `trigger`.
               # @param [String] configuration_flow_sid The SID of the Studio
-              #   [Flow](https://www.twilio.com/docs/studio/rest-api/flow) to call when an event
+              #   {Flow}[https://www.twilio.com/docs/studio/rest-api/flow] to call when an event
               #   in `configuration.filters` occurs. Used only when `type` is `studio`.
               # @param [String] configuration_retry_count The number of times to retry the
               #   webhook if the first attempt fails. Can be an integer between 0 and 3,
@@ -202,10 +202,10 @@ module Twilio
               # Initialize the WebhookContext
               # @param [Version] version Version that contains the resource
               # @param [String] service_sid The SID of the
-              #   [Service](https://www.twilio.com/docs/chat/rest/service-resource) with the
+              #   {Service}[https://www.twilio.com/docs/chat/rest/service-resource] with the
               #   Channel to fetch the Webhook resource from.
               # @param [String] channel_sid The SID of the
-              #   [Channel](https://www.twilio.com/docs/chat/channels) the Channel Webhook
+              #   {Channel}[https://www.twilio.com/docs/chat/channels] the Channel Webhook
               #   resource to fetch belongs to. This value can be the Channel resource's `sid` or
               #   `unique_name`.
               # @param [String] sid The SID of the Channel Webhook resource to fetch.
@@ -242,14 +242,14 @@ module Twilio
               # @param [String] configuration_filters The events that cause us to call the
               #   Channel Webhook. Used when `type` is `webhook`. This parameter takes only one
               #   event. To specify more than one event, repeat this parameter for each event. For
-              #   the list of possible events, see [Webhook Event
-              #   Triggers](https://www.twilio.com/docs/chat/webhook-events#webhook-event-trigger).
+              #   the list of possible events, see {Webhook Event
+              #   Triggers}[https://www.twilio.com/docs/chat/webhook-events#webhook-event-trigger].
               # @param [String] configuration_triggers A string that will cause us to call the
               #   webhook when it is present in a message body. This parameter takes only one
               #   trigger string. To specify more than one, repeat this parameter for each trigger
               #   string up to a total of 5 trigger strings. Used only when `type` = `trigger`.
               # @param [String] configuration_flow_sid The SID of the Studio
-              #   [Flow](https://www.twilio.com/docs/studio/rest-api/flow) to call when an event
+              #   {Flow}[https://www.twilio.com/docs/studio/rest-api/flow] to call when an event
               #   in `configuration.filters` occurs. Used only when `type` = `studio`.
               # @param [String] configuration_retry_count The number of times to retry the
               #   webhook if the first attempt fails. Can be an integer between 0 and 3,
@@ -304,10 +304,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/chat/rest/service-resource) the Channel
+              #   {Service}[https://www.twilio.com/docs/chat/rest/service-resource] the Channel
               #   Webhook resource is associated with.
               # @param [String] channel_sid The SID of the
-              #   [Channel](https://www.twilio.com/docs/chat/channels) the Channel Webhook
+              #   {Channel}[https://www.twilio.com/docs/chat/channels] the Channel Webhook
               #   resource belongs to.
               # @param [String] sid The SID of the Channel Webhook resource to fetch.
               # @return [WebhookInstance] WebhookInstance
@@ -422,14 +422,14 @@ module Twilio
               # @param [String] configuration_filters The events that cause us to call the
               #   Channel Webhook. Used when `type` is `webhook`. This parameter takes only one
               #   event. To specify more than one event, repeat this parameter for each event. For
-              #   the list of possible events, see [Webhook Event
-              #   Triggers](https://www.twilio.com/docs/chat/webhook-events#webhook-event-trigger).
+              #   the list of possible events, see {Webhook Event
+              #   Triggers}[https://www.twilio.com/docs/chat/webhook-events#webhook-event-trigger].
               # @param [String] configuration_triggers A string that will cause us to call the
               #   webhook when it is present in a message body. This parameter takes only one
               #   trigger string. To specify more than one, repeat this parameter for each trigger
               #   string up to a total of 5 trigger strings. Used only when `type` = `trigger`.
               # @param [String] configuration_flow_sid The SID of the Studio
-              #   [Flow](https://www.twilio.com/docs/studio/rest-api/flow) to call when an event
+              #   {Flow}[https://www.twilio.com/docs/studio/rest-api/flow] to call when an event
               #   in `configuration.filters` occurs. Used only when `type` = `studio`.
               # @param [String] configuration_retry_count The number of times to retry the
               #   webhook if the first attempt fails. Can be an integer between 0 and 3,

data/lib/twilio-ruby/rest/chat/v2/service/role.rb

@@ -16,7 +16,7 @@ module Twilio
             # Initialize the RoleList
             # @param [Version] version Version that contains the resource
             # @param [String] service_sid The SID of the
-            #   [Service](https://www.twilio.com/docs/chat/rest/service-resource) the Role
+            #   {Service}[https://www.twilio.com/docs/chat/rest/service-resource] the Role
             #   resource is associated with.
             # @return [RoleList] RoleList
             def initialize(version, service_sid: nil)
@@ -32,8 +32,8 @@ module Twilio
             # @param [String] friendly_name A descriptive string that you create to describe
             #   the new resource. It can be up to 64 characters long.
             # @param [role.RoleType] type The type of role. Can be: `channel` for
-            #   [Channel](https://www.twilio.com/docs/chat/channels) roles or `deployment` for
-            #   [Service](https://www.twilio.com/docs/chat/rest/service-resource) roles.
+            #   {Channel}[https://www.twilio.com/docs/chat/channels] roles or `deployment` for
+            #   {Service}[https://www.twilio.com/docs/chat/rest/service-resource] roles.
             # @param [String] permission A permission that you grant to the new role. Only one
             #   permission can be granted per parameter. To assign more than one permission,
             #   repeat this parameter for each permission value. The values for this parameter
@@ -172,7 +172,7 @@ module Twilio
             # Initialize the RoleContext
             # @param [Version] version Version that contains the resource
             # @param [String] service_sid The SID of the
-            #   [Service](https://www.twilio.com/docs/chat/rest/service-resource) to fetch the
+            #   {Service}[https://www.twilio.com/docs/chat/rest/service-resource] to fetch the
             #   Role resource from.
             # @param [String] sid The SID of the Role resource to fetch.
             # @return [RoleContext] RoleContext
@@ -238,7 +238,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/chat/rest/service-resource) the Role
+            #   {Service}[https://www.twilio.com/docs/chat/rest/service-resource] the Role
             #   resource is associated with.
             # @param [String] sid The SID of the Role resource to fetch.
             # @return [RoleInstance] RoleInstance

data/lib/twilio-ruby/rest/chat/v2/service/user.rb

@@ -16,7 +16,7 @@ module Twilio
             # Initialize the UserList
             # @param [Version] version Version that contains the resource
             # @param [String] service_sid The SID of the
-            #   [Service](https://www.twilio.com/docs/chat/rest/service-resource) the User
+            #   {Service}[https://www.twilio.com/docs/chat/rest/service-resource] the User
             #   resource is associated with.
             # @return [UserList] UserList
             def initialize(version, service_sid: nil)
@@ -30,12 +30,12 @@ module Twilio
             ##
             # Create the UserInstance
             # @param [String] identity The `identity` value that uniquely identifies the new
-            #   resource's [User](https://www.twilio.com/docs/chat/rest/user-resource) within
-            #   the [Service](https://www.twilio.com/docs/chat/rest/service-resource). This
+            #   resource's {User}[https://www.twilio.com/docs/chat/rest/user-resource] within
+            #   the {Service}[https://www.twilio.com/docs/chat/rest/service-resource]. This
             #   value is often a username or email address. See the Identity documentation for
             #   more info.
             # @param [String] role_sid The SID of the
-            #   [Role](https://www.twilio.com/docs/chat/rest/role-resource) to assign to the new
+            #   {Role}[https://www.twilio.com/docs/chat/rest/role-resource] to assign to the new
             #   User.
             # @param [String] attributes A valid JSON string that contains
             #   application-specific data.
@@ -179,7 +179,7 @@ module Twilio
             # Initialize the UserContext
             # @param [Version] version Version that contains the resource
             # @param [String] service_sid The SID of the
-            #   [Service](https://www.twilio.com/docs/chat/rest/service-resource) to fetch the
+            #   {Service}[https://www.twilio.com/docs/chat/rest/service-resource] to fetch the
             #   User resource from.
             # @param [String] sid The SID of the User resource to fetch. This value can be
             #   either the `sid` or the `identity` of the User resource to fetch.
@@ -215,7 +215,7 @@ module Twilio
             ##
             # Update the UserInstance
             # @param [String] role_sid The SID of the
-            #   [Role](https://www.twilio.com/docs/chat/rest/role-resource) to assign to the
+            #   {Role}[https://www.twilio.com/docs/chat/rest/role-resource] to assign to the
             #   User.
             # @param [String] attributes A valid JSON string that contains
             #   application-specific data.
@@ -302,7 +302,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/chat/rest/service-resource) the User
+            #   {Service}[https://www.twilio.com/docs/chat/rest/service-resource] the User
             #   resource is associated with.
             # @param [String] sid The SID of the User resource to fetch. This value can be
             #   either the `sid` or the `identity` of the User resource to fetch.
@@ -445,7 +445,7 @@ module Twilio
             ##
             # Update the UserInstance
             # @param [String] role_sid The SID of the
-            #   [Role](https://www.twilio.com/docs/chat/rest/role-resource) to assign to the
+            #   {Role}[https://www.twilio.com/docs/chat/rest/role-resource] to assign to the
             #   User.
             # @param [String] attributes A valid JSON string that contains
             #   application-specific data.

data/lib/twilio-ruby/rest/chat/v2/service/user/user_binding.rb

@@ -17,12 +17,12 @@ module Twilio
               # Initialize the UserBindingList
               # @param [Version] version Version that contains the resource
               # @param [String] service_sid The SID of the
-              #   [Service](https://www.twilio.com/docs/chat/rest/service-resource) the User
+              #   {Service}[https://www.twilio.com/docs/chat/rest/service-resource] the User
               #   Binding resource is associated with.
               # @param [String] user_sid The SID of the
-              #   [User](https://www.twilio.com/docs/chat/rest/user-resource) with the User
-              #   Binding resource.  See [push notification
-              #   configuration](https://www.twilio.com/docs/chat/push-notification-configuration)
+              #   {User}[https://www.twilio.com/docs/chat/rest/user-resource] with the User
+              #   Binding resource.  See {push notification
+              #   configuration}[https://www.twilio.com/docs/chat/push-notification-configuration]
               #   for more info.
               # @return [UserBindingList] UserBindingList
               def initialize(version, service_sid: nil, user_sid: nil)
@@ -38,9 +38,9 @@ module Twilio
               # Unlike stream(), this operation is eager and will load `limit` records into
               # memory before returning.
               # @param [user_binding.BindingType] binding_type The push technology used by the
-              #   User Binding resources to read. Can be: `apn`, `gcm`, or `fcm`.  See [push
+              #   User Binding resources to read. Can be: `apn`, `gcm`, or `fcm`.  See {push
               #   notification
-              #   configuration](https://www.twilio.com/docs/chat/push-notification-configuration)
+              #   configuration}[https://www.twilio.com/docs/chat/push-notification-configuration]
               #   for more info.
               # @param [Integer] limit Upper limit for the number of records to return. stream()
               #    guarantees to never return more than limit.  Default is no limit
@@ -58,9 +58,9 @@ module Twilio
               # This operation lazily loads records as efficiently as possible until the limit
               # is reached.
               # @param [user_binding.BindingType] binding_type The push technology used by the
-              #   User Binding resources to read. Can be: `apn`, `gcm`, or `fcm`.  See [push
+              #   User Binding resources to read. Can be: `apn`, `gcm`, or `fcm`.  See {push
               #   notification
-              #   configuration](https://www.twilio.com/docs/chat/push-notification-configuration)
+              #   configuration}[https://www.twilio.com/docs/chat/push-notification-configuration]
               #   for more info.
               # @param [Integer] limit Upper limit for the number of records to return. stream()
               #    guarantees to never return more than limit. Default is no limit.
@@ -95,9 +95,9 @@ module Twilio
               # Retrieve a single page of UserBindingInstance records from the API.
               # Request is executed immediately.
               # @param [user_binding.BindingType] binding_type The push technology used by the
-              #   User Binding resources to read. Can be: `apn`, `gcm`, or `fcm`.  See [push
+              #   User Binding resources to read. Can be: `apn`, `gcm`, or `fcm`.  See {push
               #   notification
-              #   configuration](https://www.twilio.com/docs/chat/push-notification-configuration)
+              #   configuration}[https://www.twilio.com/docs/chat/push-notification-configuration]
               #   for more info.
               # @param [String] page_token PageToken provided by the API
               # @param [Integer] page_number Page Number, this value is simply for client state
@@ -175,12 +175,12 @@ module Twilio
               # Initialize the UserBindingContext
               # @param [Version] version Version that contains the resource
               # @param [String] service_sid The SID of the
-              #   [Service](https://www.twilio.com/docs/chat/rest/service-resource) to fetch the
+              #   {Service}[https://www.twilio.com/docs/chat/rest/service-resource] to fetch the
               #   User Binding resource from.
               # @param [String] user_sid The SID of the
-              #   [User](https://www.twilio.com/docs/chat/rest/user-resource) with the User
-              #   Binding resource to fetch.  See [push notification
-              #   configuration](https://www.twilio.com/docs/chat/push-notification-configuration)
+              #   {User}[https://www.twilio.com/docs/chat/rest/user-resource] with the User
+              #   Binding resource to fetch.  See {push notification
+              #   configuration}[https://www.twilio.com/docs/chat/push-notification-configuration]
               #   for more info.
               # @param [String] sid The SID of the User Binding resource to fetch.
               # @return [UserBindingContext] UserBindingContext
@@ -235,12 +235,12 @@ 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/chat/rest/service-resource) the User
+              #   {Service}[https://www.twilio.com/docs/chat/rest/service-resource] the User
               #   Binding resource is associated with.
               # @param [String] user_sid The SID of the
-              #   [User](https://www.twilio.com/docs/chat/rest/user-resource) with the User
-              #   Binding resource.  See [push notification
-              #   configuration](https://www.twilio.com/docs/chat/push-notification-configuration)
+              #   {User}[https://www.twilio.com/docs/chat/rest/user-resource] with the User
+              #   Binding resource.  See {push notification
+              #   configuration}[https://www.twilio.com/docs/chat/push-notification-configuration]
               #   for more info.
               # @param [String] sid The SID of the User Binding resource to fetch.
               # @return [UserBindingInstance] UserBindingInstance

data/lib/twilio-ruby/rest/chat/v2/service/user/user_channel.rb

@@ -17,10 +17,10 @@ module Twilio
               # Initialize the UserChannelList
               # @param [Version] version Version that contains the resource
               # @param [String] service_sid The SID of the
-              #   [Service](https://www.twilio.com/docs/chat/rest/service-resource) the User
+              #   {Service}[https://www.twilio.com/docs/chat/rest/service-resource] the User
               #   Channel resource is associated with.
               # @param [String] user_sid The SID of the
-              #   [User](https://www.twilio.com/docs/chat/rest/user-resource) the User Channel
+              #   {User}[https://www.twilio.com/docs/chat/rest/user-resource] the User Channel
               #   belongs to.
               # @return [UserChannelList] UserChannelList
               def initialize(version, service_sid: nil, user_sid: nil)
@@ -157,14 +157,14 @@ module Twilio
               # Initialize the UserChannelContext
               # @param [Version] version Version that contains the resource
               # @param [String] service_sid The SID of the
-              #   [Service](https://www.twilio.com/docs/chat/rest/service-resource) to fetch the
+              #   {Service}[https://www.twilio.com/docs/chat/rest/service-resource] to fetch the
               #   User Channel resource from.
               # @param [String] user_sid The SID of the
-              #   [User](https://www.twilio.com/docs/chat/rest/user-resource) to fetch the User
+              #   {User}[https://www.twilio.com/docs/chat/rest/user-resource] to fetch the User
               #   Channel resource from. This value can be either the `sid` or the `identity` of
               #   the User resource.
               # @param [String] channel_sid The SID of the
-              #   [Channel](https://www.twilio.com/docs/chat/channels) that has the User Channel
+              #   {Channel}[https://www.twilio.com/docs/chat/channels] that has the User Channel
               #   to fetch. This value can be either the `sid` or the `unique_name` of the Channel
               #   to fetch.
               # @return [UserChannelContext] UserChannelContext
@@ -203,12 +203,12 @@ module Twilio
               # @param [user_channel.NotificationLevel] notification_level The push notification
               #   level to assign to the User Channel. Can be: `default` or `muted`.
               # @param [String] last_consumed_message_index The index of the last
-              #   [Message](https://www.twilio.com/docs/chat/rest/message-resource) in the
-              #   [Channel](https://www.twilio.com/docs/chat/channels) that the Member has read.
-              # @param [Time] last_consumption_timestamp The [ISO
-              #   8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp of the last
-              #   [Message](https://www.twilio.com/docs/chat/rest/message-resource) read event for
-              #   the Member within the [Channel](https://www.twilio.com/docs/chat/channels).
+              #   {Message}[https://www.twilio.com/docs/chat/rest/message-resource] in the
+              #   {Channel}[https://www.twilio.com/docs/chat/channels] that the Member has read.
+              # @param [Time] last_consumption_timestamp The {ISO
+              #   8601}[https://en.wikipedia.org/wiki/ISO_8601] timestamp of the last
+              #   {Message}[https://www.twilio.com/docs/chat/rest/message-resource] read event for
+              #   the Member within the {Channel}[https://www.twilio.com/docs/chat/channels].
               # @return [UserChannelInstance] Updated UserChannelInstance
               def update(notification_level: :unset, last_consumed_message_index: :unset, last_consumption_timestamp: :unset)
                 data = Twilio::Values.of({
@@ -249,13 +249,13 @@ 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/chat/rest/service-resource) the User
+              #   {Service}[https://www.twilio.com/docs/chat/rest/service-resource] the User
               #   Channel resource is associated with.
               # @param [String] user_sid The SID of the
-              #   [User](https://www.twilio.com/docs/chat/rest/user-resource) the User Channel
+              #   {User}[https://www.twilio.com/docs/chat/rest/user-resource] the User Channel
               #   belongs to.
               # @param [String] channel_sid The SID of the
-              #   [Channel](https://www.twilio.com/docs/chat/channels) that has the User Channel
+              #   {Channel}[https://www.twilio.com/docs/chat/channels] that has the User Channel
               #   to fetch. This value can be either the `sid` or the `unique_name` of the Channel
               #   to fetch.
               # @return [UserChannelInstance] UserChannelInstance
@@ -387,12 +387,12 @@ module Twilio
               # @param [user_channel.NotificationLevel] notification_level The push notification
               #   level to assign to the User Channel. Can be: `default` or `muted`.
               # @param [String] last_consumed_message_index The index of the last
-              #   [Message](https://www.twilio.com/docs/chat/rest/message-resource) in the
-              #   [Channel](https://www.twilio.com/docs/chat/channels) that the Member has read.
-              # @param [Time] last_consumption_timestamp The [ISO
-              #   8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp of the last
-              #   [Message](https://www.twilio.com/docs/chat/rest/message-resource) read event for
-              #   the Member within the [Channel](https://www.twilio.com/docs/chat/channels).
+              #   {Message}[https://www.twilio.com/docs/chat/rest/message-resource] in the
+              #   {Channel}[https://www.twilio.com/docs/chat/channels] that the Member has read.
+              # @param [Time] last_consumption_timestamp The {ISO
+              #   8601}[https://en.wikipedia.org/wiki/ISO_8601] timestamp of the last
+              #   {Message}[https://www.twilio.com/docs/chat/rest/message-resource] read event for
+              #   the Member within the {Channel}[https://www.twilio.com/docs/chat/channels].
               # @return [UserChannelInstance] Updated UserChannelInstance
               def update(notification_level: :unset, last_consumed_message_index: :unset, last_consumption_timestamp: :unset)
                 context.update(

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

@@ -13,11 +13,11 @@ module Twilio
     class Client
       @@default_region = 'us1'
 
-      attr_accessor :http_client, :username, :password, :account_sid, :auth_token, :region, :edge
+      attr_accessor :http_client, :username, :password, :account_sid, :auth_token, :region, :edge, :logger
 
       ##
       # Initializes the Twilio Client
-      def initialize(username=nil, password=nil, account_sid=nil, region=nil, http_client=nil)
+      def initialize(username=nil, password=nil, account_sid=nil, region=nil, http_client=nil, logger=nil)
         @username = username || Twilio.account_sid
         @password = password || Twilio.auth_token
         @region = region || Twilio.region
@@ -26,6 +26,7 @@ module Twilio
         @auth_token = @password
         @auth = [@username, @password]
         @http_client = http_client || Twilio.http_client || Twilio::HTTP::Client.new
+        @logger = logger || Twilio.logger
 
         # Domains
         @accounts = nil
@@ -80,7 +81,24 @@ module Twilio
 
         uri = build_uri(uri)
 
-        @http_client.request(
+        if @logger
+          @logger.debug("--BEGIN Twilio API Request--")
+          @logger.debug("Request Method: <#{method}>")
+
+          headers.each do |key, value|
+            unless key.downcase == 'authorization'
+              @logger.debug("#{key}:#{value}")
+            end
+          end
+
+          url = URI(uri)
+          @logger.debug("Host:#{url.host}")
+          @logger.debug("Path:#{url.path}")
+          @logger.debug("Query:#{url.query}")
+          @logger.debug("Request Params:#{params}")
+        end
+
+        response = @http_client.request(
           host,
           port,
           method,
@@ -91,6 +109,14 @@ module Twilio
           auth,
           timeout
         )
+
+        if @logger
+          @logger.debug("Response Status Code:#{response.status_code}")
+          @logger.debug("Response Headers:#{response.headers}")
+          @logger.debug("--END TWILIO API REQUEST--")
+        end
+
+        response
       end
 
       ##
@@ -333,7 +359,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/conversations/v1/configuration.rb

@@ -10,8 +10,6 @@ module Twilio
   module REST
     class Conversations < Domain
       class V1 < Version
-        ##
-        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
         class ConfigurationList < ListResource
           ##
           # Initialize the ConfigurationList
@@ -31,8 +29,6 @@ module Twilio
           end
         end
 
-        ##
-        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
         class ConfigurationPage < Page
           ##
           # Initialize the ConfigurationPage
@@ -62,8 +58,6 @@ module Twilio
           end
         end
 
-        ##
-        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
         class ConfigurationContext < InstanceContext
           ##
           # Initialize the ConfigurationContext
@@ -91,11 +85,11 @@ module Twilio
 
           ##
           # Update the ConfigurationInstance
-          # @param [String] default_chat_service_sid The SID of the default [Conversation
-          #   Service](https://www.twilio.com/docs/conversations/api/service-resource) to use
+          # @param [String] default_chat_service_sid The SID of the default {Conversation
+          #   Service}[https://www.twilio.com/docs/conversations/api/service-resource] to use
           #   when creating a conversation.
-          # @param [String] default_messaging_service_sid The SID of the default [Messaging
-          #   Service](https://www.twilio.com/docs/sms/services/api) to use when creating a
+          # @param [String] default_messaging_service_sid The SID of the default {Messaging
+          #   Service}[https://www.twilio.com/docs/sms/services/api] to use when creating a
           #   conversation.
           # @param [String] default_inactive_timer Default ISO8601 duration when
           #   conversation will be switched to `inactive` state. Minimum value for this timer
@@ -138,8 +132,6 @@ module Twilio
           end
         end
 
-        ##
-        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
         class ConfigurationInstance < InstanceResource
           ##
           # Initialize the ConfigurationInstance
@@ -207,13 +199,13 @@ module Twilio
           end
 
           ##
-          # @return [String] The url
+          # @return [String] An absolute URL for this global configuration.
           def url
             @properties['url']
           end
 
           ##
-          # @return [String] The links
+          # @return [String] Absolute URLs to access the webhook and default service configurations.
           def links
             @properties['links']
           end
@@ -227,11 +219,11 @@ module Twilio
 
           ##
           # Update the ConfigurationInstance
-          # @param [String] default_chat_service_sid The SID of the default [Conversation
-          #   Service](https://www.twilio.com/docs/conversations/api/service-resource) to use
+          # @param [String] default_chat_service_sid The SID of the default {Conversation
+          #   Service}[https://www.twilio.com/docs/conversations/api/service-resource] to use
           #   when creating a conversation.
-          # @param [String] default_messaging_service_sid The SID of the default [Messaging
-          #   Service](https://www.twilio.com/docs/sms/services/api) to use when creating a
+          # @param [String] default_messaging_service_sid The SID of the default {Messaging
+          #   Service}[https://www.twilio.com/docs/sms/services/api] to use when creating a
           #   conversation.
           # @param [String] default_inactive_timer Default ISO8601 duration when
           #   conversation will be switched to `inactive` state. Minimum value for this timer