twilio-ruby 5.10.3 → 5.10.4

data/lib/twilio-ruby/rest/api/v2010/account/call/feedback.rb

@@ -17,7 +17,7 @@ module Twilio
               # Initialize the FeedbackList
               # @param [Version] version Version that contains the resource
               # @param [String] account_sid The account_sid
-              # @param [String] call_sid A 34 character string that uniquely identifies this
+              # @param [String] call_sid A 34-character string that uniquely identifies the Call
               #   resource.
               # @return [FeedbackList] FeedbackList
               def initialize(version, account_sid: nil, call_sid: nil)
@@ -174,7 +174,7 @@ module Twilio
               # @param [Version] version Version that contains the resource
               # @param [Hash] payload payload that contains response from Twilio
               # @param [String] account_sid The account_sid
-              # @param [String] call_sid A 34 character string that uniquely identifies this
+              # @param [String] call_sid A 34-character string that uniquely identifies the Call
               #   resource.
               # @return [FeedbackInstance] FeedbackInstance
               def initialize(version, payload, account_sid: nil, call_sid: nil)

data/lib/twilio-ruby/rest/api/v2010/account/call/feedback_summary.rb

@@ -18,7 +18,7 @@ module Twilio
               # @param [Version] version Version that contains the resource
               # @param [String] account_sid The unique id of the
               #   [Account](https://www.twilio.com/docs/api/rest/account) responsible for creating
-              #   this call.
+              #   this Call.
               # @return [FeedbackSummaryList] FeedbackSummaryList
               def initialize(version, account_sid: nil)
                 super(version)
@@ -154,7 +154,7 @@ module Twilio
               # @param [Hash] payload payload that contains response from Twilio
               # @param [String] account_sid The unique id of the
               #   [Account](https://www.twilio.com/docs/api/rest/account) responsible for creating
-              #   this call.
+              #   this Call.
               # @param [String] sid The sid
               # @return [FeedbackSummaryInstance] FeedbackSummaryInstance
               def initialize(version, payload, account_sid: nil, sid: nil)

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

@@ -246,8 +246,10 @@ module Twilio
             # Update the ConferenceInstance
             # @param [conference.UpdateStatus] status Specifying `completed` will end the
             #   conference and kick all participants
-            # @param [String] announce_url The announce_url
-            # @param [String] announce_method The announce_method
+            # @param [String] announce_url The 'AnnounceUrl' attribute lets you specify a URL
+            #   for announcing something into a conference. The URL may return an MP3, a WAV or
+            #   a TwiML document with `<Play>` or `<Say>`.
+            # @param [String] announce_method Specify GET or POST, defaults to POST
             # @return [ConferenceInstance] Updated ConferenceInstance
             def update(status: :unset, announce_url: :unset, announce_method: :unset)
               data = Twilio::Values.of({
@@ -414,8 +416,10 @@ module Twilio
             # Update the ConferenceInstance
             # @param [conference.UpdateStatus] status Specifying `completed` will end the
             #   conference and kick all participants
-            # @param [String] announce_url The announce_url
-            # @param [String] announce_method The announce_method
+            # @param [String] announce_url The 'AnnounceUrl' attribute lets you specify a URL
+            #   for announcing something into a conference. The URL may return an MP3, a WAV or
+            #   a TwiML document with `<Play>` or `<Say>`.
+            # @param [String] announce_method Specify GET or POST, defaults to POST
             # @return [ConferenceInstance] Updated ConferenceInstance
             def update(status: :unset, announce_url: :unset, announce_method: :unset)
               context.update(status: status, announce_url: announce_url, announce_method: announce_method, )

data/lib/twilio-ruby/rest/api/v2010/account/conference/participant.rb

@@ -301,8 +301,10 @@ module Twilio
               #   music that plays when a participant is held. The URL may be an MP3, a WAV or a
               #   TwiML document that uses `<Play>`, `<Say>` or `<Redirect>`.
               # @param [String] hold_method Specify GET or POST, defaults to GET
-              # @param [String] announce_url The announce_url
-              # @param [String] announce_method The announce_method
+              # @param [String] announce_url The 'AnnounceUrl' attribute lets you specify a URL
+              #   for announcing something to the participant. The URL may return an MP3, a WAV or
+              #   a TwiML document with `<Play>` or `<Say>`.
+              # @param [String] announce_method Specify GET or POST, defaults to POST
               # @return [ParticipantInstance] Updated ParticipantInstance
               def update(muted: :unset, hold: :unset, hold_url: :unset, hold_method: :unset, announce_url: :unset, announce_method: :unset)
                 data = Twilio::Values.of({
@@ -483,8 +485,10 @@ module Twilio
               #   music that plays when a participant is held. The URL may be an MP3, a WAV or a
               #   TwiML document that uses `<Play>`, `<Say>` or `<Redirect>`.
               # @param [String] hold_method Specify GET or POST, defaults to GET
-              # @param [String] announce_url The announce_url
-              # @param [String] announce_method The announce_method
+              # @param [String] announce_url The 'AnnounceUrl' attribute lets you specify a URL
+              #   for announcing something to the participant. The URL may return an MP3, a WAV or
+              #   a TwiML document with `<Play>` or `<Say>`.
+              # @param [String] announce_method Specify GET or POST, defaults to POST
               # @return [ParticipantInstance] Updated ParticipantInstance
               def update(muted: :unset, hold: :unset, hold_url: :unset, hold_method: :unset, announce_url: :unset, announce_method: :unset)
                 context.update(

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

@@ -84,6 +84,15 @@ module Twilio
         )
       end
 
+      ##
+      # Validate the new SSL certificate for the Twilio API
+      def validate_ssl_certificate
+        response = request('api.twilio.com', '8443', 'GET', 'https://api.twilio.com:8443/.json')
+        if response.status_code < 200 || response.status_code >= 300
+          raise RestError.new 'Unexpected response from certificate endpoint', response
+        end
+      end
+
       ##
       # Access the Accounts Twilio Domain
       def accounts
@@ -227,7 +236,7 @@ module Twilio
       end
 
       ##
-      # @param [String] sid A 34 character string that uniquely identifies this
+      # @param [String] sid A 34-character string that uniquely identifies the Call
       #   resource.
       # @return [Twilio::REST::Api::V2010::AccountContext::CallInstance] if sid was passed.
       # @return [Twilio::REST::Api::V2010::AccountContext::CallList]

data/lib/twilio-ruby/rest/notify/v1/service/notification.rb

@@ -66,7 +66,7 @@ module Twilio
             #   APNS.  This parameter is not supported by SMS and Facebook Messenger and is
             #   omitted from deliveries via those channels.
             # @param [Hash] data This parameter specifies the custom key-value pairs of the
-            #   notification’s payload. Translates to `data` dictionary in FCM and GCM payload.
+            #   notification's payload. Translates to `data` dictionary in FCM and GCM payload.
             #   FCM and GCM [reserves certain
             #   keys](https://firebase.google.com/docs/cloud-messaging/http-server-ref) that
             #   cannot be used for those channels. For APNS, attributes of `Data` will be
@@ -307,7 +307,7 @@ module Twilio
             end
 
             ##
-            # @return [Hash] This parameter specifies the custom key-value pairs of the notification’s payload.
+            # @return [Hash] This parameter specifies the custom key-value pairs of the notification's payload.
             def data
               @properties['data']
             end

data/lib/twilio-ruby/rest/proxy/v1/service.rb

@@ -112,19 +112,22 @@ module Twilio
           # Request is executed immediately.
           # @param [String] unique_name The human-readable string that uniquely identifies
           #   this Service, up to 64 characters.
-          # @param [String] default_ttl The default time delay, in seconds, after which a
-          #   session will be expired.  Will be used for sessions where ttl is not specified.
+          # @param [String] default_ttl The default time delay in seconds after the latest
+          #   of Session create time or the Session's last Interaction time, after which a
+          #   session will expire.  Used for sessions where ttl is not specified.
           # @param [String] callback_url The URL to which Twilio will make callbacks on
           #   interaction status changes.
-          # @param [service.GeoMatchLevel] geo_match_level Options: country, area-code,
-          #   extended-area-code. Default: country.  Levels lower than country are only
-          #   available in North America.
-          # @param [service.NumberSelectionBehavior] number_selection_behavior Default:
-          #   prefer-sticky Options: prefer-sticky, avoid-sticky
+          # @param [service.GeoMatchLevel] geo_match_level Whether proxy number selected
+          #   must be in the same area code as the participant identifier. Options: `country`,
+          #   `area-code`, `extended-area-code`. Default: `country`. Levels lower than country
+          #   are only available in North America.
+          # @param [service.NumberSelectionBehavior] number_selection_behavior Options:
+          #   `prefer-sticky`, `avoid-sticky`. Default: `prefer-sticky`.
           # @param [String] intercept_callback_url A URL for Twilio call before each
-          #   Interaction. An error status code will prevent the interaction from continuing.
+          #   Interaction. Returning a 403 status code will prevent the interaction from
+          #   continuing.
           # @param [String] out_of_session_callback_url A URL for Twilio call when a new
-          #   Interaction has no Session.
+          #   Interaction has no [Session](https://www.twilio.com/docs/proxy/api/session).
           # @return [ServiceInstance] Newly created ServiceInstance
           def create(unique_name: nil, default_ttl: :unset, callback_url: :unset, geo_match_level: :unset, number_selection_behavior: :unset, intercept_callback_url: :unset, out_of_session_callback_url: :unset)
             data = Twilio::Values.of({
@@ -231,19 +234,22 @@ module Twilio
           # Update the ServiceInstance
           # @param [String] unique_name A human readable description of this resource, up to
           #   64 characters.
-          # @param [String] default_ttl The default time delay, in seconds, after which a
-          #   session will be expired.  Will be used for sessions where ttl is not specified.
+          # @param [String] default_ttl The default time delay in seconds after the latest
+          #   of Session create time or the Session's last Interaction time, after which a
+          #   session will expire.  Used for sessions where ttl is not specified.
           # @param [String] callback_url The URL to which Twilio will make callbacks on
           #   interaction status changes.
-          # @param [service.GeoMatchLevel] geo_match_level Default: country Options:
-          #   country, area-code, extended-area-code
-          # @param [service.NumberSelectionBehavior] number_selection_behavior Default:
-          #   prefer-sticky Options: prefer-sticky, avoid-sticky
-          # @param [String] intercept_callback_url Fires on each interaction. If responded
-          #   to with a 403 to this webhook, we will abort/block the interaction. For any
-          #   other status or timeout, the interaction continues.
+          # @param [service.GeoMatchLevel] geo_match_level Whether proxy number selected
+          #   must be in the same area code as the participant identifier. Options: `country`,
+          #   `area-code`, `extended-area-code`. Default: `country`. Levels lower than country
+          #   are only available in North America.
+          # @param [service.NumberSelectionBehavior] number_selection_behavior Options:
+          #   `prefer-sticky`, `avoid-sticky`. Default: `prefer-sticky`.
+          # @param [String] intercept_callback_url A URL for Twilio call before each
+          #   Interaction. Returning a 403 status code will prevent the interaction from
+          #   continuing.
           # @param [String] out_of_session_callback_url A URL for Twilio call when a new
-          #   Interaction has no Session.
+          #   Interaction has no [Session](https://www.twilio.com/docs/proxy/api/session).
           # @return [ServiceInstance] Updated ServiceInstance
           def update(unique_name: :unset, default_ttl: :unset, callback_url: :unset, geo_match_level: :unset, number_selection_behavior: :unset, intercept_callback_url: :unset, out_of_session_callback_url: :unset)
             data = Twilio::Values.of({
@@ -409,7 +415,7 @@ module Twilio
           end
 
           ##
-          # @return [service.GeoMatchLevel] Whether to limit proxy numbers in the same areacode.
+          # @return [service.GeoMatchLevel] Whether proxy number selected must be in the same area code as the participant identifier.
           def geo_match_level
             @properties['geo_match_level']
           end
@@ -433,7 +439,7 @@ module Twilio
           end
 
           ##
-          # @return [Time] The date this Service was updated
+          # @return [Time] The date this Service was last updated
           def date_updated
             @properties['date_updated']
           end
@@ -468,19 +474,22 @@ module Twilio
           # Update the ServiceInstance
           # @param [String] unique_name A human readable description of this resource, up to
           #   64 characters.
-          # @param [String] default_ttl The default time delay, in seconds, after which a
-          #   session will be expired.  Will be used for sessions where ttl is not specified.
+          # @param [String] default_ttl The default time delay in seconds after the latest
+          #   of Session create time or the Session's last Interaction time, after which a
+          #   session will expire.  Used for sessions where ttl is not specified.
           # @param [String] callback_url The URL to which Twilio will make callbacks on
           #   interaction status changes.
-          # @param [service.GeoMatchLevel] geo_match_level Default: country Options:
-          #   country, area-code, extended-area-code
-          # @param [service.NumberSelectionBehavior] number_selection_behavior Default:
-          #   prefer-sticky Options: prefer-sticky, avoid-sticky
-          # @param [String] intercept_callback_url Fires on each interaction. If responded
-          #   to with a 403 to this webhook, we will abort/block the interaction. For any
-          #   other status or timeout, the interaction continues.
+          # @param [service.GeoMatchLevel] geo_match_level Whether proxy number selected
+          #   must be in the same area code as the participant identifier. Options: `country`,
+          #   `area-code`, `extended-area-code`. Default: `country`. Levels lower than country
+          #   are only available in North America.
+          # @param [service.NumberSelectionBehavior] number_selection_behavior Options:
+          #   `prefer-sticky`, `avoid-sticky`. Default: `prefer-sticky`.
+          # @param [String] intercept_callback_url A URL for Twilio call before each
+          #   Interaction. Returning a 403 status code will prevent the interaction from
+          #   continuing.
           # @param [String] out_of_session_callback_url A URL for Twilio call when a new
-          #   Interaction has no Session.
+          #   Interaction has no [Session](https://www.twilio.com/docs/proxy/api/session).
           # @return [ServiceInstance] Updated ServiceInstance
           def update(unique_name: :unset, default_ttl: :unset, callback_url: :unset, geo_match_level: :unset, number_selection_behavior: :unset, intercept_callback_url: :unset, out_of_session_callback_url: :unset)
             context.update(

data/lib/twilio-ruby/rest/proxy/v1/service/phone_number.rb

@@ -17,7 +17,8 @@ module Twilio
             ##
             # Initialize the PhoneNumberList
             # @param [Version] version Version that contains the resource
-            # @param [String] service_sid The unique SID identifier of the Service.
+            # @param [String] service_sid The unique SID identifier of the parent
+            #   [Service](https://www.twilio.com/docs/proxy/api/service).
             # @return [PhoneNumberList] PhoneNumberList
             def initialize(version, service_sid: nil)
               super(version)
@@ -172,7 +173,8 @@ module Twilio
             ##
             # Initialize the PhoneNumberContext
             # @param [Version] version Version that contains the resource
-            # @param [String] service_sid The unique SID identifier of the Service.
+            # @param [String] service_sid The unique SID identifier of the parent
+            #   [Service](https://www.twilio.com/docs/proxy/api/service).
             # @param [String] sid A 34 character string that uniquely identifies this Phone
             #   Number.
             # @return [PhoneNumberContext] PhoneNumberContext
@@ -226,7 +228,8 @@ module Twilio
             # Initialize the PhoneNumberInstance
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
-            # @param [String] service_sid The unique SID identifier of the Service.
+            # @param [String] service_sid The unique SID identifier of the parent
+            #   [Service](https://www.twilio.com/docs/proxy/api/service).
             # @param [String] sid A 34 character string that uniquely identifies this Phone
             #   Number.
             # @return [PhoneNumberInstance] PhoneNumberInstance

data/lib/twilio-ruby/rest/proxy/v1/service/session.rb

@@ -123,19 +123,18 @@ module Twilio
             ##
             # Retrieve a single page of SessionInstance records from the API.
             # Request is executed immediately.
-            # @param [String] unique_name Your identifier for this Session such as a Job ID or
-            #   conversation ID.
-            # @param [Time] date_expiry An absolute time at which this Session should close.
-            #   If this is populated, it takes precedence over TTL values.
-            # @param [String] ttl The Time To Live for this Session. The amount of time,
-            #   specified in seconds, that this Session should live for before closing. Keys off
-            #   the last interaction or session creation time.
+            # @param [String] unique_name Your unique identifier for this Session such as a
+            #   Job ID or conversation ID. Should not contain PII.
+            # @param [Time] date_expiry An absolute time (ISO 8601) at which this Session
+            #   should close. If this is populated, it takes precedence over TTL values.
+            # @param [String] ttl The time, in seconds, after the latest of Session create
+            #   time or the Session's last Interaction time at which the session will expire.
             # @param [session.Mode] mode The type of communications mediums allowed on a
-            #   Session. Defaults to voice-and-message, other options are voice-only OR
-            #   message-only.
-            # @param [session.Status] status Set this value to 'closed' to close the session.
+            #   Session. Defaults to `voice-and-message`. Other options are `voice-only` or
+            #   `message-only`.
+            # @param [session.Status] status Set this value to `closed` to close the session.
             #   A Session can be re-opened by posting to a closed session with the value
-            #   'in-progress.'  This will be 'open' by default on create.
+            #   `in-progress`.  This will be `open` by default on create.
             # @param [Hash] participants The participants
             # @return [SessionInstance] Newly created SessionInstance
             def create(unique_name: :unset, date_expiry: :unset, ttl: :unset, mode: :unset, status: :unset, participants: :unset)
@@ -201,7 +200,8 @@ module Twilio
             ##
             # Initialize the SessionContext
             # @param [Version] version Version that contains the resource
-            # @param [String] service_sid The unique SID identifier of the Service.
+            # @param [String] service_sid The unique SID identifier of the parent
+            #   [Service](https://www.twilio.com/docs/proxy/api/service).
             # @param [String] sid A 34 character string that uniquely identifies this Session.
             # @return [SessionContext] SessionContext
             def initialize(version, service_sid, sid)
@@ -241,13 +241,13 @@ module Twilio
             ##
             # Update the SessionInstance
             # @param [String] unique_name The unique_name
-            # @param [Time] date_expiry The date that this Session should be expired, given in
-            #   ISO 8601 format.
-            # @param [String] ttl The time delay, in seconds, after which a session will be
-            #   expired.  Keyed off of last interaction time.
+            # @param [Time] date_expiry The date that this Session should expire, given in ISO
+            #   8601 format.
+            # @param [String] ttl The time, in seconds, after the latest of Session create
+            #   time or the Session's last Interaction time at which the session will expire.
             # @param [session.Mode] mode The mode
-            # @param [session.Status] status The Status of this Session. Set `in-progress` to
-            #   re-open a session, `closed` to close a session.
+            # @param [session.Status] status The Status of this Session. Set to `in-progress`
+            #   to re-open a session or `closed` to close a session.
             # @param [Hash] participants The participants
             # @return [SessionInstance] Updated SessionInstance
             def update(unique_name: :unset, date_expiry: :unset, ttl: :unset, mode: :unset, status: :unset, participants: :unset)
@@ -401,19 +401,19 @@ module Twilio
             end
 
             ##
-            # @return [Time] The date this Session was interaction
+            # @return [Time] The date this Session last had an interaction
             def date_last_interaction
               @properties['date_last_interaction']
             end
 
             ##
-            # @return [Time] The date this Session was expiry
+            # @return [Time] The date this Session should expire
             def date_expiry
               @properties['date_expiry']
             end
 
             ##
-            # @return [String] A unique, developer assigned name of this Session.
+            # @return [String] A unique, developer assigned identifier for this Session.
             def unique_name
               @properties['unique_name']
             end
@@ -449,7 +449,7 @@ module Twilio
             end
 
             ##
-            # @return [Time] The date this Session was updated
+            # @return [Time] The date this Session was last updated
             def date_updated
               @properties['date_updated']
             end
@@ -483,13 +483,13 @@ module Twilio
             ##
             # Update the SessionInstance
             # @param [String] unique_name The unique_name
-            # @param [Time] date_expiry The date that this Session should be expired, given in
-            #   ISO 8601 format.
-            # @param [String] ttl The time delay, in seconds, after which a session will be
-            #   expired.  Keyed off of last interaction time.
+            # @param [Time] date_expiry The date that this Session should expire, given in ISO
+            #   8601 format.
+            # @param [String] ttl The time, in seconds, after the latest of Session create
+            #   time or the Session's last Interaction time at which the session will expire.
             # @param [session.Mode] mode The mode
-            # @param [session.Status] status The Status of this Session. Set `in-progress` to
-            #   re-open a session, `closed` to close a session.
+            # @param [session.Status] status The Status of this Session. Set to `in-progress`
+            #   to re-open a session or `closed` to close a session.
             # @param [Hash] participants The participants
             # @return [SessionInstance] Updated SessionInstance
             def update(unique_name: :unset, date_expiry: :unset, ttl: :unset, mode: :unset, status: :unset, participants: :unset)

data/lib/twilio-ruby/rest/proxy/v1/service/session/interaction.rb

@@ -18,8 +18,10 @@ module Twilio
               ##
               # Initialize the InteractionList
               # @param [Version] version Version that contains the resource
-              # @param [String] service_sid The unique SID identifier of the Service.
-              # @param [String] session_sid The unique SID identifier of the Session.
+              # @param [String] service_sid The unique SID identifier of the parent
+              #   [Service](https://www.twilio.com/docs/proxy/api/service).
+              # @param [String] session_sid The unique SID identifier of the parent
+              #   [Session](https://www.twilio.com/docs/proxy/api/session).
               # @return [InteractionList] InteractionList
               def initialize(version, service_sid: nil, session_sid: nil)
                 super(version)
@@ -183,8 +185,10 @@ module Twilio
               ##
               # Initialize the InteractionContext
               # @param [Version] version Version that contains the resource
-              # @param [String] service_sid The unique SID identifier of the Service.
-              # @param [String] session_sid The unique SID identifier of the Session.
+              # @param [String] service_sid The unique SID identifier of the parent
+              #   [Service](https://www.twilio.com/docs/proxy/api/service).
+              # @param [String] session_sid The unique SID identifier of the parent
+              #   [Session](https://www.twilio.com/docs/proxy/api/session).
               # @param [String] sid A 34 character string that uniquely identifies this
               #   Interaction.
               # @return [InteractionContext] InteractionContext
@@ -239,8 +243,10 @@ module Twilio
               # Initialize the InteractionInstance
               # @param [Version] version Version that contains the resource
               # @param [Hash] payload payload that contains response from Twilio
-              # @param [String] service_sid The unique SID identifier of the Service.
-              # @param [String] session_sid The unique SID identifier of the Session.
+              # @param [String] service_sid The unique SID identifier of the parent
+              #   [Service](https://www.twilio.com/docs/proxy/api/service).
+              # @param [String] session_sid The unique SID identifier of the parent
+              #   [Session](https://www.twilio.com/docs/proxy/api/session).
               # @param [String] sid A 34 character string that uniquely identifies this
               #   Interaction.
               # @return [InteractionInstance] InteractionInstance
@@ -398,7 +404,7 @@ module Twilio
               end
 
               ##
-              # @return [Time] The date this Interaction was updated
+              # @return [Time] The date this Interaction was last updated
               def date_updated
                 @properties['date_updated']
               end

data/lib/twilio-ruby/rest/proxy/v1/service/session/participant.rb

@@ -18,8 +18,10 @@ module Twilio
               ##
               # Initialize the ParticipantList
               # @param [Version] version Version that contains the resource
-              # @param [String] service_sid The unique SID identifier of the Service.
-              # @param [String] session_sid The unique SID identifier of the Session.
+              # @param [String] service_sid The unique SID identifier of the parent
+              #   [Service](https://www.twilio.com/docs/proxy/api/service).
+              # @param [String] session_sid The unique SID identifier of the parent
+              #   [Session](https://www.twilio.com/docs/proxy/api/session).
               # @return [ParticipantList] ParticipantList
               def initialize(version, service_sid: nil, session_sid: nil)
                 super(version)
@@ -196,8 +198,10 @@ module Twilio
               ##
               # Initialize the ParticipantContext
               # @param [Version] version Version that contains the resource
-              # @param [String] service_sid The unique SID identifier of the Service.
-              # @param [String] session_sid The unique SID identifier of the Session.
+              # @param [String] service_sid The unique SID identifier of the parent
+              #   [Service](https://www.twilio.com/docs/proxy/api/service).
+              # @param [String] session_sid The unique SID identifier of the parent
+              #   [Session](https://www.twilio.com/docs/proxy/api/session).
               # @param [String] sid A 34 character string that uniquely identifies this
               #   Participant.
               # @return [ParticipantContext] ParticipantContext
@@ -314,8 +318,10 @@ module Twilio
               # Initialize the ParticipantInstance
               # @param [Version] version Version that contains the resource
               # @param [Hash] payload payload that contains response from Twilio
-              # @param [String] service_sid The unique SID identifier of the Service.
-              # @param [String] session_sid The unique SID identifier of the Session.
+              # @param [String] service_sid The unique SID identifier of the parent
+              #   [Service](https://www.twilio.com/docs/proxy/api/service).
+              # @param [String] session_sid The unique SID identifier of the parent
+              #   [Session](https://www.twilio.com/docs/proxy/api/session).
               # @param [String] sid A 34 character string that uniquely identifies this
               #   Participant.
               # @return [ParticipantInstance] ParticipantInstance
@@ -425,7 +431,7 @@ module Twilio
               end
 
               ##
-              # @return [Time] The date this Participant was updated
+              # @return [Time] The date this Participant was last updated
               def date_updated
                 @properties['date_updated']
               end