twilio-ruby 5.31.1 → 5.54.0

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

@@ -29,11 +29,12 @@ module Twilio
         # @return [Twilio::REST::Video::V1::CompositionList]
         def compositions(sid=:unset)
           if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @compositions ||= CompositionList.new self
+              raise ArgumentError, 'sid cannot be nil'
+          end
+          if sid == :unset
+              @compositions ||= CompositionList.new self
           else
-            CompositionContext.new(self, sid)
+              CompositionContext.new(self, sid)
           end
         end
 
@@ -43,11 +44,12 @@ module Twilio
         # @return [Twilio::REST::Video::V1::CompositionHookList]
         def composition_hooks(sid=:unset)
           if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @composition_hooks ||= CompositionHookList.new self
+              raise ArgumentError, 'sid cannot be nil'
+          end
+          if sid == :unset
+              @composition_hooks ||= CompositionHookList.new self
           else
-            CompositionHookContext.new(self, sid)
+              CompositionHookContext.new(self, sid)
           end
         end
 
@@ -63,11 +65,12 @@ module Twilio
         # @return [Twilio::REST::Video::V1::RecordingList]
         def recordings(sid=:unset)
           if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @recordings ||= RecordingList.new self
+              raise ArgumentError, 'sid cannot be nil'
+          end
+          if sid == :unset
+              @recordings ||= RecordingList.new self
           else
-            RecordingContext.new(self, sid)
+              RecordingContext.new(self, sid)
           end
         end
 
@@ -83,11 +86,12 @@ module Twilio
         # @return [Twilio::REST::Video::V1::RoomList]
         def rooms(sid=:unset)
           if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @rooms ||= RoomList.new self
+              raise ArgumentError, 'sid cannot be nil'
+          end
+          if sid == :unset
+              @rooms ||= RoomList.new self
           else
-            RoomContext.new(self, sid)
+              RoomContext.new(self, sid)
           end
         end
 

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

@@ -10,8 +10,6 @@ module Twilio
   module REST
     class Video < Domain
       class V1 < Version
-        ##
-        # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
         class CompositionList < ListResource
           ##
           # Initialize the CompositionList
@@ -32,7 +30,7 @@ module Twilio
           # @param [composition.Status] status Read only Composition resources with this
           #   status. Can be: `enqueued`, `processing`, `completed`, `deleted`, or `failed`.
           # @param [Time] date_created_after Read only Composition resources created on or
-          #   after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date-time with
+          #   after this {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601] date-time with
           #   time zone.
           # @param [Time] date_created_before Read only Composition resources created before
           #   this ISO 8601 date-time with time zone.
@@ -62,7 +60,7 @@ module Twilio
           # @param [composition.Status] status Read only Composition resources with this
           #   status. Can be: `enqueued`, `processing`, `completed`, `deleted`, or `failed`.
           # @param [Time] date_created_after Read only Composition resources created on or
-          #   after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date-time with
+          #   after this {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601] date-time with
           #   time zone.
           # @param [Time] date_created_before Read only Composition resources created before
           #   this ISO 8601 date-time with time zone.
@@ -108,7 +106,7 @@ module Twilio
           # @param [composition.Status] status Read only Composition resources with this
           #   status. Can be: `enqueued`, `processing`, `completed`, `deleted`, or `failed`.
           # @param [Time] date_created_after Read only Composition resources created on or
-          #   after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date-time with
+          #   after this {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601] date-time with
           #   time zone.
           # @param [Time] date_created_before Read only Composition resources created before
           #   this ISO 8601 date-time with time zone.
@@ -127,11 +125,9 @@ module Twilio
                 'Page' => page_number,
                 'PageSize' => page_size,
             })
-            response = @version.page(
-                'GET',
-                @uri,
-                params
-            )
+
+            response = @version.page('GET', @uri, params: params)
+
             CompositionPage.new(@version, response, @solution)
           end
 
@@ -149,26 +145,29 @@ 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
-          #   composition in terms of regions. See [Specifying Video
-          #   Layouts](https://www.twilio.com/docs/video/api/compositions-resource#specifying-video-layouts) for more info.
-          # @param [String] audio_sources An array of track names from the same group room
-          #   to merge into the new composition. Can include zero or more track names. The new
-          #   composition includes all audio sources specified in `audio_sources` except for
-          #   those specified in `audio_sources_excluded`. The track names in this parameter
-          #   can include an asterisk as a wild card character, which will match zero or more
-          #   characters in a track name. For example, `student*` includes `student` as well
-          #   as `studentTeam`.
-          # @param [String] audio_sources_excluded An array of track names to exclude. The
-          #   new composition includes all audio sources specified in `audio_sources` except
-          #   for those specified in `audio_sources_excluded`. The track names in this
+          #   composition in terms of regions. See {Specifying Video
+          #   Layouts}[https://www.twilio.com/docs/video/api/compositions-resource#specifying-video-layouts]
+          #   for more info. Please, be aware that either video_layout or audio_sources have
+          #   to be provided to get a valid creation request
+          # @param [Array[String]] audio_sources An array of track names from the same group
+          #   room to merge into the new composition. Can include zero or more track names.
+          #   The new composition includes all audio sources specified in `audio_sources`
+          #   except for those specified in `audio_sources_excluded`. The track names in this
           #   parameter can include an asterisk as a wild card character, which will match
-          #   zero or more characters in a track name. For example, `student*` excludes
-          #   `student` as well as `studentTeam`. This parameter can also be empty.
+          #   zero or more characters in a track name. For example, `student*` includes
+          #   `student` as well as `studentTeam`. Please, be aware that either video_layout or
+          #   audio_sources have to be provided to get a valid creation request
+          # @param [Array[String]] audio_sources_excluded An array of track names to
+          #   exclude. The new composition includes all audio sources specified in
+          #   `audio_sources` except for those specified in `audio_sources_excluded`. The
+          #   track names in this parameter can include an asterisk as a wild card character,
+          #   which will match zero or more characters in a track name. For example,
+          #   `student*` excludes `student` as well as `studentTeam`. This parameter can also
+          #   be empty.
           # @param [String] resolution A string that describes the columns (width) and rows
           #   (height) of the generated composed video in pixels. Defaults to `640x480`.
           #   The string's format is `{width}x{height}` where:
@@ -186,8 +185,9 @@ module Twilio
           #
           #   Note that the `resolution` imposes an aspect ratio to the resulting composition.
           #   When the original video tracks are constrained by the aspect ratio, they are
-          #   scaled to fit. See [Specifying Video
-          #   Layouts](https://www.twilio.com/docs/video/api/compositions-resource#specifying-video-layouts) for more info.
+          #   scaled to fit. See {Specifying Video
+          #   Layouts}[https://www.twilio.com/docs/video/api/compositions-resource#specifying-video-layouts]
+          #   for more info.
           # @param [composition.Format] format The container format of the composition's
           #   media files. Can be: `mp4` or `webm` and the default is `webm`. If you specify
           #   `mp4` or `webm`, you must also specify one or more `audio_sources` and/or a
@@ -203,9 +203,10 @@ module Twilio
           #   media in the composition. The default is `true`. Compositions with `trim`
           #   enabled are shorter when the Room is created and no Participant joins for a
           #   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
+          #   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] 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,
@@ -219,11 +220,7 @@ module Twilio
                 'Trim' => trim,
             })
 
-            payload = @version.create(
-                'POST',
-                @uri,
-                data: data
-            )
+            payload = @version.create('POST', @uri, data: data)
 
             CompositionInstance.new(@version, payload, )
           end
@@ -235,8 +232,6 @@ module Twilio
           end
         end
 
-        ##
-        # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
         class CompositionPage < Page
           ##
           # Initialize the CompositionPage
@@ -266,8 +261,6 @@ module Twilio
           end
         end
 
-        ##
-        # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
         class CompositionContext < InstanceContext
           ##
           # Initialize the CompositionContext
@@ -283,25 +276,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
 
           ##
@@ -319,8 +306,6 @@ module Twilio
           end
         end
 
-        ##
-        # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
         class CompositionInstance < InstanceResource
           ##
           # Initialize the CompositionInstance
@@ -412,13 +397,13 @@ module Twilio
           end
 
           ##
-          # @return [String] The array of track names to include in the composition
+          # @return [Array[String]] The array of track names to include in the composition
           def audio_sources
             @properties['audio_sources']
           end
 
           ##
-          # @return [String] The array of track names to exclude from the composition
+          # @return [Array[String]] The array of track names to exclude from the composition
           def audio_sources_excluded
             @properties['audio_sources_excluded']
           end
@@ -478,14 +463,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

@@ -10,8 +10,6 @@ module Twilio
   module REST
     class Video < Domain
       class V1 < Version
-        ##
-        # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
         class CompositionHookList < ListResource
           ##
           # Initialize the CompositionHookList
@@ -32,10 +30,10 @@ module Twilio
           # @param [Boolean] enabled Read only CompositionHook resources with an `enabled`
           #   value that matches this parameter.
           # @param [Time] date_created_after Read only CompositionHook resources created on
-          #   or after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) datetime with
+          #   or after this {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601] datetime with
           #   time zone.
           # @param [Time] date_created_before Read only CompositionHook resources created
-          #   before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) datetime with
+          #   before this {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601] datetime with
           #   time zone.
           # @param [String] friendly_name Read only CompositionHook resources with friendly
           #   names that match this string. The match is not case sensitive and can include
@@ -65,10 +63,10 @@ module Twilio
           # @param [Boolean] enabled Read only CompositionHook resources with an `enabled`
           #   value that matches this parameter.
           # @param [Time] date_created_after Read only CompositionHook resources created on
-          #   or after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) datetime with
+          #   or after this {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601] datetime with
           #   time zone.
           # @param [Time] date_created_before Read only CompositionHook resources created
-          #   before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) datetime with
+          #   before this {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601] datetime with
           #   time zone.
           # @param [String] friendly_name Read only CompositionHook resources with friendly
           #   names that match this string. The match is not case sensitive and can include
@@ -114,10 +112,10 @@ module Twilio
           # @param [Boolean] enabled Read only CompositionHook resources with an `enabled`
           #   value that matches this parameter.
           # @param [Time] date_created_after Read only CompositionHook resources created on
-          #   or after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) datetime with
+          #   or after this {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601] datetime with
           #   time zone.
           # @param [Time] date_created_before Read only CompositionHook resources created
-          #   before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) datetime with
+          #   before this {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601] datetime with
           #   time zone.
           # @param [String] friendly_name Read only CompositionHook resources with friendly
           #   names that match this string. The match is not case sensitive and can include
@@ -136,11 +134,9 @@ module Twilio
                 'Page' => page_number,
                 'PageSize' => page_size,
             })
-            response = @version.page(
-                'GET',
-                @uri,
-                params
-            )
+
+            response = @version.page('GET', @uri, params: params)
+
             CompositionHookPage.new(@version, response, @solution)
           end
 
@@ -158,8 +154,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.
@@ -167,19 +162,20 @@ module Twilio
           #   the composition hook will be triggered for every completed Group Room in the
           #   account. When `false`, the composition hook will never be triggered.
           # @param [Hash] video_layout An object that describes the video layout of the
-          #   composition hook in terms of regions. See [Specifying Video
-          #   Layouts](https://www.twilio.com/docs/video/api/compositions-resource#specifying-video-layouts) for more info.
-          # @param [String] audio_sources An array of track names from the same group room
-          #   to merge into the compositions created by the composition hook. Can include zero
-          #   or more track names. A composition triggered by the composition hook includes
-          #   all audio sources specified in `audio_sources` except those specified in
-          #   `audio_sources_excluded`. The track names in this parameter can include an
+          #   composition hook in terms of regions. See {Specifying Video
+          #   Layouts}[https://www.twilio.com/docs/video/api/compositions-resource#specifying-video-layouts]
+          #   for more info.
+          # @param [Array[String]] audio_sources An array of track names from the same group
+          #   room to merge into the compositions created by the composition hook. Can include
+          #   zero or more track names. A composition triggered by the composition hook
+          #   includes all audio sources specified in `audio_sources` except those specified
+          #   in `audio_sources_excluded`. The track names in this parameter can include an
           #   asterisk as a wild card character, which matches zero or more characters in a
           #   track name. For example, `student*` includes tracks named `student` as well as
           #   `studentTeam`.
-          # @param [String] audio_sources_excluded An array of track names to exclude. A
-          #   composition triggered by the composition hook includes all audio sources
-          #   specified in `audio_sources` except for those specified in
+          # @param [Array[String]] audio_sources_excluded An array of track names to
+          #   exclude. A composition triggered by the composition hook includes all audio
+          #   sources specified in `audio_sources` except for those specified in
           #   `audio_sources_excluded`. The track names in this parameter can include an
           #   asterisk as a wild card character, which matches zero or more characters in a
           #   track name. For example, `student*` excludes `student` as well as `studentTeam`.
@@ -201,8 +197,9 @@ module Twilio
           #
           #   Note that the `resolution` imposes an aspect ratio to the resulting composition.
           #   When the original video tracks are constrained by the aspect ratio, they are
-          #   scaled to fit. See [Specifying Video
-          #   Layouts](https://www.twilio.com/docs/video/api/compositions-resource#specifying-video-layouts) for more info.
+          #   scaled to fit. See {Specifying Video
+          #   Layouts}[https://www.twilio.com/docs/video/api/compositions-resource#specifying-video-layouts]
+          #   for more info.
           # @param [composition_hook.Format] format The container format of the media files
           #   used by the compositions created by the composition hook. Can be: `mp4` or
           #   `webm` and the default is `webm`. If `mp4` or `webm`, `audio_sources` must have
@@ -218,10 +215,11 @@ module Twilio
           #   media in the Compositions triggered by the composition hook. The default is
           #   `true`. Compositions with `trim` enabled are shorter when the Room is created
           #   and no Participant joins for a while as well as if all the Participants leave
-          #   the room and join later, because those gaps will be removed. See [Specifying
+          #   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
+          #   Layouts}[https://www.twilio.com/docs/video/api/compositions-resource#specifying-video-layouts]
+          #   for more info.
+          # @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 +234,7 @@ module Twilio
                 'Trim' => trim,
             })
 
-            payload = @version.create(
-                'POST',
-                @uri,
-                data: data
-            )
+            payload = @version.create('POST', @uri, data: data)
 
             CompositionHookInstance.new(@version, payload, )
           end
@@ -252,8 +246,6 @@ module Twilio
           end
         end
 
-        ##
-        # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
         class CompositionHookPage < Page
           ##
           # Initialize the CompositionHookPage
@@ -283,8 +275,6 @@ module Twilio
           end
         end
 
-        ##
-        # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
         class CompositionHookContext < InstanceContext
           ##
           # Initialize the CompositionHookContext
@@ -300,25 +290,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
 
           ##
@@ -330,19 +314,20 @@ module Twilio
           #   the composition hook will be triggered for every completed Group Room in the
           #   account. When `false`, the composition hook never triggers.
           # @param [Hash] video_layout A JSON object that describes the video layout of the
-          #   composition hook in terms of regions. See [Specifying Video
-          #   Layouts](https://www.twilio.com/docs/video/api/compositions-resource#specifying-video-layouts) for more info.
-          # @param [String] audio_sources An array of track names from the same group room
-          #   to merge into the compositions created by the composition hook. Can include zero
-          #   or more track names. A composition triggered by the composition hook includes
-          #   all audio sources specified in `audio_sources` except those specified in
-          #   `audio_sources_excluded`. The track names in this parameter can include an
+          #   composition hook in terms of regions. See {Specifying Video
+          #   Layouts}[https://www.twilio.com/docs/video/api/compositions-resource#specifying-video-layouts]
+          #   for more info.
+          # @param [Array[String]] audio_sources An array of track names from the same group
+          #   room to merge into the compositions created by the composition hook. Can include
+          #   zero or more track names. A composition triggered by the composition hook
+          #   includes all audio sources specified in `audio_sources` except those specified
+          #   in `audio_sources_excluded`. The track names in this parameter can include an
           #   asterisk as a wild card character, which matches zero or more characters in a
           #   track name. For example, `student*` includes tracks named `student` as well as
           #   `studentTeam`.
-          # @param [String] audio_sources_excluded An array of track names to exclude. A
-          #   composition triggered by the composition hook includes all audio sources
-          #   specified in `audio_sources` except for those specified in
+          # @param [Array[String]] audio_sources_excluded An array of track names to
+          #   exclude. A composition triggered by the composition hook includes all audio
+          #   sources specified in `audio_sources` except for those specified in
           #   `audio_sources_excluded`. The track names in this parameter can include an
           #   asterisk as a wild card character, which matches zero or more characters in a
           #   track name. For example, `student*` excludes `student` as well as `studentTeam`.
@@ -351,9 +336,10 @@ module Twilio
           #   media in the compositions triggered by the composition hook. The default is
           #   `true`. Compositions with `trim` enabled are shorter when the Room is created
           #   and no Participant joins for a while as well as if all the Participants leave
-          #   the room and join later, because those gaps will be removed. See [Specifying
+          #   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.
+          #   Layouts}[https://www.twilio.com/docs/video/api/compositions-resource#specifying-video-layouts]
+          #   for more info.
           # @param [composition_hook.Format] format The container format of the media files
           #   used by the compositions created by the composition hook. Can be: `mp4` or
           #   `webm` and the default is `webm`. If `mp4` or `webm`, `audio_sources` must have
@@ -376,8 +362,9 @@ module Twilio
           #
           #   Note that the `resolution` imposes an aspect ratio to the resulting composition.
           #   When the original video tracks are constrained by the aspect ratio, they are
-          #   scaled to fit. See [Specifying Video
-          #   Layouts](https://www.twilio.com/docs/video/api/compositions-resource#specifying-video-layouts) for more info.
+          #   scaled to fit. See {Specifying Video
+          #   Layouts}[https://www.twilio.com/docs/video/api/compositions-resource#specifying-video-layouts]
+          #   for more info.
           # @param [String] status_callback The URL we should call using the
           #   `status_callback_method` to send status information to your application on every
           #   composition event. If not provided, status callback events will not be
@@ -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
@@ -423,8 +406,6 @@ module Twilio
           end
         end
 
-        ##
-        # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
         class CompositionHookInstance < InstanceResource
           ##
           # Initialize the CompositionHookInstance
@@ -507,13 +488,13 @@ module Twilio
           end
 
           ##
-          # @return [String] The array of track names to include in the compositions created by the composition hook
+          # @return [Array[String]] The array of track names to include in the compositions created by the composition hook
           def audio_sources
             @properties['audio_sources']
           end
 
           ##
-          # @return [String] The array of track names to exclude from the compositions created by the composition hook
+          # @return [Array[String]] The array of track names to exclude from the compositions created by the composition hook
           def audio_sources_excluded
             @properties['audio_sources_excluded']
           end
@@ -561,14 +542,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
@@ -583,19 +564,20 @@ module Twilio
           #   the composition hook will be triggered for every completed Group Room in the
           #   account. When `false`, the composition hook never triggers.
           # @param [Hash] video_layout A JSON object that describes the video layout of the
-          #   composition hook in terms of regions. See [Specifying Video
-          #   Layouts](https://www.twilio.com/docs/video/api/compositions-resource#specifying-video-layouts) for more info.
-          # @param [String] audio_sources An array of track names from the same group room
-          #   to merge into the compositions created by the composition hook. Can include zero
-          #   or more track names. A composition triggered by the composition hook includes
-          #   all audio sources specified in `audio_sources` except those specified in
-          #   `audio_sources_excluded`. The track names in this parameter can include an
+          #   composition hook in terms of regions. See {Specifying Video
+          #   Layouts}[https://www.twilio.com/docs/video/api/compositions-resource#specifying-video-layouts]
+          #   for more info.
+          # @param [Array[String]] audio_sources An array of track names from the same group
+          #   room to merge into the compositions created by the composition hook. Can include
+          #   zero or more track names. A composition triggered by the composition hook
+          #   includes all audio sources specified in `audio_sources` except those specified
+          #   in `audio_sources_excluded`. The track names in this parameter can include an
           #   asterisk as a wild card character, which matches zero or more characters in a
           #   track name. For example, `student*` includes tracks named `student` as well as
           #   `studentTeam`.
-          # @param [String] audio_sources_excluded An array of track names to exclude. A
-          #   composition triggered by the composition hook includes all audio sources
-          #   specified in `audio_sources` except for those specified in
+          # @param [Array[String]] audio_sources_excluded An array of track names to
+          #   exclude. A composition triggered by the composition hook includes all audio
+          #   sources specified in `audio_sources` except for those specified in
           #   `audio_sources_excluded`. The track names in this parameter can include an
           #   asterisk as a wild card character, which matches zero or more characters in a
           #   track name. For example, `student*` excludes `student` as well as `studentTeam`.
@@ -604,9 +586,10 @@ module Twilio
           #   media in the compositions triggered by the composition hook. The default is
           #   `true`. Compositions with `trim` enabled are shorter when the Room is created
           #   and no Participant joins for a while as well as if all the Participants leave
-          #   the room and join later, because those gaps will be removed. See [Specifying
+          #   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.
+          #   Layouts}[https://www.twilio.com/docs/video/api/compositions-resource#specifying-video-layouts]
+          #   for more info.
           # @param [composition_hook.Format] format The container format of the media files
           #   used by the compositions created by the composition hook. Can be: `mp4` or
           #   `webm` and the default is `webm`. If `mp4` or `webm`, `audio_sources` must have
@@ -629,8 +612,9 @@ module Twilio
           #
           #   Note that the `resolution` imposes an aspect ratio to the resulting composition.
           #   When the original video tracks are constrained by the aspect ratio, they are
-          #   scaled to fit. See [Specifying Video
-          #   Layouts](https://www.twilio.com/docs/video/api/compositions-resource#specifying-video-layouts) for more info.
+          #   scaled to fit. See {Specifying Video
+          #   Layouts}[https://www.twilio.com/docs/video/api/compositions-resource#specifying-video-layouts]
+          #   for more info.
           # @param [String] status_callback The URL we should call using the
           #   `status_callback_method` to send status information to your application on every
           #   composition event. If not provided, status callback events will not be