twilio-ruby 5.31.1 → 5.54.0

data/lib/twilio-ruby/rest/preview/bulk_exports/export_configuration.rb

@@ -68,7 +68,8 @@ module Twilio
           ##
           # Initialize the ExportConfigurationContext
           # @param [Version] version Version that contains the resource
-          # @param [String] resource_type The resource_type
+          # @param [String] resource_type The type of communication – Messages, Calls,
+          #   Conferences, and Participants
           # @return [ExportConfigurationContext] ExportConfigurationContext
           def initialize(version, resource_type)
             super(version)
@@ -79,25 +80,23 @@ module Twilio
           end
 
           ##
-          # Fetch a ExportConfigurationInstance
+          # Fetch the ExportConfigurationInstance
           # @return [ExportConfigurationInstance] Fetched ExportConfigurationInstance
           def fetch
-            params = Twilio::Values.of({})
-
-            payload = @version.fetch(
-                'GET',
-                @uri,
-                params,
-            )
+            payload = @version.fetch('GET', @uri)
 
             ExportConfigurationInstance.new(@version, payload, resource_type: @solution[:resource_type], )
           end
 
           ##
           # Update the ExportConfigurationInstance
-          # @param [Boolean] enabled The enabled
-          # @param [String] webhook_url The webhook_url
-          # @param [String] webhook_method The webhook_method
+          # @param [Boolean] enabled If true, Twilio will automatically generate every day's
+          #   file when the day is over.
+          # @param [String] webhook_url Stores the URL destination for the method specified
+          #   in webhook_method.
+          # @param [String] webhook_method Sets whether Twilio should call a webhook URL
+          #   when the automatic generation is complete, using GET or POST. The actual
+          #   destination is set in the webhook_url
           # @return [ExportConfigurationInstance] Updated ExportConfigurationInstance
           def update(enabled: :unset, webhook_url: :unset, webhook_method: :unset)
             data = Twilio::Values.of({
@@ -106,11 +105,7 @@ module Twilio
                 'WebhookMethod' => webhook_method,
             })
 
-            payload = @version.update(
-                'POST',
-                @uri,
-                data: data,
-            )
+            payload = @version.update('POST', @uri, data: data)
 
             ExportConfigurationInstance.new(@version, payload, resource_type: @solution[:resource_type], )
           end
@@ -137,7 +132,8 @@ module Twilio
           # 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 resource_type
+          # @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)
@@ -168,37 +164,37 @@ module Twilio
           end
 
           ##
-          # @return [Boolean] The enabled
+          # @return [Boolean] Whether files are automatically generated
           def enabled
             @properties['enabled']
           end
 
           ##
-          # @return [String] The webhook_url
+          # @return [String] URL targeted at export
           def webhook_url
             @properties['webhook_url']
           end
 
           ##
-          # @return [String] The webhook_method
+          # @return [String] Whether to GET or POST to the webhook url
           def webhook_method
             @properties['webhook_method']
           end
 
           ##
-          # @return [String] The resource_type
+          # @return [String] The type of communication – Messages, Calls, Conferences, and Participants
           def resource_type
             @properties['resource_type']
           end
 
           ##
-          # @return [String] The url
+          # @return [String] The URL of this resource.
           def url
             @properties['url']
           end
 
           ##
-          # Fetch a ExportConfigurationInstance
+          # Fetch the ExportConfigurationInstance
           # @return [ExportConfigurationInstance] Fetched ExportConfigurationInstance
           def fetch
             context.fetch
@@ -206,9 +202,13 @@ module Twilio
 
           ##
           # Update the ExportConfigurationInstance
-          # @param [Boolean] enabled The enabled
-          # @param [String] webhook_url The webhook_url
-          # @param [String] webhook_method The webhook_method
+          # @param [Boolean] enabled If true, Twilio will automatically generate every day's
+          #   file when the day is over.
+          # @param [String] webhook_url Stores the URL destination for the method specified
+          #   in webhook_method.
+          # @param [String] webhook_method Sets whether Twilio should call a webhook URL
+          #   when the automatic generation is complete, using GET or POST. The actual
+          #   destination is set in the webhook_url
           # @return [ExportConfigurationInstance] Updated ExportConfigurationInstance
           def update(enabled: :unset, webhook_url: :unset, webhook_method: :unset)
             context.update(enabled: enabled, webhook_url: webhook_url, webhook_method: webhook_method, )

data/lib/twilio-ruby/rest/preview/deployed_devices.rb

@@ -25,11 +25,12 @@ module Twilio
         # @return [Twilio::REST::Preview::DeployedDevices::FleetList]
         def fleets(sid=:unset)
           if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @fleets ||= FleetList.new self
+              raise ArgumentError, 'sid cannot be nil'
+          end
+          if sid == :unset
+              @fleets ||= FleetList.new self
           else
-            FleetContext.new(self, sid)
+              FleetContext.new(self, sid)
           end
         end
 

data/lib/twilio-ruby/rest/preview/deployed_devices/fleet.rb

@@ -26,19 +26,14 @@ module Twilio
           end
 
           ##
-          # Retrieve a single page of FleetInstance records from the API.
-          # Request is executed immediately.
+          # Create the FleetInstance
           # @param [String] friendly_name Provides a human readable descriptive text for
           #   this Fleet, up to 256 characters long.
-          # @return [FleetInstance] Newly created FleetInstance
+          # @return [FleetInstance] Created FleetInstance
           def create(friendly_name: :unset)
             data = Twilio::Values.of({'FriendlyName' => friendly_name, })
 
-            payload = @version.create(
-                'POST',
-                @uri,
-                data: data
-            )
+            payload = @version.create('POST', @uri, data: data)
 
             FleetInstance.new(@version, payload, )
           end
@@ -104,11 +99,9 @@ module Twilio
                 'Page' => page_number,
                 'PageSize' => page_size,
             })
-            response = @version.page(
-                'GET',
-                @uri,
-                params
-            )
+
+            response = @version.page('GET', @uri, params: params)
+
             FleetPage.new(@version, response, @solution)
           end
 
@@ -187,25 +180,19 @@ module Twilio
           end
 
           ##
-          # Fetch a FleetInstance
+          # Fetch the FleetInstance
           # @return [FleetInstance] Fetched FleetInstance
           def fetch
-            params = Twilio::Values.of({})
-
-            payload = @version.fetch(
-                'GET',
-                @uri,
-                params,
-            )
+            payload = @version.fetch('GET', @uri)
 
             FleetInstance.new(@version, payload, sid: @solution[:sid], )
           end
 
           ##
-          # Deletes the FleetInstance
+          # Delete the FleetInstance
           # @return [Boolean] true if delete succeeds, false otherwise
           def delete
-            @version.delete('delete', @uri)
+             @version.delete('DELETE', @uri)
           end
 
           ##
@@ -221,11 +208,7 @@ module Twilio
                 'DefaultDeploymentSid' => default_deployment_sid,
             })
 
-            payload = @version.update(
-                'POST',
-                @uri,
-                data: data,
-            )
+            payload = @version.update('POST', @uri, data: data)
 
             FleetInstance.new(@version, payload, sid: @solution[:sid], )
           end
@@ -414,14 +397,14 @@ module Twilio
           end
 
           ##
-          # Fetch a FleetInstance
+          # Fetch the FleetInstance
           # @return [FleetInstance] Fetched FleetInstance
           def fetch
             context.fetch
           end
 
           ##
-          # Deletes the FleetInstance
+          # Delete the FleetInstance
           # @return [Boolean] true if delete succeeds, false otherwise
           def delete
             context.delete

data/lib/twilio-ruby/rest/preview/deployed_devices/fleet/certificate.rb

@@ -29,15 +29,14 @@ module Twilio
             end
 
             ##
-            # Retrieve a single page of CertificateInstance records from the API.
-            # Request is executed immediately.
+            # Create the CertificateInstance
             # @param [String] certificate_data Provides a URL encoded representation of the
             #   public certificate in PEM format.
             # @param [String] friendly_name Provides a human readable descriptive text for
             #   this Certificate credential, up to 256 characters long.
             # @param [String] device_sid Provides the unique string identifier of an existing
             #   Device to become authenticated with this Certificate credential.
-            # @return [CertificateInstance] Newly created CertificateInstance
+            # @return [CertificateInstance] Created CertificateInstance
             def create(certificate_data: nil, friendly_name: :unset, device_sid: :unset)
               data = Twilio::Values.of({
                   'CertificateData' => certificate_data,
@@ -45,11 +44,7 @@ module Twilio
                   'DeviceSid' => device_sid,
               })
 
-              payload = @version.create(
-                  'POST',
-                  @uri,
-                  data: data
-              )
+              payload = @version.create('POST', @uri, data: data)
 
               CertificateInstance.new(@version, payload, fleet_sid: @solution[:fleet_sid], )
             end
@@ -122,11 +117,9 @@ module Twilio
                   'Page' => page_number,
                   'PageSize' => page_size,
               })
-              response = @version.page(
-                  'GET',
-                  @uri,
-                  params
-              )
+
+              response = @version.page('GET', @uri, params: params)
+
               CertificatePage.new(@version, response, @solution)
             end
 
@@ -200,25 +193,19 @@ module Twilio
             end
 
             ##
-            # Fetch a CertificateInstance
+            # Fetch the CertificateInstance
             # @return [CertificateInstance] Fetched CertificateInstance
             def fetch
-              params = Twilio::Values.of({})
-
-              payload = @version.fetch(
-                  'GET',
-                  @uri,
-                  params,
-              )
+              payload = @version.fetch('GET', @uri)
 
               CertificateInstance.new(@version, payload, fleet_sid: @solution[:fleet_sid], sid: @solution[:sid], )
             end
 
             ##
-            # Deletes the CertificateInstance
+            # Delete the CertificateInstance
             # @return [Boolean] true if delete succeeds, false otherwise
             def delete
-              @version.delete('delete', @uri)
+               @version.delete('DELETE', @uri)
             end
 
             ##
@@ -231,11 +218,7 @@ module Twilio
             def update(friendly_name: :unset, device_sid: :unset)
               data = Twilio::Values.of({'FriendlyName' => friendly_name, 'DeviceSid' => device_sid, })
 
-              payload = @version.update(
-                  'POST',
-                  @uri,
-                  data: data,
-              )
+              payload = @version.update('POST', @uri, data: data)
 
               CertificateInstance.new(@version, payload, fleet_sid: @solution[:fleet_sid], sid: @solution[:sid], )
             end
@@ -354,14 +337,14 @@ module Twilio
             end
 
             ##
-            # Fetch a CertificateInstance
+            # Fetch the CertificateInstance
             # @return [CertificateInstance] Fetched CertificateInstance
             def fetch
               context.fetch
             end
 
             ##
-            # Deletes the CertificateInstance
+            # Delete the CertificateInstance
             # @return [Boolean] true if delete succeeds, false otherwise
             def delete
               context.delete

data/lib/twilio-ruby/rest/preview/deployed_devices/fleet/deployment.rb

@@ -29,22 +29,17 @@ module Twilio
             end
 
             ##
-            # Retrieve a single page of DeploymentInstance records from the API.
-            # Request is executed immediately.
+            # Create the DeploymentInstance
             # @param [String] friendly_name Provides a human readable descriptive text for
             #   this Deployment, up to 256 characters long.
             # @param [String] sync_service_sid Provides the unique string identifier of the
             #   Twilio Sync service instance that will be linked to and accessible by this
             #   Deployment.
-            # @return [DeploymentInstance] Newly created DeploymentInstance
+            # @return [DeploymentInstance] Created DeploymentInstance
             def create(friendly_name: :unset, sync_service_sid: :unset)
               data = Twilio::Values.of({'FriendlyName' => friendly_name, 'SyncServiceSid' => sync_service_sid, })
 
-              payload = @version.create(
-                  'POST',
-                  @uri,
-                  data: data
-              )
+              payload = @version.create('POST', @uri, data: data)
 
               DeploymentInstance.new(@version, payload, fleet_sid: @solution[:fleet_sid], )
             end
@@ -110,11 +105,9 @@ module Twilio
                   'Page' => page_number,
                   'PageSize' => page_size,
               })
-              response = @version.page(
-                  'GET',
-                  @uri,
-                  params
-              )
+
+              response = @version.page('GET', @uri, params: params)
+
               DeploymentPage.new(@version, response, @solution)
             end
 
@@ -188,25 +181,19 @@ module Twilio
             end
 
             ##
-            # Fetch a DeploymentInstance
+            # Fetch the DeploymentInstance
             # @return [DeploymentInstance] Fetched DeploymentInstance
             def fetch
-              params = Twilio::Values.of({})
-
-              payload = @version.fetch(
-                  'GET',
-                  @uri,
-                  params,
-              )
+              payload = @version.fetch('GET', @uri)
 
               DeploymentInstance.new(@version, payload, fleet_sid: @solution[:fleet_sid], sid: @solution[:sid], )
             end
 
             ##
-            # Deletes the DeploymentInstance
+            # Delete the DeploymentInstance
             # @return [Boolean] true if delete succeeds, false otherwise
             def delete
-              @version.delete('delete', @uri)
+               @version.delete('DELETE', @uri)
             end
 
             ##
@@ -220,11 +207,7 @@ module Twilio
             def update(friendly_name: :unset, sync_service_sid: :unset)
               data = Twilio::Values.of({'FriendlyName' => friendly_name, 'SyncServiceSid' => sync_service_sid, })
 
-              payload = @version.update(
-                  'POST',
-                  @uri,
-                  data: data,
-              )
+              payload = @version.update('POST', @uri, data: data)
 
               DeploymentInstance.new(@version, payload, fleet_sid: @solution[:fleet_sid], sid: @solution[:sid], )
             end
@@ -336,14 +319,14 @@ module Twilio
             end
 
             ##
-            # Fetch a DeploymentInstance
+            # Fetch the DeploymentInstance
             # @return [DeploymentInstance] Fetched DeploymentInstance
             def fetch
               context.fetch
             end
 
             ##
-            # Deletes the DeploymentInstance
+            # Delete the DeploymentInstance
             # @return [Boolean] true if delete succeeds, false otherwise
             def delete
               context.delete

data/lib/twilio-ruby/rest/preview/deployed_devices/fleet/device.rb

@@ -29,8 +29,7 @@ module Twilio
             end
 
             ##
-            # Retrieve a single page of DeviceInstance records from the API.
-            # Request is executed immediately.
+            # Create the DeviceInstance
             # @param [String] unique_name Provides a unique and addressable name to be
             #   assigned to this Device, to be used in addition to SID, up to 128 characters
             #   long.
@@ -41,7 +40,7 @@ module Twilio
             # @param [String] deployment_sid Specifies the unique string identifier of the
             #   Deployment group that this Device is going to be associated with.
             # @param [Boolean] enabled The enabled
-            # @return [DeviceInstance] Newly created DeviceInstance
+            # @return [DeviceInstance] Created DeviceInstance
             def create(unique_name: :unset, friendly_name: :unset, identity: :unset, deployment_sid: :unset, enabled: :unset)
               data = Twilio::Values.of({
                   'UniqueName' => unique_name,
@@ -51,11 +50,7 @@ module Twilio
                   'Enabled' => enabled,
               })
 
-              payload = @version.create(
-                  'POST',
-                  @uri,
-                  data: data
-              )
+              payload = @version.create('POST', @uri, data: data)
 
               DeviceInstance.new(@version, payload, fleet_sid: @solution[:fleet_sid], )
             end
@@ -128,11 +123,9 @@ module Twilio
                   'Page' => page_number,
                   'PageSize' => page_size,
               })
-              response = @version.page(
-                  'GET',
-                  @uri,
-                  params
-              )
+
+              response = @version.page('GET', @uri, params: params)
+
               DevicePage.new(@version, response, @solution)
             end
 
@@ -206,25 +199,19 @@ module Twilio
             end
 
             ##
-            # Fetch a DeviceInstance
+            # Fetch the DeviceInstance
             # @return [DeviceInstance] Fetched DeviceInstance
             def fetch
-              params = Twilio::Values.of({})
-
-              payload = @version.fetch(
-                  'GET',
-                  @uri,
-                  params,
-              )
+              payload = @version.fetch('GET', @uri)
 
               DeviceInstance.new(@version, payload, fleet_sid: @solution[:fleet_sid], sid: @solution[:sid], )
             end
 
             ##
-            # Deletes the DeviceInstance
+            # Delete the DeviceInstance
             # @return [Boolean] true if delete succeeds, false otherwise
             def delete
-              @version.delete('delete', @uri)
+               @version.delete('DELETE', @uri)
             end
 
             ##
@@ -245,11 +232,7 @@ module Twilio
                   'Enabled' => enabled,
               })
 
-              payload = @version.update(
-                  'POST',
-                  @uri,
-                  data: data,
-              )
+              payload = @version.update('POST', @uri, data: data)
 
               DeviceInstance.new(@version, payload, fleet_sid: @solution[:fleet_sid], sid: @solution[:sid], )
             end
@@ -389,14 +372,14 @@ module Twilio
             end
 
             ##
-            # Fetch a DeviceInstance
+            # Fetch the DeviceInstance
             # @return [DeviceInstance] Fetched DeviceInstance
             def fetch
               context.fetch
             end
 
             ##
-            # Deletes the DeviceInstance
+            # Delete the DeviceInstance
             # @return [Boolean] true if delete succeeds, false otherwise
             def delete
               context.delete