twilio-ruby 5.34.1 → 5.39.0

data/lib/twilio-ruby/rest/conversations/v1/conversation/participant.rb

@@ -29,8 +29,7 @@ module Twilio
             end
 
             ##
-            # Retrieve a single page of ParticipantInstance records from the API.
-            # Request is executed immediately.
+            # Create the ParticipantInstance
             # @param [String] identity A unique string identifier for the conversation
             #   participant as [Chat User](https://www.twilio.com/docs/chat/rest/user-resource).
             #   This parameter is non-null if (and only if) the participant is using the
@@ -53,8 +52,13 @@ module Twilio
             # @param [String] messaging_binding_projected_address The address of the Twilio
             #   phone number that is used in Group MMS. Communication mask for the Chat
             #   participant with Identity.
-            # @return [ParticipantInstance] Newly created ParticipantInstance
-            def create(identity: :unset, messaging_binding_address: :unset, messaging_binding_proxy_address: :unset, date_created: :unset, date_updated: :unset, attributes: :unset, messaging_binding_projected_address: :unset)
+            # @param [String] role_sid The SID of the
+            #   [Role](https://www.twilio.com/docs/chat/rest/role-resource) to assign to the
+            #   participant.
+            # @param [participant.WebhookEnabledType] x_twilio_webhook_enabled The
+            #   X-Twilio-Webhook-Enabled HTTP request header
+            # @return [ParticipantInstance] Created ParticipantInstance
+            def create(identity: :unset, messaging_binding_address: :unset, messaging_binding_proxy_address: :unset, date_created: :unset, date_updated: :unset, attributes: :unset, messaging_binding_projected_address: :unset, role_sid: :unset, x_twilio_webhook_enabled: :unset)
               data = Twilio::Values.of({
                   'Identity' => identity,
                   'MessagingBinding.Address' => messaging_binding_address,
@@ -63,13 +67,11 @@ module Twilio
                   'DateUpdated' => Twilio.serialize_iso8601_datetime(date_updated),
                   'Attributes' => attributes,
                   'MessagingBinding.ProjectedAddress' => messaging_binding_projected_address,
+                  'RoleSid' => role_sid,
               })
+              headers = Twilio::Values.of({'X-Twilio-Webhook-Enabled' => x_twilio_webhook_enabled, })
 
-              payload = @version.create(
-                  'POST',
-                  @uri,
-                  data: data
-              )
+              payload = @version.create('POST', @uri, data: data, headers: headers)
 
               ParticipantInstance.new(@version, payload, conversation_sid: @solution[:conversation_sid], )
             end
@@ -135,11 +137,9 @@ module Twilio
                   'Page' => page_number,
                   'PageSize' => page_size,
               })
-              response = @version.page(
-                  'GET',
-                  @uri,
-                  params
-              )
+
+              response = @version.page('GET', @uri, params)
+
               ParticipantPage.new(@version, response, @solution)
             end
 
@@ -221,19 +221,28 @@ module Twilio
             #   store any data you wish. The string value must contain structurally valid JSON
             #   if specified.  **Note** that if the attributes are not set "{}" will be
             #   returned.
+            # @param [String] role_sid The SID of the
+            #   [Role](https://www.twilio.com/docs/chat/rest/role-resource) to assign to the
+            #   participant.
+            # @param [String] messaging_binding_proxy_address The address of the Twilio phone
+            #   number that the participant is in contact with. 'null' value will remove it.
+            # @param [String] messaging_binding_projected_address The address of the Twilio
+            #   phone number that is used in Group MMS. 'null' value will remove it.
+            # @param [participant.WebhookEnabledType] x_twilio_webhook_enabled The
+            #   X-Twilio-Webhook-Enabled HTTP request header
             # @return [ParticipantInstance] Updated ParticipantInstance
-            def update(date_created: :unset, date_updated: :unset, attributes: :unset)
+            def update(date_created: :unset, date_updated: :unset, attributes: :unset, role_sid: :unset, messaging_binding_proxy_address: :unset, messaging_binding_projected_address: :unset, x_twilio_webhook_enabled: :unset)
               data = Twilio::Values.of({
                   'DateCreated' => Twilio.serialize_iso8601_datetime(date_created),
                   'DateUpdated' => Twilio.serialize_iso8601_datetime(date_updated),
                   'Attributes' => attributes,
+                  'RoleSid' => role_sid,
+                  'MessagingBinding.ProxyAddress' => messaging_binding_proxy_address,
+                  'MessagingBinding.ProjectedAddress' => messaging_binding_projected_address,
               })
+              headers = Twilio::Values.of({'X-Twilio-Webhook-Enabled' => x_twilio_webhook_enabled, })
 
-              payload = @version.update(
-                  'POST',
-                  @uri,
-                  data: data,
-              )
+              payload = @version.update('POST', @uri, data: data, headers: headers)
 
               ParticipantInstance.new(
                   @version,
@@ -244,23 +253,21 @@ module Twilio
             end
 
             ##
-            # Deletes the ParticipantInstance
+            # Delete the ParticipantInstance
+            # @param [participant.WebhookEnabledType] x_twilio_webhook_enabled The
+            #   X-Twilio-Webhook-Enabled HTTP request header
             # @return [Boolean] true if delete succeeds, false otherwise
-            def delete
-              @version.delete('delete', @uri)
+            def delete(x_twilio_webhook_enabled: :unset)
+              headers = Twilio::Values.of({'X-Twilio-Webhook-Enabled' => x_twilio_webhook_enabled, })
+
+               @version.delete('DELETE', @uri, headers: headers)
             end
 
             ##
-            # Fetch a ParticipantInstance
+            # Fetch the ParticipantInstance
             # @return [ParticipantInstance] Fetched ParticipantInstance
             def fetch
-              params = Twilio::Values.of({})
-
-              payload = @version.fetch(
-                  'GET',
-                  @uri,
-                  params,
-              )
+              payload = @version.fetch('GET', @uri)
 
               ParticipantInstance.new(
                   @version,
@@ -308,6 +315,7 @@ module Twilio
                   'identity' => payload['identity'],
                   'attributes' => payload['attributes'],
                   'messaging_binding' => payload['messaging_binding'],
+                  'role_sid' => payload['role_sid'],
                   'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
                   'date_updated' => Twilio.deserialize_iso8601_datetime(payload['date_updated']),
                   'url' => payload['url'],
@@ -365,6 +373,12 @@ module Twilio
               @properties['messaging_binding']
             end
 
+            ##
+            # @return [String] The SID of the Role to assign to the participant
+            def role_sid
+              @properties['role_sid']
+            end
+
             ##
             # @return [Time] The date that this resource was created.
             def date_created
@@ -391,20 +405,39 @@ module Twilio
             #   store any data you wish. The string value must contain structurally valid JSON
             #   if specified.  **Note** that if the attributes are not set "{}" will be
             #   returned.
+            # @param [String] role_sid The SID of the
+            #   [Role](https://www.twilio.com/docs/chat/rest/role-resource) to assign to the
+            #   participant.
+            # @param [String] messaging_binding_proxy_address The address of the Twilio phone
+            #   number that the participant is in contact with. 'null' value will remove it.
+            # @param [String] messaging_binding_projected_address The address of the Twilio
+            #   phone number that is used in Group MMS. 'null' value will remove it.
+            # @param [participant.WebhookEnabledType] x_twilio_webhook_enabled The
+            #   X-Twilio-Webhook-Enabled HTTP request header
             # @return [ParticipantInstance] Updated ParticipantInstance
-            def update(date_created: :unset, date_updated: :unset, attributes: :unset)
-              context.update(date_created: date_created, date_updated: date_updated, attributes: attributes, )
+            def update(date_created: :unset, date_updated: :unset, attributes: :unset, role_sid: :unset, messaging_binding_proxy_address: :unset, messaging_binding_projected_address: :unset, x_twilio_webhook_enabled: :unset)
+              context.update(
+                  date_created: date_created,
+                  date_updated: date_updated,
+                  attributes: attributes,
+                  role_sid: role_sid,
+                  messaging_binding_proxy_address: messaging_binding_proxy_address,
+                  messaging_binding_projected_address: messaging_binding_projected_address,
+                  x_twilio_webhook_enabled: x_twilio_webhook_enabled,
+              )
             end
 
             ##
-            # Deletes the ParticipantInstance
+            # Delete the ParticipantInstance
+            # @param [participant.WebhookEnabledType] x_twilio_webhook_enabled The
+            #   X-Twilio-Webhook-Enabled HTTP request header
             # @return [Boolean] true if delete succeeds, false otherwise
-            def delete
-              context.delete
+            def delete(x_twilio_webhook_enabled: :unset)
+              context.delete(x_twilio_webhook_enabled: x_twilio_webhook_enabled, )
             end
 
             ##
-            # Fetch a ParticipantInstance
+            # Fetch the ParticipantInstance
             # @return [ParticipantInstance] Fetched ParticipantInstance
             def fetch
               context.fetch

data/lib/twilio-ruby/rest/conversations/v1/conversation/webhook.rb

@@ -89,11 +89,9 @@ module Twilio
                   'Page' => page_number,
                   'PageSize' => page_size,
               })
-              response = @version.page(
-                  'GET',
-                  @uri,
-                  params
-              )
+
+              response = @version.page('GET', @uri, params)
+
               WebhookPage.new(@version, response, @solution)
             end
 
@@ -111,8 +109,7 @@ module Twilio
             end
 
             ##
-            # Retrieve a single page of WebhookInstance records from the API.
-            # Request is executed immediately.
+            # Create the WebhookInstance
             # @param [webhook.Target] target The target of this webhook: `webhook`, `studio`,
             #   `trigger`
             # @param [String] configuration_url The absolute url the webhook request should be
@@ -127,7 +124,7 @@ module Twilio
             #   should be sent to.
             # @param [String] configuration_replay_after The message index for which and it's
             #   successors the webhook will be replayed. Not set by default
-            # @return [WebhookInstance] Newly created WebhookInstance
+            # @return [WebhookInstance] Created WebhookInstance
             def create(target: nil, configuration_url: :unset, configuration_method: :unset, configuration_filters: :unset, configuration_triggers: :unset, configuration_flow_sid: :unset, configuration_replay_after: :unset)
               data = Twilio::Values.of({
                   'Target' => target,
@@ -139,11 +136,7 @@ module Twilio
                   'Configuration.ReplayAfter' => configuration_replay_after,
               })
 
-              payload = @version.create(
-                  'POST',
-                  @uri,
-                  data: data
-              )
+              payload = @version.create('POST', @uri, data: data)
 
               WebhookInstance.new(@version, payload, conversation_sid: @solution[:conversation_sid], )
             end
@@ -206,16 +199,10 @@ module Twilio
             end
 
             ##
-            # Fetch a WebhookInstance
+            # Fetch the WebhookInstance
             # @return [WebhookInstance] Fetched WebhookInstance
             def fetch
-              params = Twilio::Values.of({})
-
-              payload = @version.fetch(
-                  'GET',
-                  @uri,
-                  params,
-              )
+              payload = @version.fetch('GET', @uri)
 
               WebhookInstance.new(
                   @version,
@@ -247,11 +234,7 @@ module Twilio
                   'Configuration.FlowSid' => configuration_flow_sid,
               })
 
-              payload = @version.update(
-                  'POST',
-                  @uri,
-                  data: data,
-              )
+              payload = @version.update('POST', @uri, data: data)
 
               WebhookInstance.new(
                   @version,
@@ -262,10 +245,10 @@ module Twilio
             end
 
             ##
-            # Deletes the WebhookInstance
+            # Delete the WebhookInstance
             # @return [Boolean] true if delete succeeds, false otherwise
             def delete
-              @version.delete('delete', @uri)
+               @version.delete('DELETE', @uri)
             end
 
             ##
@@ -375,7 +358,7 @@ module Twilio
             end
 
             ##
-            # Fetch a WebhookInstance
+            # Fetch the WebhookInstance
             # @return [WebhookInstance] Fetched WebhookInstance
             def fetch
               context.fetch
@@ -405,7 +388,7 @@ module Twilio
             end
 
             ##
-            # Deletes the WebhookInstance
+            # Delete the WebhookInstance
             # @return [Boolean] true if delete succeeds, false otherwise
             def delete
               context.delete

data/lib/twilio-ruby/rest/conversations/v1/webhook.rb

@@ -78,16 +78,10 @@ module Twilio
           end
 
           ##
-          # Fetch a WebhookInstance
+          # Fetch the WebhookInstance
           # @return [WebhookInstance] Fetched WebhookInstance
           def fetch
-            params = Twilio::Values.of({})
-
-            payload = @version.fetch(
-                'GET',
-                @uri,
-                params,
-            )
+            payload = @version.fetch('GET', @uri)
 
             WebhookInstance.new(@version, payload, )
           end
@@ -116,11 +110,7 @@ module Twilio
                 'Target' => target,
             })
 
-            payload = @version.update(
-                'POST',
-                @uri,
-                data: data,
-            )
+            payload = @version.update('POST', @uri, data: data)
 
             WebhookInstance.new(@version, payload, )
           end
@@ -221,7 +211,7 @@ module Twilio
           end
 
           ##
-          # Fetch a WebhookInstance
+          # Fetch the WebhookInstance
           # @return [WebhookInstance] Fetched WebhookInstance
           def fetch
             context.fetch

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

@@ -133,11 +133,9 @@ module Twilio
                 'Page' => page_number,
                 'PageSize' => page_size,
             })
-            response = @version.page(
-                'GET',
-                @uri,
-                params
-            )
+
+            response = @version.page('GET', @uri, params)
+
             FaxPage.new(@version, response, @solution)
           end
 
@@ -155,8 +153,7 @@ module Twilio
           end
 
           ##
-          # Retrieve a single page of FaxInstance records from the API.
-          # Request is executed immediately.
+          # Create the FaxInstance
           # @param [String] to The phone number to receive the fax in
           #   [E.164](https://www.twilio.com/docs/glossary/what-e164) format or the
           #   recipient's SIP URI.
@@ -186,7 +183,7 @@ module Twilio
           #   `true`.
           # @param [String] ttl How long in minutes from when the fax is initiated that we
           #   should try to send the fax.
-          # @return [FaxInstance] Newly created FaxInstance
+          # @return [FaxInstance] Created FaxInstance
           def create(to: nil, media_url: nil, quality: :unset, status_callback: :unset, from: :unset, sip_auth_username: :unset, sip_auth_password: :unset, store_media: :unset, ttl: :unset)
             data = Twilio::Values.of({
                 'To' => to,
@@ -200,11 +197,7 @@ module Twilio
                 'Ttl' => ttl,
             })
 
-            payload = @version.create(
-                'POST',
-                @uri,
-                data: data
-            )
+            payload = @version.create('POST', @uri, data: data)
 
             FaxInstance.new(@version, payload, )
           end
@@ -268,16 +261,10 @@ module Twilio
           end
 
           ##
-          # Fetch a FaxInstance
+          # Fetch the FaxInstance
           # @return [FaxInstance] Fetched FaxInstance
           def fetch
-            params = Twilio::Values.of({})
-
-            payload = @version.fetch(
-                'GET',
-                @uri,
-                params,
-            )
+            payload = @version.fetch('GET', @uri)
 
             FaxInstance.new(@version, payload, sid: @solution[:sid], )
           end
@@ -292,20 +279,16 @@ module Twilio
           def update(status: :unset)
             data = Twilio::Values.of({'Status' => status, })
 
-            payload = @version.update(
-                'POST',
-                @uri,
-                data: data,
-            )
+            payload = @version.update('POST', @uri, data: data)
 
             FaxInstance.new(@version, payload, sid: @solution[:sid], )
           end
 
           ##
-          # Deletes the FaxInstance
+          # Delete the FaxInstance
           # @return [Boolean] true if delete succeeds, false otherwise
           def delete
-            @version.delete('delete', @uri)
+             @version.delete('DELETE', @uri)
           end
 
           ##
@@ -501,7 +484,7 @@ module Twilio
           end
 
           ##
-          # Fetch a FaxInstance
+          # Fetch the FaxInstance
           # @return [FaxInstance] Fetched FaxInstance
           def fetch
             context.fetch
@@ -519,7 +502,7 @@ module Twilio
           end
 
           ##
-          # Deletes the FaxInstance
+          # Delete the FaxInstance
           # @return [Boolean] true if delete succeeds, false otherwise
           def delete
             context.delete

data/lib/twilio-ruby/rest/fax/v1/fax/fax_media.rb

@@ -89,11 +89,9 @@ module Twilio
                   'Page' => page_number,
                   'PageSize' => page_size,
               })
-              response = @version.page(
-                  'GET',
-                  @uri,
-                  params
-              )
+
+              response = @version.page('GET', @uri, params)
+
               FaxMediaPage.new(@version, response, @solution)
             end
 
@@ -167,25 +165,19 @@ module Twilio
             end
 
             ##
-            # Fetch a FaxMediaInstance
+            # Fetch the FaxMediaInstance
             # @return [FaxMediaInstance] Fetched FaxMediaInstance
             def fetch
-              params = Twilio::Values.of({})
-
-              payload = @version.fetch(
-                  'GET',
-                  @uri,
-                  params,
-              )
+              payload = @version.fetch('GET', @uri)
 
               FaxMediaInstance.new(@version, payload, fax_sid: @solution[:fax_sid], sid: @solution[:sid], )
             end
 
             ##
-            # Deletes the FaxMediaInstance
+            # Delete the FaxMediaInstance
             # @return [Boolean] true if delete succeeds, false otherwise
             def delete
-              @version.delete('delete', @uri)
+               @version.delete('DELETE', @uri)
             end
 
             ##
@@ -288,14 +280,14 @@ module Twilio
             end
 
             ##
-            # Fetch a FaxMediaInstance
+            # Fetch the FaxMediaInstance
             # @return [FaxMediaInstance] Fetched FaxMediaInstance
             def fetch
               context.fetch
             end
 
             ##
-            # Deletes the FaxMediaInstance
+            # Delete the FaxMediaInstance
             # @return [Boolean] true if delete succeeds, false otherwise
             def delete
               context.delete