lib/twilio-ruby/rest/proxy/v1/service/session.rb in twilio-ruby-5.40.1 vs lib/twilio-ruby/rest/proxy/v1/service/session.rb in twilio-ruby-5.40.2

- old
+ new

@@ -125,21 +125,22 @@ # @param [session.Status] status The initial status of the Session. Can be: # `open`, `in-progress`, `closed`, `failed`, or `unknown`. The default is `open` # on create. # @param [Hash] participants The Participant objects to include in the new # session. - # @param [Boolean] fail_on_participant_conflict [Experimental] Setting to true - # enables early opt-in to allowing Proxy to reject a Session create (with + # @param [Boolean] fail_on_participant_conflict [Experimental] For accounts with + # the ProxyAllowParticipantConflict account flag, setting to true enables + # per-request opt-in to allowing Proxy to reject a Session create (with # Participants) request that could cause the same Identifier/ProxyIdentifier pair # to be active in multiple Sessions. Depending on the context, this could be a 409 # error (Twilio error code 80623) or a 400 error (Twilio error code 80604). If not - # provided, or if set to false, requests will be allowed to succeed and a Debugger - # notification (80802) will be emitted. Having multiple, active Participants with - # the same Identifier/ProxyIdentifier pair causes calls and messages from affected - # Participants to be routed incorrectly. Please note, in a future release, the - # default behavior will be to reject the request as described unless an exception - # has been requested. + # provided, requests will be allowed to succeed and a Debugger notification + # (80802) will be emitted. Having multiple, active Participants with the same + # Identifier/ProxyIdentifier pair causes calls and messages from affected + # Participants to be routed incorrectly. Please note, the default behavior for + # accounts without the ProxyAllowParticipantConflict flag is to reject the request + # as described. This will eventually be the default for all accounts. # @return [SessionInstance] Created SessionInstance def create(unique_name: :unset, date_expiry: :unset, ttl: :unset, mode: :unset, status: :unset, participants: :unset, fail_on_participant_conflict: :unset) data = Twilio::Values.of({ 'UniqueName' => unique_name, 'DateExpiry' => Twilio.serialize_iso8601_datetime(date_expiry), @@ -240,20 +241,21 @@ # the `ttl` value. # @param [String] ttl The time, in seconds, when the session will expire. The time # is measured from the last Session create or the Session's last Interaction. # @param [session.Status] status The new status of the resource. Can be: # `in-progress` to re-open a session or `closed` to close a session. - # @param [Boolean] fail_on_participant_conflict [Experimental] Setting to true - # enables early opt-in to allowing Proxy to return a 400 error (Twilio error code + # @param [Boolean] fail_on_participant_conflict [Experimental] For accounts with + # the ProxyAllowParticipantConflict account flag, setting to true enables + # per-request opt-in to allowing Proxy to return a 400 error (Twilio error code # 80604) when a request to set a Session to in-progress would cause Participants # with the same Identifier/ProxyIdentifier pair to be active in multiple Sessions. - # If not provided, or if set to false, requests will be allowed to succeed, and a - # Debugger notification (80801) will be emitted. Having multiple, active - # Participants with the same Identifier/ProxyIdentifier pair causes calls and - # messages from affected Participants to be routed incorrectly. Please note, in a - # future release, the default behavior will be to reject the request with a 400 - # error unless an exception has been requested. + # If not provided, requests will be allowed to succeed, and a Debugger + # notification (80801) will be emitted. Having multiple, active Participants with + # the same Identifier/ProxyIdentifier pair causes calls and messages from affected + # Participants to be routed incorrectly. Please note, the default behavior for + # accounts without the ProxyAllowParticipantConflict flag is to reject the request + # as described. This will eventually be the default for all accounts. # @return [SessionInstance] Updated SessionInstance def update(date_expiry: :unset, ttl: :unset, status: :unset, fail_on_participant_conflict: :unset) data = Twilio::Values.of({ 'DateExpiry' => Twilio.serialize_iso8601_datetime(date_expiry), 'Ttl' => ttl, @@ -494,19 +496,20 @@ # the `ttl` value. # @param [String] ttl The time, in seconds, when the session will expire. The time # is measured from the last Session create or the Session's last Interaction. # @param [session.Status] status The new status of the resource. Can be: # `in-progress` to re-open a session or `closed` to close a session. - # @param [Boolean] fail_on_participant_conflict [Experimental] Setting to true - # enables early opt-in to allowing Proxy to return a 400 error (Twilio error code + # @param [Boolean] fail_on_participant_conflict [Experimental] For accounts with + # the ProxyAllowParticipantConflict account flag, setting to true enables + # per-request opt-in to allowing Proxy to return a 400 error (Twilio error code # 80604) when a request to set a Session to in-progress would cause Participants # with the same Identifier/ProxyIdentifier pair to be active in multiple Sessions. - # If not provided, or if set to false, requests will be allowed to succeed, and a - # Debugger notification (80801) will be emitted. Having multiple, active - # Participants with the same Identifier/ProxyIdentifier pair causes calls and - # messages from affected Participants to be routed incorrectly. Please note, in a - # future release, the default behavior will be to reject the request with a 400 - # error unless an exception has been requested. + # If not provided, requests will be allowed to succeed, and a Debugger + # notification (80801) will be emitted. Having multiple, active Participants with + # the same Identifier/ProxyIdentifier pair causes calls and messages from affected + # Participants to be routed incorrectly. Please note, the default behavior for + # accounts without the ProxyAllowParticipantConflict flag is to reject the request + # as described. This will eventually be the default for all accounts. # @return [SessionInstance] Updated SessionInstance def update(date_expiry: :unset, ttl: :unset, status: :unset, fail_on_participant_conflict: :unset) context.update( date_expiry: date_expiry, ttl: ttl, \ No newline at end of file