twilio-ruby 5.34.1 → 5.39.0

data/lib/twilio-ruby/rest/video/v1/composition.rb

@@ -127,11 +127,9 @@ module Twilio
                 'Page' => page_number,
                 'PageSize' => page_size,
             })
-            response = @version.page(
-                'GET',
-                @uri,
-                params
-            )
+
+            response = @version.page('GET', @uri, params)
+
             CompositionPage.new(@version, response, @solution)
           end
 
@@ -149,8 +147,7 @@ module Twilio
           end
 
           ##
-          # Retrieve a single page of CompositionInstance records from the API.
-          # Request is executed immediately.
+          # Create the CompositionInstance
           # @param [String] room_sid The SID of the Group Room with the media tracks to be
           #   used as composition sources.
           # @param [Hash] video_layout An object that describes the video layout of the
@@ -206,7 +203,7 @@ module Twilio
           #   while as well as if all the Participants leave the room and join later, because
           #   those gaps will be removed. See [Specifying Video
           #   Layouts](https://www.twilio.com/docs/video/api/compositions-resource#specifying-video-layouts) for more info.
-          # @return [CompositionInstance] Newly created CompositionInstance
+          # @return [CompositionInstance] Created CompositionInstance
           def create(room_sid: nil, video_layout: :unset, audio_sources: :unset, audio_sources_excluded: :unset, resolution: :unset, format: :unset, status_callback: :unset, status_callback_method: :unset, trim: :unset)
             data = Twilio::Values.of({
                 'RoomSid' => room_sid,
@@ -220,11 +217,7 @@ module Twilio
                 'Trim' => trim,
             })
 
-            payload = @version.create(
-                'POST',
-                @uri,
-                data: data
-            )
+            payload = @version.create('POST', @uri, data: data)
 
             CompositionInstance.new(@version, payload, )
           end
@@ -284,25 +277,19 @@ module Twilio
           end
 
           ##
-          # Fetch a CompositionInstance
+          # Fetch the CompositionInstance
           # @return [CompositionInstance] Fetched CompositionInstance
           def fetch
-            params = Twilio::Values.of({})
-
-            payload = @version.fetch(
-                'GET',
-                @uri,
-                params,
-            )
+            payload = @version.fetch('GET', @uri)
 
             CompositionInstance.new(@version, payload, sid: @solution[:sid], )
           end
 
           ##
-          # Deletes the CompositionInstance
+          # Delete the CompositionInstance
           # @return [Boolean] true if delete succeeds, false otherwise
           def delete
-            @version.delete('delete', @uri)
+             @version.delete('DELETE', @uri)
           end
 
           ##
@@ -479,14 +466,14 @@ module Twilio
           end
 
           ##
-          # Fetch a CompositionInstance
+          # Fetch the CompositionInstance
           # @return [CompositionInstance] Fetched CompositionInstance
           def fetch
             context.fetch
           end
 
           ##
-          # Deletes the CompositionInstance
+          # Delete the CompositionInstance
           # @return [Boolean] true if delete succeeds, false otherwise
           def delete
             context.delete

data/lib/twilio-ruby/rest/video/v1/composition_hook.rb

@@ -136,11 +136,9 @@ module Twilio
                 'Page' => page_number,
                 'PageSize' => page_size,
             })
-            response = @version.page(
-                'GET',
-                @uri,
-                params
-            )
+
+            response = @version.page('GET', @uri, params)
+
             CompositionHookPage.new(@version, response, @solution)
           end
 
@@ -158,8 +156,7 @@ module Twilio
           end
 
           ##
-          # Retrieve a single page of CompositionHookInstance records from the API.
-          # Request is executed immediately.
+          # Create the CompositionHookInstance
           # @param [String] friendly_name A descriptive string that you create to describe
           #   the resource. It can be up to  100 characters long and it must be unique within
           #   the account.
@@ -221,7 +218,7 @@ module Twilio
           #   the room and join later, because those gaps will be removed. See [Specifying
           #   Video
           #   Layouts](https://www.twilio.com/docs/video/api/compositions-resource#specifying-video-layouts) for more info.
-          # @return [CompositionHookInstance] Newly created CompositionHookInstance
+          # @return [CompositionHookInstance] Created CompositionHookInstance
           def create(friendly_name: nil, enabled: :unset, video_layout: :unset, audio_sources: :unset, audio_sources_excluded: :unset, resolution: :unset, format: :unset, status_callback: :unset, status_callback_method: :unset, trim: :unset)
             data = Twilio::Values.of({
                 'FriendlyName' => friendly_name,
@@ -236,11 +233,7 @@ module Twilio
                 'Trim' => trim,
             })
 
-            payload = @version.create(
-                'POST',
-                @uri,
-                data: data
-            )
+            payload = @version.create('POST', @uri, data: data)
 
             CompositionHookInstance.new(@version, payload, )
           end
@@ -300,25 +293,19 @@ module Twilio
           end
 
           ##
-          # Fetch a CompositionHookInstance
+          # Fetch the CompositionHookInstance
           # @return [CompositionHookInstance] Fetched CompositionHookInstance
           def fetch
-            params = Twilio::Values.of({})
-
-            payload = @version.fetch(
-                'GET',
-                @uri,
-                params,
-            )
+            payload = @version.fetch('GET', @uri)
 
             CompositionHookInstance.new(@version, payload, sid: @solution[:sid], )
           end
 
           ##
-          # Deletes the CompositionHookInstance
+          # Delete the CompositionHookInstance
           # @return [Boolean] true if delete succeeds, false otherwise
           def delete
-            @version.delete('delete', @uri)
+             @version.delete('DELETE', @uri)
           end
 
           ##
@@ -399,11 +386,7 @@ module Twilio
                 'StatusCallbackMethod' => status_callback_method,
             })
 
-            payload = @version.update(
-                'POST',
-                @uri,
-                data: data,
-            )
+            payload = @version.update('POST', @uri, data: data)
 
             CompositionHookInstance.new(@version, payload, sid: @solution[:sid], )
           end
@@ -561,14 +544,14 @@ module Twilio
           end
 
           ##
-          # Fetch a CompositionHookInstance
+          # Fetch the CompositionHookInstance
           # @return [CompositionHookInstance] Fetched CompositionHookInstance
           def fetch
             context.fetch
           end
 
           ##
-          # Deletes the CompositionHookInstance
+          # Delete the CompositionHookInstance
           # @return [Boolean] true if delete succeeds, false otherwise
           def delete
             context.delete

data/lib/twilio-ruby/rest/video/v1/composition_settings.rb

@@ -72,23 +72,16 @@ module Twilio
           end
 
           ##
-          # Fetch a CompositionSettingsInstance
+          # Fetch the CompositionSettingsInstance
           # @return [CompositionSettingsInstance] Fetched CompositionSettingsInstance
           def fetch
-            params = Twilio::Values.of({})
-
-            payload = @version.fetch(
-                'GET',
-                @uri,
-                params,
-            )
+            payload = @version.fetch('GET', @uri)
 
             CompositionSettingsInstance.new(@version, payload, )
           end
 
           ##
-          # Retrieve a single page of CompositionSettingsInstance records from the API.
-          # Request is executed immediately.
+          # Create the CompositionSettingsInstance
           # @param [String] friendly_name A descriptive string that you create to describe
           #   the resource and show to the user in the console
           # @param [String] aws_credentials_sid The SID of the stored Credential resource.
@@ -96,13 +89,15 @@ module Twilio
           #   encryption.
           # @param [String] aws_s3_url The URL of the AWS S3 bucket where the compositions
           #   should be stored. We only support DNS-compliant URLs like
-          #   `http://<my-bucket>.s3-<aws-region>.amazonaws.com/compositions`, where
-          #   `compositions` is the path in which you want the compositions to be stored.
+          #   `https://<my-bucket>.s3-<aws-region>.amazonaws.com/compositions`, where
+          #   `compositions` is the path in which you want the compositions to be stored. This
+          #   URL accepts only URI-valid characters, as described in the <a
+          #   href='https://tools.ietf.org/html/rfc3986#section-2'>RFC 3986</a>.
           # @param [Boolean] aws_storage_enabled Whether all compositions should be written
           #   to the `aws_s3_url`. When `false`, all compositions are stored in our cloud.
           # @param [Boolean] encryption_enabled Whether all compositions should be stored in
           #   an encrypted form. The default is `false`.
-          # @return [CompositionSettingsInstance] Newly created CompositionSettingsInstance
+          # @return [CompositionSettingsInstance] Created CompositionSettingsInstance
           def create(friendly_name: nil, aws_credentials_sid: :unset, encryption_key_sid: :unset, aws_s3_url: :unset, aws_storage_enabled: :unset, encryption_enabled: :unset)
             data = Twilio::Values.of({
                 'FriendlyName' => friendly_name,
@@ -113,11 +108,7 @@ module Twilio
                 'EncryptionEnabled' => encryption_enabled,
             })
 
-            payload = @version.create(
-                'POST',
-                @uri,
-                data: data
-            )
+            payload = @version.create('POST', @uri, data: data)
 
             CompositionSettingsInstance.new(@version, payload, )
           end
@@ -223,15 +214,14 @@ module Twilio
           end
 
           ##
-          # Fetch a CompositionSettingsInstance
+          # Fetch the CompositionSettingsInstance
           # @return [CompositionSettingsInstance] Fetched CompositionSettingsInstance
           def fetch
             context.fetch
           end
 
           ##
-          # Retrieve a single page of CompositionSettingsInstance records from the API.
-          # Request is executed immediately.
+          # Create the CompositionSettingsInstance
           # @param [String] friendly_name A descriptive string that you create to describe
           #   the resource and show to the user in the console
           # @param [String] aws_credentials_sid The SID of the stored Credential resource.
@@ -239,13 +229,15 @@ module Twilio
           #   encryption.
           # @param [String] aws_s3_url The URL of the AWS S3 bucket where the compositions
           #   should be stored. We only support DNS-compliant URLs like
-          #   `http://<my-bucket>.s3-<aws-region>.amazonaws.com/compositions`, where
-          #   `compositions` is the path in which you want the compositions to be stored.
+          #   `https://<my-bucket>.s3-<aws-region>.amazonaws.com/compositions`, where
+          #   `compositions` is the path in which you want the compositions to be stored. This
+          #   URL accepts only URI-valid characters, as described in the <a
+          #   href='https://tools.ietf.org/html/rfc3986#section-2'>RFC 3986</a>.
           # @param [Boolean] aws_storage_enabled Whether all compositions should be written
           #   to the `aws_s3_url`. When `false`, all compositions are stored in our cloud.
           # @param [Boolean] encryption_enabled Whether all compositions should be stored in
           #   an encrypted form. The default is `false`.
-          # @return [CompositionSettingsInstance] Newly created CompositionSettingsInstance
+          # @return [CompositionSettingsInstance] Created CompositionSettingsInstance
           def create(friendly_name: nil, aws_credentials_sid: :unset, encryption_key_sid: :unset, aws_s3_url: :unset, aws_storage_enabled: :unset, encryption_enabled: :unset)
             context.create(
                 friendly_name: friendly_name,

data/lib/twilio-ruby/rest/video/v1/recording.rb

@@ -146,11 +146,9 @@ module Twilio
                 'Page' => page_number,
                 'PageSize' => page_size,
             })
-            response = @version.page(
-                'GET',
-                @uri,
-                params
-            )
+
+            response = @version.page('GET', @uri, params)
+
             RecordingPage.new(@version, response, @solution)
           end
 
@@ -218,25 +216,19 @@ module Twilio
           end
 
           ##
-          # Fetch a RecordingInstance
+          # Fetch the RecordingInstance
           # @return [RecordingInstance] Fetched RecordingInstance
           def fetch
-            params = Twilio::Values.of({})
-
-            payload = @version.fetch(
-                'GET',
-                @uri,
-                params,
-            )
+            payload = @version.fetch('GET', @uri)
 
             RecordingInstance.new(@version, payload, sid: @solution[:sid], )
           end
 
           ##
-          # Deletes the RecordingInstance
+          # Delete the RecordingInstance
           # @return [Boolean] true if delete succeeds, false otherwise
           def delete
-            @version.delete('delete', @uri)
+             @version.delete('DELETE', @uri)
           end
 
           ##
@@ -390,14 +382,14 @@ module Twilio
           end
 
           ##
-          # Fetch a RecordingInstance
+          # Fetch the RecordingInstance
           # @return [RecordingInstance] Fetched RecordingInstance
           def fetch
             context.fetch
           end
 
           ##
-          # Deletes the RecordingInstance
+          # Delete the RecordingInstance
           # @return [Boolean] true if delete succeeds, false otherwise
           def delete
             context.delete

data/lib/twilio-ruby/rest/video/v1/recording_settings.rb

@@ -72,23 +72,16 @@ module Twilio
           end
 
           ##
-          # Fetch a RecordingSettingsInstance
+          # Fetch the RecordingSettingsInstance
           # @return [RecordingSettingsInstance] Fetched RecordingSettingsInstance
           def fetch
-            params = Twilio::Values.of({})
-
-            payload = @version.fetch(
-                'GET',
-                @uri,
-                params,
-            )
+            payload = @version.fetch('GET', @uri)
 
             RecordingSettingsInstance.new(@version, payload, )
           end
 
           ##
-          # Retrieve a single page of RecordingSettingsInstance records from the API.
-          # Request is executed immediately.
+          # Create the RecordingSettingsInstance
           # @param [String] friendly_name A descriptive string that you create to describe
           #   the resource and be shown to users in the console
           # @param [String] aws_credentials_sid The SID of the stored Credential resource.
@@ -96,13 +89,15 @@ module Twilio
           #   encryption.
           # @param [String] aws_s3_url The URL of the AWS S3 bucket where the recordings
           #   should be stored. We only support DNS-compliant URLs like
-          #   `http://<my-bucket>.s3-<aws-region>.amazonaws.com/recordings`, where
-          #   `recordings` is the path in which you want the recordings to be stored.
+          #   `https://<my-bucket>.s3-<aws-region>.amazonaws.com/recordings`, where
+          #   `recordings` is the path in which you want the recordings to be stored. This URL
+          #   accepts only URI-valid characters, as described in the <a
+          #   href='https://tools.ietf.org/html/rfc3986#section-2'>RFC 3986</a>.
           # @param [Boolean] aws_storage_enabled Whether all recordings should be written to
           #   the `aws_s3_url`. When `false`, all recordings are stored in our cloud.
           # @param [Boolean] encryption_enabled Whether all recordings should be stored in
           #   an encrypted form. The default is `false`.
-          # @return [RecordingSettingsInstance] Newly created RecordingSettingsInstance
+          # @return [RecordingSettingsInstance] Created RecordingSettingsInstance
           def create(friendly_name: nil, aws_credentials_sid: :unset, encryption_key_sid: :unset, aws_s3_url: :unset, aws_storage_enabled: :unset, encryption_enabled: :unset)
             data = Twilio::Values.of({
                 'FriendlyName' => friendly_name,
@@ -113,11 +108,7 @@ module Twilio
                 'EncryptionEnabled' => encryption_enabled,
             })
 
-            payload = @version.create(
-                'POST',
-                @uri,
-                data: data
-            )
+            payload = @version.create('POST', @uri, data: data)
 
             RecordingSettingsInstance.new(@version, payload, )
           end
@@ -223,15 +214,14 @@ module Twilio
           end
 
           ##
-          # Fetch a RecordingSettingsInstance
+          # Fetch the RecordingSettingsInstance
           # @return [RecordingSettingsInstance] Fetched RecordingSettingsInstance
           def fetch
             context.fetch
           end
 
           ##
-          # Retrieve a single page of RecordingSettingsInstance records from the API.
-          # Request is executed immediately.
+          # Create the RecordingSettingsInstance
           # @param [String] friendly_name A descriptive string that you create to describe
           #   the resource and be shown to users in the console
           # @param [String] aws_credentials_sid The SID of the stored Credential resource.
@@ -239,13 +229,15 @@ module Twilio
           #   encryption.
           # @param [String] aws_s3_url The URL of the AWS S3 bucket where the recordings
           #   should be stored. We only support DNS-compliant URLs like
-          #   `http://<my-bucket>.s3-<aws-region>.amazonaws.com/recordings`, where
-          #   `recordings` is the path in which you want the recordings to be stored.
+          #   `https://<my-bucket>.s3-<aws-region>.amazonaws.com/recordings`, where
+          #   `recordings` is the path in which you want the recordings to be stored. This URL
+          #   accepts only URI-valid characters, as described in the <a
+          #   href='https://tools.ietf.org/html/rfc3986#section-2'>RFC 3986</a>.
           # @param [Boolean] aws_storage_enabled Whether all recordings should be written to
           #   the `aws_s3_url`. When `false`, all recordings are stored in our cloud.
           # @param [Boolean] encryption_enabled Whether all recordings should be stored in
           #   an encrypted form. The default is `false`.
-          # @return [RecordingSettingsInstance] Newly created RecordingSettingsInstance
+          # @return [RecordingSettingsInstance] Created RecordingSettingsInstance
           def create(friendly_name: nil, aws_credentials_sid: :unset, encryption_key_sid: :unset, aws_s3_url: :unset, aws_storage_enabled: :unset, encryption_enabled: :unset)
             context.create(
                 friendly_name: friendly_name,

data/lib/twilio-ruby/rest/video/v1/room.rb

@@ -24,8 +24,7 @@ module Twilio
           end
 
           ##
-          # Retrieve a single page of RoomInstance records from the API.
-          # Request is executed immediately.
+          # Create the RoomInstance
           # @param [Boolean] enable_turn Deprecated. Whether to enable [Twilio's Network
           #   Traversal TURN service](https://www.twilio.com/stun-turn). TURN service is used
           #   when direct peer-to-peer media connections cannot be established due to firewall
@@ -58,7 +57,7 @@ module Twilio
           # @param [String] media_region The region for the media server in Group Rooms.
           #   Can be: one of the [available Media
           #   Regions](https://www.twilio.com/docs/video/ip-address-whitelisting#group-rooms-media-servers). ***This feature is not available in `peer-to-peer` rooms.***
-          # @return [RoomInstance] Newly created RoomInstance
+          # @return [RoomInstance] Created RoomInstance
           def create(enable_turn: :unset, type: :unset, unique_name: :unset, status_callback: :unset, status_callback_method: :unset, max_participants: :unset, record_participants_on_connect: :unset, video_codecs: :unset, media_region: :unset)
             data = Twilio::Values.of({
                 'EnableTurn' => enable_turn,
@@ -72,11 +71,7 @@ module Twilio
                 'MediaRegion' => media_region,
             })
 
-            payload = @version.create(
-                'POST',
-                @uri,
-                data: data
-            )
+            payload = @version.create('POST', @uri, data: data)
 
             RoomInstance.new(@version, payload, )
           end
@@ -180,11 +175,9 @@ module Twilio
                 'Page' => page_number,
                 'PageSize' => page_size,
             })
-            response = @version.page(
-                'GET',
-                @uri,
-                params
-            )
+
+            response = @version.page('GET', @uri, params)
+
             RoomPage.new(@version, response, @solution)
           end
 
@@ -256,16 +249,10 @@ module Twilio
           end
 
           ##
-          # Fetch a RoomInstance
+          # Fetch the RoomInstance
           # @return [RoomInstance] Fetched RoomInstance
           def fetch
-            params = Twilio::Values.of({})
-
-            payload = @version.fetch(
-                'GET',
-                @uri,
-                params,
-            )
+            payload = @version.fetch('GET', @uri)
 
             RoomInstance.new(@version, payload, sid: @solution[:sid], )
           end
@@ -278,11 +265,7 @@ module Twilio
           def update(status: nil)
             data = Twilio::Values.of({'Status' => status, })
 
-            payload = @version.update(
-                'POST',
-                @uri,
-                data: data,
-            )
+            payload = @version.update('POST', @uri, data: data)
 
             RoomInstance.new(@version, payload, sid: @solution[:sid], )
           end
@@ -495,7 +478,7 @@ module Twilio
           end
 
           ##
-          # Fetch a RoomInstance
+          # Fetch the RoomInstance
           # @return [RoomInstance] Fetched RoomInstance
           def fetch
             context.fetch