twilio-ruby 5.39.2 → 5.60.0

data/lib/twilio-ruby/rest/bulkexports/v1/export/export_custom_job.rb

@@ -11,13 +11,12 @@ module Twilio
     class Bulkexports < Domain
       class V1 < Version
         class ExportContext < InstanceContext
-          ##
-          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class ExportCustomJobList < ListResource
             ##
             # Initialize the ExportCustomJobList
             # @param [Version] version Version that contains the resource
-            # @param [String] resource_type The type of communication – Messages, Calls
+            # @param [String] resource_type The type of communication – Messages, Calls,
+            #   Conferences, and Participants
             # @return [ExportCustomJobList] ExportCustomJobList
             def initialize(version, resource_type: nil)
               super(version)
@@ -31,10 +30,6 @@ module Twilio
             # Lists ExportCustomJobInstance records from the API as a list.
             # Unlike stream(), this operation is eager and will load `limit` records into
             # memory before returning.
-            # @param [String] next_token The token for the next page of job results, and may
-            #   be null if there are no more pages
-            # @param [String] previous_token The token for the previous page of results, and
-            #   may be null if this is the first page
             # @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
@@ -42,23 +37,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(next_token: :unset, previous_token: :unset, limit: nil, page_size: nil)
-              self.stream(
-                  next_token: next_token,
-                  previous_token: previous_token,
-                  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 ExportCustomJobInstance records from the API as an Enumerable.
             # This operation lazily loads records as efficiently as possible until the limit
             # is reached.
-            # @param [String] next_token The token for the next page of job results, and may
-            #   be null if there are no more pages
-            # @param [String] previous_token The token for the previous page of results, and
-            #   may be null if this is the first page
             # @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
@@ -66,14 +52,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(next_token: :unset, previous_token: :unset, limit: nil, page_size: nil)
+            def stream(limit: nil, page_size: nil)
               limits = @version.read_limits(limit, page_size)
 
-              page = self.page(
-                  next_token: next_token,
-                  previous_token: previous_token,
-                  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,18 +77,12 @@ module Twilio
             ##
             # Retrieve a single page of ExportCustomJobInstance records from the API.
             # Request is executed immediately.
-            # @param [String] next_token The token for the next page of job results, and may
-            #   be null if there are no more pages
-            # @param [String] previous_token The token for the previous page of results, and
-            #   may be null if this is the first page
             # @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 ExportCustomJobInstance
-            def page(next_token: :unset, previous_token: :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({
-                  'NextToken' => next_token,
-                  'PreviousToken' => previous_token,
                   'PageToken' => page_token,
                   'Page' => page_number,
                   'PageSize' => page_size,
@@ -132,18 +108,26 @@ module Twilio
 
             ##
             # Create the ExportCustomJobInstance
-            # @param [String] friendly_name The friendly_name
-            # @param [String] start_day The start_day
-            # @param [String] end_day The end_day
-            # @param [String] webhook_url The webhook_url
-            # @param [String] webhook_method The webhook_method
-            # @param [String] email The email
+            # @param [String] start_day The start day for the custom export specified as a
+            #   string in the format of yyyy-mm-dd
+            # @param [String] end_day The end day for the custom export specified as a string
+            #   in the format of yyyy-mm-dd. End day is inclusive and must be 2 days earlier
+            #   than the current UTC day.
+            # @param [String] friendly_name The friendly name specified when creating the job
+            # @param [String] webhook_url The optional webhook url called on completion of the
+            #   job. If this is supplied, `WebhookMethod` must also be supplied. If you set
+            #   neither webhook nor email, you will have to check your job's status manually.
+            # @param [String] webhook_method This is the method used to call the webhook on
+            #   completion of the job. If this is supplied, `WebhookUrl` must also be supplied.
+            # @param [String] email The optional email to send the completion notification to.
+            #   You can set both webhook, and email, or one or the other. If you set neither,
+            #   the job will run but you will have to query to determine your job's status.
             # @return [ExportCustomJobInstance] Created ExportCustomJobInstance
-            def create(friendly_name: :unset, start_day: :unset, end_day: :unset, webhook_url: :unset, webhook_method: :unset, email: :unset)
+            def create(start_day: nil, end_day: nil, friendly_name: nil, webhook_url: :unset, webhook_method: :unset, email: :unset)
               data = Twilio::Values.of({
-                  'FriendlyName' => friendly_name,
                   'StartDay' => start_day,
                   'EndDay' => end_day,
+                  'FriendlyName' => friendly_name,
                   'WebhookUrl' => webhook_url,
                   'WebhookMethod' => webhook_method,
                   'Email' => email,
@@ -161,8 +145,6 @@ module Twilio
             end
           end
 
-          ##
-          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class ExportCustomJobPage < Page
             ##
             # Initialize the ExportCustomJobPage
@@ -192,14 +174,13 @@ module Twilio
             end
           end
 
-          ##
-          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class ExportCustomJobInstance < InstanceResource
             ##
             # Initialize the ExportCustomJobInstance
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
-            # @param [String] resource_type The type of communication – Messages, Calls
+            # @param [String] resource_type The type of communication – Messages, Calls,
+            #   Conferences, and Participants
             # @return [ExportCustomJobInstance] ExportCustomJobInstance
             def initialize(version, payload, resource_type: nil)
               super(version)
@@ -215,6 +196,8 @@ module Twilio
                   'email' => payload['email'],
                   'job_sid' => payload['job_sid'],
                   'details' => payload['details'],
+                  'job_queue_position' => payload['job_queue_position'],
+                  'estimated_completion_time' => payload['estimated_completion_time'],
               }
             end
 
@@ -225,19 +208,19 @@ module Twilio
             end
 
             ##
-            # @return [String] The type of communication – Messages, Calls
+            # @return [String] The type of communication – Messages, Calls, Conferences, and Participants
             def resource_type
               @properties['resource_type']
             end
 
             ##
-            # @return [String] The start time for the export specified when creating the job
+            # @return [String] The start day for the custom export specified as a string in the format of yyyy-MM-dd
             def start_day
               @properties['start_day']
             end
 
             ##
-            # @return [String] The end time for the export specified when creating the job
+            # @return [String] The end day for the custom export specified as a string in the format of yyyy-MM-dd. This will be the last day exported. For instance, to export a single day, choose the same day for start and end day. To export the first 4 days of July, you would set the start date to 2020-07-01 and the end date to 2020-07-04. The end date must be the UTC day before yesterday.
             def end_day
               @properties['end_day']
             end
@@ -261,17 +244,29 @@ module Twilio
             end
 
             ##
-            # @return [String] The job_sid returned when the export was created
+            # @return [String] The unique job_sid returned when the custom export was created. This can be used to look up the status of the job.
             def job_sid
               @properties['job_sid']
             end
 
             ##
-            # @return [Hash] The details
+            # @return [Hash] The details of a job state which is an object that contains a `status` string, a day count integer, and list of days in the job
             def details
               @properties['details']
             end
 
+            ##
+            # @return [String] This is the job position from the 1st in line. Your queue position will never increase. As jobs ahead of yours in the queue are processed, the queue position number will decrease
+            def job_queue_position
+              @properties['job_queue_position']
+            end
+
+            ##
+            # @return [String] this is the time estimated until your job is complete. This is calculated each time you request the job list. The time is calculated based on the current rate of job completion (which may vary) and your job queue position
+            def estimated_completion_time
+              @properties['estimated_completion_time']
+            end
+
             ##
             # Provide a user friendly representation
             def to_s

data/lib/twilio-ruby/rest/bulkexports/v1/export/job.rb

@@ -11,8 +11,6 @@ module Twilio
     class Bulkexports < Domain
       class V1 < Version
         class ExportList < ListResource
-          ##
-          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class JobList < ListResource
             ##
             # Initialize the JobList
@@ -32,8 +30,6 @@ module Twilio
             end
           end
 
-          ##
-          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class JobPage < Page
             ##
             # Initialize the JobPage
@@ -63,13 +59,12 @@ module Twilio
             end
           end
 
-          ##
-          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class JobContext < InstanceContext
             ##
             # Initialize the JobContext
             # @param [Version] version Version that contains the resource
-            # @param [String] job_sid The job_sid
+            # @param [String] job_sid The unique string that that we created to identify the
+            #   Bulk Export job
             # @return [JobContext] JobContext
             def initialize(version, job_sid)
               super(version)
@@ -110,14 +105,13 @@ module Twilio
             end
           end
 
-          ##
-          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class JobInstance < InstanceResource
             ##
             # Initialize the JobInstance
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
-            # @param [String] job_sid The job_sid
+            # @param [String] job_sid The unique string that that we created to identify the
+            #   Bulk Export job
             # @return [JobInstance] JobInstance
             def initialize(version, payload, job_sid: nil)
               super(version)
@@ -134,6 +128,8 @@ module Twilio
                   'webhook_method' => payload['webhook_method'],
                   'email' => payload['email'],
                   'url' => payload['url'],
+                  'job_queue_position' => payload['job_queue_position'],
+                  'estimated_completion_time' => payload['estimated_completion_time'],
               }
 
               # Context
@@ -153,7 +149,7 @@ module Twilio
             end
 
             ##
-            # @return [String] The type of communication – Messages, Calls
+            # @return [String] The type of communication – Messages, Calls, Conferences, and Participants
             def resource_type
               @properties['resource_type']
             end
@@ -165,7 +161,7 @@ module Twilio
             end
 
             ##
-            # @return [Hash] This is a list of the completed, pending, or errored dates within the export time range, with one entry for each status with more than one day in that status
+            # @return [Hash] The details of a job state which is an object that contains a `status` string, a day count integer, and list of days in the job
             def details
               @properties['details']
             end
@@ -212,6 +208,18 @@ module Twilio
               @properties['url']
             end
 
+            ##
+            # @return [String] This is the job position from the 1st in line. Your queue position will never increase. As jobs ahead of yours in the queue are processed, the queue position number will decrease
+            def job_queue_position
+              @properties['job_queue_position']
+            end
+
+            ##
+            # @return [String] this is the time estimated until your job is complete. This is calculated each time you request the job list. The time is calculated based on the current rate of job completion (which may vary) and your job queue position
+            def estimated_completion_time
+              @properties['estimated_completion_time']
+            end
+
             ##
             # Fetch the JobInstance
             # @return [JobInstance] Fetched JobInstance

data/lib/twilio-ruby/rest/bulkexports/v1/export.rb

@@ -10,8 +10,6 @@ module Twilio
   module REST
     class Bulkexports < Domain
       class V1 < Version
-        ##
-        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
         class ExportList < ListResource
           ##
           # Initialize the ExportList
@@ -29,7 +27,8 @@ module Twilio
 
           ##
           # Access the jobs
-          # @param [String] job_sid The job_sid
+          # @param [String] job_sid The unique string that that we created to identify the
+          #   Bulk Export job
           # @return [JobList]
           # @return [JobContext] if job_sid was passed.
           def jobs(job_sid=:unset)
@@ -49,8 +48,6 @@ module Twilio
           end
         end
 
-        ##
-        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
         class ExportPage < Page
           ##
           # Initialize the ExportPage
@@ -80,13 +77,12 @@ module Twilio
           end
         end
 
-        ##
-        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
         class ExportContext < InstanceContext
           ##
           # Initialize the ExportContext
           # @param [Version] version Version that contains the resource
-          # @param [String] resource_type The type of communication – Messages, Calls
+          # @param [String] resource_type The type of communication – Messages, Calls,
+          #   Conferences, and Participants
           # @return [ExportContext] ExportContext
           def initialize(version, resource_type)
             super(version)
@@ -154,14 +150,13 @@ module Twilio
           end
         end
 
-        ##
-        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
         class ExportInstance < InstanceResource
           ##
           # Initialize the ExportInstance
           # @param [Version] version Version that contains the resource
           # @param [Hash] payload payload that contains response from Twilio
-          # @param [String] resource_type The type of communication – Messages, Calls
+          # @param [String] resource_type The type of communication – Messages, Calls,
+          #   Conferences, and Participants
           # @return [ExportInstance] ExportInstance
           def initialize(version, payload, resource_type: nil)
             super(version)
@@ -190,7 +185,7 @@ module Twilio
           end
 
           ##
-          # @return [String] The type of communication – Messages, Calls
+          # @return [String] The type of communication – Messages, Calls, Conferences, and Participants
           def resource_type
             @properties['resource_type']
           end

data/lib/twilio-ruby/rest/bulkexports/v1/export_configuration.rb

@@ -10,8 +10,6 @@ module Twilio
   module REST
     class Bulkexports < Domain
       class V1 < Version
-        ##
-        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
         class ExportConfigurationList < ListResource
           ##
           # Initialize the ExportConfigurationList
@@ -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 ExportConfigurationPage < Page
           ##
           # Initialize the ExportConfigurationPage
@@ -62,13 +58,12 @@ module Twilio
           end
         end
 
-        ##
-        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
         class ExportConfigurationContext < InstanceContext
           ##
           # Initialize the ExportConfigurationContext
           # @param [Version] version Version that contains the resource
-          # @param [String] resource_type The type of communication – Messages, Calls
+          # @param [String] resource_type The type of communication – Messages, Calls,
+          #   Conferences, and Participants
           # @return [ExportConfigurationContext] ExportConfigurationContext
           def initialize(version, resource_type)
             super(version)
@@ -124,14 +119,13 @@ module Twilio
           end
         end
 
-        ##
-        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
         class ExportConfigurationInstance < InstanceResource
           ##
           # Initialize the ExportConfigurationInstance
           # @param [Version] version Version that contains the resource
           # @param [Hash] payload payload that contains response from Twilio
-          # @param [String] resource_type The type of communication – Messages, Calls
+          # @param [String] resource_type The type of communication – Messages, Calls,
+          #   Conferences, and Participants
           # @return [ExportConfigurationInstance] ExportConfigurationInstance
           def initialize(version, payload, resource_type: nil)
             super(version)
@@ -180,7 +174,7 @@ module Twilio
           end
 
           ##
-          # @return [String] The type of communication – Messages, Calls
+          # @return [String] The type of communication – Messages, Calls, Conferences, and Participants
           def resource_type
             @properties['resource_type']
           end

data/lib/twilio-ruby/rest/bulkexports/v1.rb

@@ -20,30 +20,34 @@ module Twilio
         end
 
         ##
-        # @param [String] resource_type The type of communication – Messages, Calls
+        # @param [String] resource_type The type of communication – Messages, Calls,
+        #   Conferences, and Participants
         # @return [Twilio::REST::Bulkexports::V1::ExportContext] if resource_type was passed.
         # @return [Twilio::REST::Bulkexports::V1::ExportList]
         def exports(resource_type=:unset)
           if resource_type.nil?
-            raise ArgumentError, 'resource_type cannot be nil'
-          elsif resource_type == :unset
-            @exports ||= ExportList.new self
+              raise ArgumentError, 'resource_type cannot be nil'
+          end
+          if resource_type == :unset
+              @exports ||= ExportList.new self
           else
-            ExportContext.new(self, resource_type)
+              ExportContext.new(self, resource_type)
           end
         end
 
         ##
-        # @param [String] resource_type The type of communication – Messages, Calls
+        # @param [String] resource_type The type of communication – Messages, Calls,
+        #   Conferences, and Participants
         # @return [Twilio::REST::Bulkexports::V1::ExportConfigurationContext] if resource_type was passed.
         # @return [Twilio::REST::Bulkexports::V1::ExportConfigurationList]
         def export_configuration(resource_type=:unset)
           if resource_type.nil?
-            raise ArgumentError, 'resource_type cannot be nil'
-          elsif resource_type == :unset
-            @export_configuration ||= ExportConfigurationList.new self
+              raise ArgumentError, 'resource_type cannot be nil'
+          end
+          if resource_type == :unset
+              @export_configuration ||= ExportConfigurationList.new self
           else
-            ExportConfigurationContext.new(self, resource_type)
+              ExportConfigurationContext.new(self, resource_type)
           end
         end
 

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

@@ -29,7 +29,8 @@ module Twilio
       end
 
       ##
-      # @param [String] resource_type The type of communication – Messages, Calls
+      # @param [String] resource_type The type of communication – Messages, Calls,
+      #   Conferences, and Participants
       # @return [Twilio::REST::Bulkexports::V1::ExportInstance] if resource_type was passed.
       # @return [Twilio::REST::Bulkexports::V1::ExportList]
       def exports(resource_type=:unset)
@@ -37,7 +38,8 @@ module Twilio
       end
 
       ##
-      # @param [String] resource_type The type of communication – Messages, Calls
+      # @param [String] resource_type The type of communication – Messages, Calls,
+      #   Conferences, and Participants
       # @return [Twilio::REST::Bulkexports::V1::ExportConfigurationInstance] if resource_type was passed.
       # @return [Twilio::REST::Bulkexports::V1::ExportConfigurationList]
       def export_configuration(resource_type=:unset)

data/lib/twilio-ruby/rest/chat/v1/service/channel/invite.rb

@@ -17,10 +17,10 @@ module Twilio
               # Initialize the InviteList
               # @param [Version] version Version that contains the resource
               # @param [String] service_sid The SID of the
-              #   [Service](https://www.twilio.com/docs/api/chat/rest/services) the resource is
+              #   {Service}[https://www.twilio.com/docs/api/chat/rest/services] the resource is
               #   associated with.
               # @param [String] channel_sid The SID of the
-              #   [Channel](https://www.twilio.com/docs/api/chat/rest/channels) the resource
+              #   {Channel}[https://www.twilio.com/docs/api/chat/rest/channels] the resource
               #   belongs to.
               # @return [InviteList] InviteList
               def initialize(version, service_sid: nil, channel_sid: nil)
@@ -34,12 +34,12 @@ module Twilio
               ##
               # Create the InviteInstance
               # @param [String] identity The `identity` value that uniquely identifies the new
-              #   resource's [User](https://www.twilio.com/docs/api/chat/rest/v1/user) within the
-              #   [Service](https://www.twilio.com/docs/api/chat/rest/v1/service). See [access
-              #   tokens](https://www.twilio.com/docs/api/chat/guides/create-tokens) for more
+              #   resource's {User}[https://www.twilio.com/docs/api/chat/rest/v1/user] within the
+              #   {Service}[https://www.twilio.com/docs/api/chat/rest/v1/service]. See {access
+              #   tokens}[https://www.twilio.com/docs/api/chat/guides/create-tokens] for more
               #   info.
               # @param [String] role_sid The SID of the
-              #   [Role](https://www.twilio.com/docs/api/chat/rest/roles) assigned to the new
+              #   {Role}[https://www.twilio.com/docs/api/chat/rest/roles] assigned to the new
               #   member.
               # @return [InviteInstance] Created InviteInstance
               def create(identity: nil, role_sid: :unset)
@@ -59,10 +59,10 @@ module Twilio
               # Lists InviteInstance records from the API as a list.
               # Unlike stream(), this operation is eager and will load `limit` records into
               # memory before returning.
-              # @param [String] identity The
-              #   [User](https://www.twilio.com/docs/api/chat/rest/v1/user)'s `identity` value of
-              #   the resources to read. See [access
-              #   tokens](https://www.twilio.com/docs/api/chat/guides/create-tokens) for more
+              # @param [Array[String]] identity The
+              #   {User}[https://www.twilio.com/docs/api/chat/rest/v1/user]'s `identity` value of
+              #   the resources to read. See {access
+              #   tokens}[https://www.twilio.com/docs/api/chat/guides/create-tokens] for more
               #   details.
               # @param [Integer] limit Upper limit for the number of records to return. stream()
               #    guarantees to never return more than limit.  Default is no limit
@@ -79,10 +79,10 @@ module Twilio
               # Streams InviteInstance records from the API as an Enumerable.
               # This operation lazily loads records as efficiently as possible until the limit
               # is reached.
-              # @param [String] identity The
-              #   [User](https://www.twilio.com/docs/api/chat/rest/v1/user)'s `identity` value of
-              #   the resources to read. See [access
-              #   tokens](https://www.twilio.com/docs/api/chat/guides/create-tokens) for more
+              # @param [Array[String]] identity The
+              #   {User}[https://www.twilio.com/docs/api/chat/rest/v1/user]'s `identity` value of
+              #   the resources to read. See {access
+              #   tokens}[https://www.twilio.com/docs/api/chat/guides/create-tokens] for more
               #   details.
               # @param [Integer] limit Upper limit for the number of records to return. stream()
               #    guarantees to never return more than limit. Default is no limit.
@@ -116,10 +116,10 @@ module Twilio
               ##
               # Retrieve a single page of InviteInstance records from the API.
               # Request is executed immediately.
-              # @param [String] identity The
-              #   [User](https://www.twilio.com/docs/api/chat/rest/v1/user)'s `identity` value of
-              #   the resources to read. See [access
-              #   tokens](https://www.twilio.com/docs/api/chat/guides/create-tokens) for more
+              # @param [Array[String]] identity The
+              #   {User}[https://www.twilio.com/docs/api/chat/rest/v1/user]'s `identity` value of
+              #   the resources to read. See {access
+              #   tokens}[https://www.twilio.com/docs/api/chat/guides/create-tokens] for more
               #   details.
               # @param [String] page_token PageToken provided by the API
               # @param [Integer] page_number Page Number, this value is simply for client state
@@ -197,10 +197,10 @@ module Twilio
               # Initialize the InviteContext
               # @param [Version] version Version that contains the resource
               # @param [String] service_sid The SID of the
-              #   [Service](https://www.twilio.com/docs/api/chat/rest/services) to fetch the
+              #   {Service}[https://www.twilio.com/docs/api/chat/rest/services] to fetch the
               #   resource from.
               # @param [String] channel_sid The SID of the
-              #   [Channel](https://www.twilio.com/docs/api/chat/rest/channels) the resource to
+              #   {Channel}[https://www.twilio.com/docs/api/chat/rest/channels] the resource to
               #   fetch belongs to.
               # @param [String] sid The Twilio-provided string that uniquely identifies the
               #   Invite resource to fetch.
@@ -256,10 +256,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/api/chat/rest/services) the resource is
+              #   {Service}[https://www.twilio.com/docs/api/chat/rest/services] the resource is
               #   associated with.
               # @param [String] channel_sid The SID of the
-              #   [Channel](https://www.twilio.com/docs/api/chat/rest/channels) the resource
+              #   {Channel}[https://www.twilio.com/docs/api/chat/rest/channels] the resource
               #   belongs to.
               # @param [String] sid The Twilio-provided string that uniquely identifies the
               #   Invite resource to fetch.