twilio-ruby 5.13.0 → 5.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: f4ce16d26c62514428db1b1c37f62028e0f7ee7a
-  data.tar.gz: a56c95b413a42d40568a9b9bff97324106ae5eec
+SHA256:
+  metadata.gz: b283a5a375b8c792fdbecff0c19851d34fe3fb4a2b2909e6c41ef66224831061
+  data.tar.gz: 36684ae1b0e4354ab6bba18c10bf636716e0084a4b6c08c3e0e5e8f055262e51
 SHA512:
-  metadata.gz: d26d08ff46decea3088152be428ea457a0a32b8f479f17948527821e4b102869ecbb2b27e4ffe5ad7c49702f34822a2e475b2e3f4c28575c131649769220a9d3
-  data.tar.gz: 447f2b394fab6112de58c3784f85bac91f128777592b40f90336d10164d8a7b30595fb46e946e34e41161b52491d754e71b74a88a57106246ef21d949390fc56
+  metadata.gz: 5a214307f7f74ba3ec34042448afd90e559603400bf25c37541c5be7d9235c809a2ad06f471b40d92f3330ed69045e7be19bb7c10cf9f939e1f96898389d6021
+  data.tar.gz: b98cb6532290b313e508a09400090184c1e79abf4ca97ad33b886044c50c154caca88482e482d470378a430cfa1370a1886967716eb2e7c2d19c6fbe6346ce94

data/CHANGES.md

@@ -1,6 +1,24 @@
 twilio-ruby changelog
 =====================
 
+[2018-09-28] Version 5.14.0
+----------------------------
+**Api**
+- Set `call_sid_to_coach` parameter in participant to be `preview`
+
+**Preview**
+- Renamed response headers for Challenge and Factors Signatures
+- Supported `totp` in Authy preview endpoints
+- Allowed `latest` in Authy Challenges endpoints
+
+**Video**
+- [Composer] Add Composition Hook resources
+
+**Voice**
+- changed path param name from parent_iso_code to iso_code for highrisk_special_prefixes api **(breaking change)**
+- added geo permissions public api
+
+
 [2018-09-20] Version 5.13.0
 ----------------------------
 **Preview**

data/README.md

@@ -27,13 +27,13 @@ in-line code documentation here in the library.
 To install using [Bundler][bundler] grab the latest stable version:
 
 ```ruby
-gem 'twilio-ruby', '~> 5.13.0'
+gem 'twilio-ruby', '~> 5.14.0'
 ```
 
 To manually install `twilio-ruby` via [Rubygems][rubygems] simply gem install:
 
 ```bash
-gem install twilio-ruby -v 5.13.0
+gem install twilio-ruby -v 5.14.0
 ```
 
 To build and install the development branch yourself from the latest source:

data/lib/twilio-ruby/rest/api/v2010/account/call/recording.rb

@@ -239,10 +239,10 @@ module Twilio
               # Update the RecordingInstance
               # @param [recording.Status] status The status to change the recording to. 
               #   Possible values: `stopped`, `paused`, `in-progress`
-              # @param [String] pause_behavior Possible values: `skip` or `silence`. `skip` will
-              #   result in no recording at all during the pause period. `silence` will replace
-              #   the actual audio of the call with silence during the pause period.  Defaults to
-              #   `silence`
+              # @param [String] pause_behavior Only applicable when setting Status parameter to
+              #   `paused`. Possible values: `skip` or `silence`. `skip` will result in no
+              #   recording at all during the pause period. `silence` will replace the actual
+              #   audio of the call with silence during the pause period.  Defaults to `silence`
               # @return [RecordingInstance] Updated RecordingInstance
               def update(status: nil, pause_behavior: :unset)
                 data = Twilio::Values.of({'Status' => status, 'PauseBehavior' => pause_behavior, })
@@ -461,10 +461,10 @@ module Twilio
               # Update the RecordingInstance
               # @param [recording.Status] status The status to change the recording to. 
               #   Possible values: `stopped`, `paused`, `in-progress`
-              # @param [String] pause_behavior Possible values: `skip` or `silence`. `skip` will
-              #   result in no recording at all during the pause period. `silence` will replace
-              #   the actual audio of the call with silence during the pause period.  Defaults to
-              #   `silence`
+              # @param [String] pause_behavior Only applicable when setting Status parameter to
+              #   `paused`. Possible values: `skip` or `silence`. `skip` will result in no
+              #   recording at all during the pause period. `silence` will replace the actual
+              #   audio of the call with silence during the pause period.  Defaults to `silence`
               # @return [RecordingInstance] Updated RecordingInstance
               def update(status: nil, pause_behavior: :unset)
                 context.update(status: status, pause_behavior: pause_behavior, )

data/lib/twilio-ruby/rest/api/v2010/account/conference/participant.rb

@@ -124,11 +124,8 @@ module Twilio
               #   specified in the `ConferenceRecordingStatusCallback` attribute. Available values
               #   are `in-progress`, `completed`, `failed`. To specify multiple values, separate
               #   them with a space. Defaults to `in-progress`, `completed`, `failed`.
-              # @param [String] call_sid_to_coach The string that uniquely identifies the
-              #   participant that is being `coached`, i.e. the only participant who can hear the
-              #   participant that is in `coach` mode.
               # @return [ParticipantInstance] Newly created ParticipantInstance
-              def create(from: nil, to: nil, status_callback: :unset, status_callback_method: :unset, status_callback_event: :unset, timeout: :unset, record: :unset, muted: :unset, beep: :unset, start_conference_on_enter: :unset, end_conference_on_exit: :unset, wait_url: :unset, wait_method: :unset, early_media: :unset, max_participants: :unset, conference_record: :unset, conference_trim: :unset, conference_status_callback: :unset, conference_status_callback_method: :unset, conference_status_callback_event: :unset, recording_channels: :unset, recording_status_callback: :unset, recording_status_callback_method: :unset, sip_auth_username: :unset, sip_auth_password: :unset, region: :unset, conference_recording_status_callback: :unset, conference_recording_status_callback_method: :unset, recording_status_callback_event: :unset, conference_recording_status_callback_event: :unset, call_sid_to_coach: :unset)
+              def create(from: nil, to: nil, status_callback: :unset, status_callback_method: :unset, status_callback_event: :unset, timeout: :unset, record: :unset, muted: :unset, beep: :unset, start_conference_on_enter: :unset, end_conference_on_exit: :unset, wait_url: :unset, wait_method: :unset, early_media: :unset, max_participants: :unset, conference_record: :unset, conference_trim: :unset, conference_status_callback: :unset, conference_status_callback_method: :unset, conference_status_callback_event: :unset, recording_channels: :unset, recording_status_callback: :unset, recording_status_callback_method: :unset, sip_auth_username: :unset, sip_auth_password: :unset, region: :unset, conference_recording_status_callback: :unset, conference_recording_status_callback_method: :unset, recording_status_callback_event: :unset, conference_recording_status_callback_event: :unset)
                 data = Twilio::Values.of({
                     'From' => from,
                     'To' => to,
@@ -160,7 +157,6 @@ module Twilio
                     'ConferenceRecordingStatusCallbackMethod' => conference_recording_status_callback_method,
                     'RecordingStatusCallbackEvent' => Twilio.serialize_list(recording_status_callback_event) { |e| e },
                     'ConferenceRecordingStatusCallbackEvent' => Twilio.serialize_list(conference_recording_status_callback_event) { |e| e },
-                    'CallSidToCoach' => call_sid_to_coach,
                 })
 
                 payload = @version.create(

data/lib/twilio-ruby/rest/api/v2010/account/conference/recording.rb

@@ -197,10 +197,10 @@ module Twilio
               # Update the RecordingInstance
               # @param [recording.Status] status The status to change the recording to. 
               #   Possible values: `stopped`, `paused`, `in-progress`
-              # @param [String] pause_behavior Possible values: `skip` or `silence`. `skip` will
-              #   result in no recording at all during the pause period. `silence` will replace
-              #   the actual audio of the call with silence during the pause period.  Defaults to
-              #   `silence`
+              # @param [String] pause_behavior Only applicable when setting Status parameter to
+              #   `paused`. Possible values: `skip` or `silence`. `skip` will result in no
+              #   recording at all during the pause period. `silence` will replace the actual
+              #   audio of the call with silence during the pause period.  Defaults to `silence`
               # @return [RecordingInstance] Updated RecordingInstance
               def update(status: nil, pause_behavior: :unset)
                 data = Twilio::Values.of({'Status' => status, 'PauseBehavior' => pause_behavior, })
@@ -423,10 +423,10 @@ module Twilio
               # Update the RecordingInstance
               # @param [recording.Status] status The status to change the recording to. 
               #   Possible values: `stopped`, `paused`, `in-progress`
-              # @param [String] pause_behavior Possible values: `skip` or `silence`. `skip` will
-              #   result in no recording at all during the pause period. `silence` will replace
-              #   the actual audio of the call with silence during the pause period.  Defaults to
-              #   `silence`
+              # @param [String] pause_behavior Only applicable when setting Status parameter to
+              #   `paused`. Possible values: `skip` or `silence`. `skip` will result in no
+              #   recording at all during the pause period. `silence` will replace the actual
+              #   audio of the call with silence during the pause period.  Defaults to `silence`
               # @return [RecordingInstance] Updated RecordingInstance
               def update(status: nil, pause_behavior: :unset)
                 context.update(status: status, pause_behavior: pause_behavior, )

data/lib/twilio-ruby/rest/client.rb

@@ -44,6 +44,7 @@ module Twilio
         @sync = nil
         @studio = nil
         @verify = nil
+        @voice = nil
       end
 
       ##
@@ -208,6 +209,12 @@ module Twilio
         @verify ||= Verify.new self
       end
 
+      ##
+      # Access the Voice Twilio Domain
+      def voice
+        @voice ||= Voice.new self
+      end
+
       ##
       # @param [String] sid A 34 character string that uniquely identifies this address.
       # @return [Twilio::REST::Api::V2010::AccountContext::AddressInstance] if sid was passed.

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

@@ -15,37 +15,37 @@ module Twilio
         def initialize(domain)
           super
           @version = 'marketplace'
-          @installed_add_ons = nil
           @available_add_ons = nil
+          @installed_add_ons = nil
         end
 
         ##
-        # @param [String] sid The Installed Add-on Sid that uniquely identifies this
+        # @param [String] sid The Available Add-on Sid that uniquely identifies this
         #   resource
-        # @return [Twilio::REST::Preview::Marketplace::InstalledAddOnContext] if sid was passed.
-        # @return [Twilio::REST::Preview::Marketplace::InstalledAddOnList]
-        def installed_add_ons(sid=:unset)
+        # @return [Twilio::REST::Preview::Marketplace::AvailableAddOnContext] if sid was passed.
+        # @return [Twilio::REST::Preview::Marketplace::AvailableAddOnList]
+        def available_add_ons(sid=:unset)
           if sid.nil?
             raise ArgumentError, 'sid cannot be nil'
           elsif sid == :unset
-            @installed_add_ons ||= InstalledAddOnList.new self
+            @available_add_ons ||= AvailableAddOnList.new self
           else
-            InstalledAddOnContext.new(self, sid)
+            AvailableAddOnContext.new(self, sid)
           end
         end
 
         ##
-        # @param [String] sid The Available Add-on Sid that uniquely identifies this
+        # @param [String] sid The Installed Add-on Sid that uniquely identifies this
         #   resource
-        # @return [Twilio::REST::Preview::Marketplace::AvailableAddOnContext] if sid was passed.
-        # @return [Twilio::REST::Preview::Marketplace::AvailableAddOnList]
-        def available_add_ons(sid=:unset)
+        # @return [Twilio::REST::Preview::Marketplace::InstalledAddOnContext] if sid was passed.
+        # @return [Twilio::REST::Preview::Marketplace::InstalledAddOnList]
+        def installed_add_ons(sid=:unset)
           if sid.nil?
             raise ArgumentError, 'sid cannot be nil'
           elsif sid == :unset
-            @available_add_ons ||= AvailableAddOnList.new self
+            @installed_add_ons ||= InstalledAddOnList.new self
           else
-            AvailableAddOnContext.new(self, sid)
+            InstalledAddOnContext.new(self, sid)
           end
         end
 

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

@@ -28,7 +28,6 @@ module Twilio
         @sync = nil
         @understand = nil
         @wireless = nil
-        @permissions = nil
       end
 
       ##
@@ -85,12 +84,6 @@ module Twilio
         @wireless ||= Wireless.new self
       end
 
-      ##
-      # Version permissions of preview
-      def permissions
-        @permissions ||= Permissions.new self
-      end
-
       ##
       # @param [String] sid The sid
       # @return [Twilio::REST::Preview::Sync::ServiceInstance] if sid was passed.
@@ -142,6 +135,14 @@ module Twilio
         self.hosted_numbers.hosted_number_orders(sid)
       end
 
+      ##
+      # @param [String] sid A 34 character string that uniquely identifies this Add-on.
+      # @return [Twilio::REST::Preview::Marketplace::AvailableAddOnInstance] if sid was passed.
+      # @return [Twilio::REST::Preview::Marketplace::AvailableAddOnList]
+      def available_add_ons(sid=:unset)
+        self.marketplace.available_add_ons(sid)
+      end
+
       ##
       # @param [String] sid 34 character string that uniquely identifies the Add-on.
       #   This Sid can also be found in the Console on that specific Add-ons page as the
@@ -152,14 +153,6 @@ module Twilio
         self.marketplace.installed_add_ons(sid)
       end
 
-      ##
-      # @param [String] sid A 34 character string that uniquely identifies this Add-on.
-      # @return [Twilio::REST::Preview::Marketplace::AvailableAddOnInstance] if sid was passed.
-      # @return [Twilio::REST::Preview::Marketplace::AvailableAddOnList]
-      def available_add_ons(sid=:unset)
-        self.marketplace.available_add_ons(sid)
-      end
-
       ##
       # @param [String] sid A 34 character string that uniquely identifies this
       #   resource.
@@ -193,12 +186,6 @@ module Twilio
         self.wireless.sims(sid)
       end
 
-      ##
-      # @return [Twilio::REST::Preview::Permissions::VoicePermissionInstance]
-      def voice_permissions
-        self.permissions.voice_permissions()
-      end
-
       ##
       # Provide a user friendly representation
       def to_s

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

@@ -157,7 +157,7 @@ module Twilio
           #   * Zero or more `ParticipantSid`
           #   * Zero or more Track names. These can be specified using wildcards (e.g.
           #   `student*`). The use of `[*]` has semantics "all if any" meaning zero or more
-          #   (i.e. all) depending on whether the target room had video tracks.
+          #   (i.e. all) depending on whether the target room had audio tracks.
           # @param [String] audio_sources_excluded An array of audio sources to exclude from
           #   the Composition. Any new Composition shall include all audio sources specified
           #   in `AudioSources` except for the ones specified in `AudioSourcesExcluded`. This

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

@@ -0,0 +1,626 @@
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /
+# 
+# frozen_string_literal: true
+
+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
+          # @param [Version] version Version that contains the resource
+          # @return [CompositionHookList] CompositionHookList
+          def initialize(version)
+            super(version)
+
+            # Path Solution
+            @solution = {}
+            @uri = "/CompositionHooks"
+          end
+
+          ##
+          # Lists CompositionHookInstance records from the API as a list.
+          # Unlike stream(), this operation is eager and will load `limit` records into
+          # memory before returning.
+          # @param [Boolean] enabled Only show Composition Hooks that are enabled or
+          #   disabled.
+          # @param [Time] date_created_after Only show Composition Hooks created on or after
+          #   this ISO8601 date-time, given as `YYYY-MM-DDThh:mm:ss-hh:mm`.
+          # @param [Time] date_created_before Only show Composition Hooks created before
+          #   this this ISO8601 date-time, given as `YYYY-MM-DDThh:mm:ss-hh:mm`.
+          # @param [Integer] limit Upper limit for the number of records to return. stream()
+          #    guarantees to never return more than limit.  Default is no limit
+          # @param [Integer] page_size Number of records to fetch per request, when
+          #    not set will use the default value of 50 records.  If no page_size is defined
+          #    but a limit is defined, stream() will attempt to read the limit with the most
+          #    efficient page size, i.e. min(limit, 1000)
+          # @return [Array] Array of up to limit results
+          def list(enabled: :unset, date_created_after: :unset, date_created_before: :unset, limit: nil, page_size: nil)
+            self.stream(
+                enabled: enabled,
+                date_created_after: date_created_after,
+                date_created_before: date_created_before,
+                limit: limit,
+                page_size: page_size
+            ).entries
+          end
+
+          ##
+          # Streams CompositionHookInstance records from the API as an Enumerable.
+          # This operation lazily loads records as efficiently as possible until the limit
+          # is reached.
+          # @param [Boolean] enabled Only show Composition Hooks that are enabled or
+          #   disabled.
+          # @param [Time] date_created_after Only show Composition Hooks created on or after
+          #   this ISO8601 date-time, given as `YYYY-MM-DDThh:mm:ss-hh:mm`.
+          # @param [Time] date_created_before Only show Composition Hooks created before
+          #   this this ISO8601 date-time, given as `YYYY-MM-DDThh:mm:ss-hh:mm`.
+          # @param [Integer] limit Upper limit for the number of records to return. stream()
+          #    guarantees to never return more than limit. Default is no limit.
+          # @param [Integer] page_size Number of records to fetch per request, when
+          #    not set will use the default value of 50 records. If no page_size is defined
+          #    but a limit is defined, stream() will attempt to read the limit with the most
+          #    efficient page size, i.e. min(limit, 1000)
+          # @return [Enumerable] Enumerable that will yield up to limit results
+          def stream(enabled: :unset, date_created_after: :unset, date_created_before: :unset, limit: nil, page_size: nil)
+            limits = @version.read_limits(limit, page_size)
+
+            page = self.page(
+                enabled: enabled,
+                date_created_after: date_created_after,
+                date_created_before: date_created_before,
+                page_size: limits[:page_size],
+            )
+
+            @version.stream(page, limit: limits[:limit], page_limit: limits[:page_limit])
+          end
+
+          ##
+          # When passed a block, yields CompositionHookInstance records from the API.
+          # This operation lazily loads records as efficiently as possible until the limit
+          # is reached.
+          def each
+            limits = @version.read_limits
+
+            page = self.page(page_size: limits[:page_size], )
+
+            @version.stream(page,
+                            limit: limits[:limit],
+                            page_limit: limits[:page_limit]).each {|x| yield x}
+          end
+
+          ##
+          # Retrieve a single page of CompositionHookInstance records from the API.
+          # Request is executed immediately.
+          # @param [Boolean] enabled Only show Composition Hooks that are enabled or
+          #   disabled.
+          # @param [Time] date_created_after Only show Composition Hooks created on or after
+          #   this ISO8601 date-time, given as `YYYY-MM-DDThh:mm:ss-hh:mm`.
+          # @param [Time] date_created_before Only show Composition Hooks created before
+          #   this this ISO8601 date-time, given as `YYYY-MM-DDThh:mm:ss-hh:mm`.
+          # @param [String] page_token PageToken provided by the API
+          # @param [Integer] page_number Page Number, this value is simply for client state
+          # @param [Integer] page_size Number of records to return, defaults to 50
+          # @return [Page] Page of CompositionHookInstance
+          def page(enabled: :unset, date_created_after: :unset, date_created_before: :unset, page_token: :unset, page_number: :unset, page_size: :unset)
+            params = Twilio::Values.of({
+                'Enabled' => enabled,
+                'DateCreatedAfter' => Twilio.serialize_iso8601_datetime(date_created_after),
+                'DateCreatedBefore' => Twilio.serialize_iso8601_datetime(date_created_before),
+                'PageToken' => page_token,
+                'Page' => page_number,
+                'PageSize' => page_size,
+            })
+            response = @version.page(
+                'GET',
+                @uri,
+                params
+            )
+            CompositionHookPage.new(@version, response, @solution)
+          end
+
+          ##
+          # Retrieve a single page of CompositionHookInstance records from the API.
+          # Request is executed immediately.
+          # @param [String] target_url API-generated URL for the requested results page
+          # @return [Page] Page of CompositionHookInstance
+          def get_page(target_url)
+            response = @version.domain.request(
+                'GET',
+                target_url
+            )
+            CompositionHookPage.new(@version, response, @solution)
+          end
+
+          ##
+          # Retrieve a single page of CompositionHookInstance records from the API.
+          # Request is executed immediately.
+          # @param [String] friendly_name Friendly name of the Composition Hook to be shown
+          #   in the console.
+          # @param [Boolean] enabled When activated, the Composition Hook is enabled and a
+          #   composition will be triggered for every Video room completed by this account
+          #   from this point onwards; `false` indicates the Composition Hook is left
+          #   inactive.
+          # @param [Hash] video_layout A JSON object defining the video layout of the
+          #   Composition Hook in terms of regions. See the section [Managing Video
+          #   Layouts](#managing-video-layouts) below for further information.
+          # @param [String] audio_sources An array of audio sources to merge. All the
+          #   specified sources must belong to the same Group Room. It can include: 
+          #   * Zero or more Track names. These can be specified using wildcards (e.g.
+          #   `student*`). The use of `[*]` has semantics "all if any" meaning zero or more
+          #   (i.e. all) depending on whether the Group Room had audio tracks.
+          # @param [String] audio_sources_excluded An array of audio sources to exclude from
+          #   the Composition Hook. Any new Composition triggered by the Composition Hook
+          #   shall include all audio sources specified in `AudioSources` except for the ones
+          #   specified in `AudioSourcesExcluded`. This parameter may include: 
+          #   * Zero or more Track names. These can be specified using wildcards (e.g.
+          #   `student*`)
+          # @param [String] resolution A string representing the numbers of pixels for rows
+          #   (width) and columns (height) of the generated composed video. This string must
+          #   have the format `{width}x{height}`. This parameter must comply with the
+          #   following constraints: 
+          #   * `width >= 16 && width <= 1280`
+          #   * `height >= 16 && height <= 1280`
+          #   * `width * height <= 921,600`
+          #   Typical values are: 
+          #   * HD = `1280x720`
+          #   * PAL = `1024x576`
+          #   * VGA = `640x480`
+          #   * CIF = `320x240`
+          #   Note that the `Resolution` implicitly imposes an aspect ratio to the resulting
+          #   composition. When the original video tracks get constrained by this aspect ratio
+          #   they are scaled-down to fit. You can find detailed information in the [Managing
+          #   Video Layouts](#managing-video-layouts) section. Defaults to `640x480`.
+          # @param [composition_hook.Format] format Container format of the Composition
+          #   media files created by the Composition Hook. Can be any of the following: `mp4`,
+          #   `webm`. The use of `mp4` or `webm` makes mandatory the specification of
+          #   `AudioSources` and/or one `VideoLayout` element containing a valid
+          #   `video_sources` list, otherwise an error is fired. Defaults to `webm`.
+          # @param [String] status_callback A URL that Twilio sends asynchronous webhook
+          #   requests to on every composition event. If not provided, status callback events
+          #   will not be dispatched.
+          # @param [String] status_callback_method HTTP method Twilio should use when
+          #   requesting the above URL. Defaults to `POST`.
+          # @param [Boolean] trim When activated, clips all the intervals where there is no
+          #   active media in the Compositions triggered by the Composition Hook. This results
+          #   in shorter compositions in cases when the Room was created but no Participant
+          #   joined for some time, or if all the Participants left the room and joined at a
+          #   later stage, as those gaps will be removed. You can find further information in
+          #   the [Managing Video Layouts](#managing-video-layouts) section. Defaults to
+          #   `true`.
+          # @return [CompositionHookInstance] Newly 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,
+                'Enabled' => enabled,
+                'VideoLayout' => Twilio.serialize_object(video_layout),
+                'AudioSources' => Twilio.serialize_list(audio_sources) { |e| e },
+                'AudioSourcesExcluded' => Twilio.serialize_list(audio_sources_excluded) { |e| e },
+                'Resolution' => resolution,
+                'Format' => format,
+                'StatusCallback' => status_callback,
+                'StatusCallbackMethod' => status_callback_method,
+                'Trim' => trim,
+            })
+
+            payload = @version.create(
+                'POST',
+                @uri,
+                data: data
+            )
+
+            CompositionHookInstance.new(@version, payload, )
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            '#<Twilio.Video.V1.CompositionHookList>'
+          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
+          # @param [Version] version Version that contains the resource
+          # @param [Response] response Response from the API
+          # @param [Hash] solution Path solution for the resource
+          # @return [CompositionHookPage] CompositionHookPage
+          def initialize(version, response, solution)
+            super(version, response)
+
+            # Path Solution
+            @solution = solution
+          end
+
+          ##
+          # Build an instance of CompositionHookInstance
+          # @param [Hash] payload Payload response from the API
+          # @return [CompositionHookInstance] CompositionHookInstance
+          def get_instance(payload)
+            CompositionHookInstance.new(@version, payload, )
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            '<Twilio.Video.V1.CompositionHookPage>'
+          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
+          # @param [Version] version Version that contains the resource
+          # @param [String] sid The Composition Hook Sid that uniquely identifies the
+          #   Composition Hook to fetch.
+          # @return [CompositionHookContext] CompositionHookContext
+          def initialize(version, sid)
+            super(version)
+
+            # Path Solution
+            @solution = {sid: sid, }
+            @uri = "/CompositionHooks/#{@solution[:sid]}"
+          end
+
+          ##
+          # Fetch a CompositionHookInstance
+          # @return [CompositionHookInstance] Fetched CompositionHookInstance
+          def fetch
+            params = Twilio::Values.of({})
+
+            payload = @version.fetch(
+                'GET',
+                @uri,
+                params,
+            )
+
+            CompositionHookInstance.new(@version, payload, sid: @solution[:sid], )
+          end
+
+          ##
+          # Deletes the CompositionHookInstance
+          # @return [Boolean] true if delete succeeds, true otherwise
+          def delete
+            @version.delete('delete', @uri)
+          end
+
+          ##
+          # Update the CompositionHookInstance
+          # @param [String] friendly_name Friendly name of the Composition Hook to be shown
+          #   in the console.
+          # @param [Boolean] enabled When activated, the Composition Hook is enabled and a
+          #   composition will be triggered for every Video room completed by this account
+          #   from this point onwards; `false` indicates the Composition Hook is left
+          #   inactive.
+          # @param [Hash] video_layout A JSON object defining the video layout of the
+          #   Composition Hook in terms of regions. See the section [Managing Video
+          #   Layouts](#managing-video-layouts) below for further information.
+          # @param [String] audio_sources An array of audio sources to merge. All the
+          #   specified sources must belong to the same Group Room. It can include: 
+          #   * Zero or more Track names. These can be specified using wildcards (e.g.
+          #   `student*`). The use of `[*]` has semantics "all if any" meaning zero or more
+          #   (i.e. all) depending on whether the Group Room had audio tracks.
+          # @param [String] audio_sources_excluded An array of audio sources to exclude from
+          #   the Composition Hook. Any new Composition triggered by the Composition Hook
+          #   shall include all audio sources specified in `AudioSources` except for the ones
+          #   specified in `AudioSourcesExcluded`. This parameter may include: 
+          #   * Zero or more Track names. These can be specified using wildcards (e.g.
+          #   `student*`)
+          # @param [Boolean] trim When activated, clips all the intervals where there is no
+          #   active media in the Compositions triggered by the Composition Hook. This results
+          #   in shorter compositions in cases when the Room was created but no Participant
+          #   joined for some time, or if all the Participants left the room and joined at a
+          #   later stage, as those gaps will be removed. You can find further information in
+          #   the [Managing Video Layouts](#managing-video-layouts) section. Defaults to
+          #   `true`.
+          # @param [composition_hook.Format] format Container format of the Composition
+          #   media files created by the Composition Hook. Can be any of the following: `mp4`,
+          #   `webm`. The use of `mp4` or `webm` makes mandatory the specification of
+          #   `AudioSources` and/or one `VideoLayout` element containing a valid
+          #   `video_sources` list, otherwise an error is fired. Defaults to `webm`.
+          # @param [String] resolution A string representing the numbers of pixels for rows
+          #   (width) and columns (height) of the generated composed video. This string must
+          #   have the format `{width}x{height}`. This parameter must comply with the
+          #   following constraints: 
+          #   * `width >= 16 && width <= 1280`
+          #   * `height >= 16 && height <= 1280`
+          #   * `width * height <= 921,600`
+          #   Typical values are: 
+          #   * HD = `1280x720`
+          #   * PAL = `1024x576`
+          #   * VGA = `640x480`
+          #   * CIF = `320x240`
+          #   Note that the `Resolution` implicitly imposes an aspect ratio to the resulting
+          #   composition. When the original video tracks get constrained by this aspect ratio
+          #   they are scaled-down to fit. You can find detailed information in the [Managing
+          #   Video Layouts](#managing-video-layouts) section. Defaults to `640x480`.
+          # @param [String] status_callback A URL that Twilio sends asynchronous webhook
+          #   requests to on every composition event. If not provided, status callback events
+          #   will not be dispatched.
+          # @param [String] status_callback_method HTTP method Twilio should use when
+          #   requesting the above URL. Defaults to `POST`.
+          # @return [CompositionHookInstance] Updated CompositionHookInstance
+          def update(friendly_name: nil, enabled: :unset, video_layout: :unset, audio_sources: :unset, audio_sources_excluded: :unset, trim: :unset, format: :unset, resolution: :unset, status_callback: :unset, status_callback_method: :unset)
+            data = Twilio::Values.of({
+                'FriendlyName' => friendly_name,
+                'Enabled' => enabled,
+                'VideoLayout' => Twilio.serialize_object(video_layout),
+                'AudioSources' => Twilio.serialize_list(audio_sources) { |e| e },
+                'AudioSourcesExcluded' => Twilio.serialize_list(audio_sources_excluded) { |e| e },
+                'Trim' => trim,
+                'Format' => format,
+                'Resolution' => resolution,
+                'StatusCallback' => status_callback,
+                'StatusCallbackMethod' => status_callback_method,
+            })
+
+            payload = @version.update(
+                'POST',
+                @uri,
+                data: data,
+            )
+
+            CompositionHookInstance.new(@version, payload, sid: @solution[:sid], )
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+            "#<Twilio.Video.V1.CompositionHookContext #{context}>"
+          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
+          # @param [Version] version Version that contains the resource
+          # @param [Hash] payload payload that contains response from Twilio
+          # @param [String] sid The Composition Hook Sid that uniquely identifies the
+          #   Composition Hook to fetch.
+          # @return [CompositionHookInstance] CompositionHookInstance
+          def initialize(version, payload, sid: nil)
+            super(version)
+
+            # Marshaled Properties
+            @properties = {
+                'account_sid' => payload['account_sid'],
+                'friendly_name' => payload['friendly_name'],
+                'enabled' => payload['enabled'],
+                'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
+                'date_updated' => payload['date_updated'],
+                'sid' => payload['sid'],
+                'audio_sources' => payload['audio_sources'],
+                'audio_sources_excluded' => payload['audio_sources_excluded'],
+                'video_layout' => payload['video_layout'],
+                'resolution' => payload['resolution'],
+                'trim' => payload['trim'],
+                'format' => payload['format'],
+                'status_callback' => payload['status_callback'],
+                'status_callback_method' => payload['status_callback_method'],
+                'url' => payload['url'],
+            }
+
+            # Context
+            @instance_context = nil
+            @params = {'sid' => sid || @properties['sid'], }
+          end
+
+          ##
+          # Generate an instance context for the instance, the context is capable of
+          # performing various actions.  All instance actions are proxied to the context
+          # @return [CompositionHookContext] CompositionHookContext for this CompositionHookInstance
+          def context
+            unless @instance_context
+              @instance_context = CompositionHookContext.new(@version, @params['sid'], )
+            end
+            @instance_context
+          end
+
+          ##
+          # @return [String] Twilio Account SID.
+          def account_sid
+            @properties['account_sid']
+          end
+
+          ##
+          # @return [String] Friendly name of the Composition Hook to be shown in the console.
+          def friendly_name
+            @properties['friendly_name']
+          end
+
+          ##
+          # @return [Boolean] Boolean flag for activating the Composition Hook.
+          def enabled
+            @properties['enabled']
+          end
+
+          ##
+          # @return [Time] Date when the Composition Hook Resource was created.
+          def date_created
+            @properties['date_created']
+          end
+
+          ##
+          # @return [String] Date when the Composition Hook was last updated.
+          def date_updated
+            @properties['date_updated']
+          end
+
+          ##
+          # @return [String] A 34-character string that uniquely identifies this Composition Hook.
+          def sid
+            @properties['sid']
+          end
+
+          ##
+          # @return [String] A list of audio sources related to this Composition Hook.
+          def audio_sources
+            @properties['audio_sources']
+          end
+
+          ##
+          # @return [String] A list of audio sources excluded related to this Composition Hook.
+          def audio_sources_excluded
+            @properties['audio_sources_excluded']
+          end
+
+          ##
+          # @return [Hash] The JSON video layout description.
+          def video_layout
+            @properties['video_layout']
+          end
+
+          ##
+          # @return [String] Pixel resolution of the composed video.
+          def resolution
+            @properties['resolution']
+          end
+
+          ##
+          # @return [Boolean] Boolean flag for clipping intervals that have no media.
+          def trim
+            @properties['trim']
+          end
+
+          ##
+          # @return [composition_hook.Format] The file format for the Compositions triggered by the Composition Hook.
+          def format
+            @properties['format']
+          end
+
+          ##
+          # @return [String] The status_callback
+          def status_callback
+            @properties['status_callback']
+          end
+
+          ##
+          # @return [String] The status_callback_method
+          def status_callback_method
+            @properties['status_callback_method']
+          end
+
+          ##
+          # @return [String] The absolute URL for this resource.
+          def url
+            @properties['url']
+          end
+
+          ##
+          # Fetch a CompositionHookInstance
+          # @return [CompositionHookInstance] Fetched CompositionHookInstance
+          def fetch
+            context.fetch
+          end
+
+          ##
+          # Deletes the CompositionHookInstance
+          # @return [Boolean] true if delete succeeds, true otherwise
+          def delete
+            context.delete
+          end
+
+          ##
+          # Update the CompositionHookInstance
+          # @param [String] friendly_name Friendly name of the Composition Hook to be shown
+          #   in the console.
+          # @param [Boolean] enabled When activated, the Composition Hook is enabled and a
+          #   composition will be triggered for every Video room completed by this account
+          #   from this point onwards; `false` indicates the Composition Hook is left
+          #   inactive.
+          # @param [Hash] video_layout A JSON object defining the video layout of the
+          #   Composition Hook in terms of regions. See the section [Managing Video
+          #   Layouts](#managing-video-layouts) below for further information.
+          # @param [String] audio_sources An array of audio sources to merge. All the
+          #   specified sources must belong to the same Group Room. It can include: 
+          #   * Zero or more Track names. These can be specified using wildcards (e.g.
+          #   `student*`). The use of `[*]` has semantics "all if any" meaning zero or more
+          #   (i.e. all) depending on whether the Group Room had audio tracks.
+          # @param [String] audio_sources_excluded An array of audio sources to exclude from
+          #   the Composition Hook. Any new Composition triggered by the Composition Hook
+          #   shall include all audio sources specified in `AudioSources` except for the ones
+          #   specified in `AudioSourcesExcluded`. This parameter may include: 
+          #   * Zero or more Track names. These can be specified using wildcards (e.g.
+          #   `student*`)
+          # @param [Boolean] trim When activated, clips all the intervals where there is no
+          #   active media in the Compositions triggered by the Composition Hook. This results
+          #   in shorter compositions in cases when the Room was created but no Participant
+          #   joined for some time, or if all the Participants left the room and joined at a
+          #   later stage, as those gaps will be removed. You can find further information in
+          #   the [Managing Video Layouts](#managing-video-layouts) section. Defaults to
+          #   `true`.
+          # @param [composition_hook.Format] format Container format of the Composition
+          #   media files created by the Composition Hook. Can be any of the following: `mp4`,
+          #   `webm`. The use of `mp4` or `webm` makes mandatory the specification of
+          #   `AudioSources` and/or one `VideoLayout` element containing a valid
+          #   `video_sources` list, otherwise an error is fired. Defaults to `webm`.
+          # @param [String] resolution A string representing the numbers of pixels for rows
+          #   (width) and columns (height) of the generated composed video. This string must
+          #   have the format `{width}x{height}`. This parameter must comply with the
+          #   following constraints: 
+          #   * `width >= 16 && width <= 1280`
+          #   * `height >= 16 && height <= 1280`
+          #   * `width * height <= 921,600`
+          #   Typical values are: 
+          #   * HD = `1280x720`
+          #   * PAL = `1024x576`
+          #   * VGA = `640x480`
+          #   * CIF = `320x240`
+          #   Note that the `Resolution` implicitly imposes an aspect ratio to the resulting
+          #   composition. When the original video tracks get constrained by this aspect ratio
+          #   they are scaled-down to fit. You can find detailed information in the [Managing
+          #   Video Layouts](#managing-video-layouts) section. Defaults to `640x480`.
+          # @param [String] status_callback A URL that Twilio sends asynchronous webhook
+          #   requests to on every composition event. If not provided, status callback events
+          #   will not be dispatched.
+          # @param [String] status_callback_method HTTP method Twilio should use when
+          #   requesting the above URL. Defaults to `POST`.
+          # @return [CompositionHookInstance] Updated CompositionHookInstance
+          def update(friendly_name: nil, enabled: :unset, video_layout: :unset, audio_sources: :unset, audio_sources_excluded: :unset, trim: :unset, format: :unset, resolution: :unset, status_callback: :unset, status_callback_method: :unset)
+            context.update(
+                friendly_name: friendly_name,
+                enabled: enabled,
+                video_layout: video_layout,
+                audio_sources: audio_sources,
+                audio_sources_excluded: audio_sources_excluded,
+                trim: trim,
+                format: format,
+                resolution: resolution,
+                status_callback: status_callback,
+                status_callback_method: status_callback_method,
+            )
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            values = @params.map{|k, v| "#{k}: #{v}"}.join(" ")
+            "<Twilio.Video.V1.CompositionHookInstance #{values}>"
+          end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            values = @properties.map{|k, v| "#{k}: #{v}"}.join(" ")
+            "<Twilio.Video.V1.CompositionHookInstance #{values}>"
+          end
+        end
+      end
+    end
+  end
+end