twilio-ruby 5.15.1 → 5.58.1

data/lib/twilio-ruby/rest/autopilot/v1/assistant/webhook.rb

@@ -0,0 +1,420 @@
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /
+#
+# frozen_string_literal: true
+
+module Twilio
+  module REST
+    class Autopilot < Domain
+      class V1 < Version
+        class AssistantContext < InstanceContext
+          ##
+          # 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 WebhookList < ListResource
+            ##
+            # Initialize the WebhookList
+            # @param [Version] version Version that contains the resource
+            # @param [String] assistant_sid The SID of the
+            #   {Assistant}[https://www.twilio.com/docs/autopilot/api/assistant] that is the
+            #   parent of the resource.
+            # @return [WebhookList] WebhookList
+            def initialize(version, assistant_sid: nil)
+              super(version)
+
+              # Path Solution
+              @solution = {assistant_sid: assistant_sid}
+              @uri = "/Assistants/#{@solution[:assistant_sid]}/Webhooks"
+            end
+
+            ##
+            # Lists WebhookInstance records from the API as a list.
+            # Unlike stream(), this operation is eager and will load `limit` records into
+            # memory before returning.
+            # @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(limit: nil, page_size: nil)
+              self.stream(limit: limit, page_size: page_size).entries
+            end
+
+            ##
+            # Streams WebhookInstance records from the API as an Enumerable.
+            # This operation lazily loads records as efficiently as possible until the limit
+            # is reached.
+            # @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(limit: nil, page_size: nil)
+              limits = @version.read_limits(limit, page_size)
+
+              page = self.page(page_size: limits[:page_size], )
+
+              @version.stream(page, limit: limits[:limit], page_limit: limits[:page_limit])
+            end
+
+            ##
+            # When passed a block, yields WebhookInstance 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 WebhookInstance records from the API.
+            # Request is executed immediately.
+            # @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 WebhookInstance
+            def page(page_token: :unset, page_number: :unset, page_size: :unset)
+              params = Twilio::Values.of({
+                  'PageToken' => page_token,
+                  'Page' => page_number,
+                  'PageSize' => page_size,
+              })
+
+              response = @version.page('GET', @uri, params: params)
+
+              WebhookPage.new(@version, response, @solution)
+            end
+
+            ##
+            # Retrieve a single page of WebhookInstance records from the API.
+            # Request is executed immediately.
+            # @param [String] target_url API-generated URL for the requested results page
+            # @return [Page] Page of WebhookInstance
+            def get_page(target_url)
+              response = @version.domain.request(
+                  'GET',
+                  target_url
+              )
+              WebhookPage.new(@version, response, @solution)
+            end
+
+            ##
+            # Create the WebhookInstance
+            # @param [String] unique_name An application-defined string that uniquely
+            #   identifies the new resource. It can be used as an alternative to the `sid` in
+            #   the URL path to address the resource. This value must be unique and 64
+            #   characters or less in length.
+            # @param [String] events The list of space-separated events that this Webhook will
+            #   subscribe to.
+            # @param [String] webhook_url The URL associated with this Webhook.
+            # @param [String] webhook_method The method to be used when calling the webhook's
+            #   URL.
+            # @return [WebhookInstance] Created WebhookInstance
+            def create(unique_name: nil, events: nil, webhook_url: nil, webhook_method: :unset)
+              data = Twilio::Values.of({
+                  'UniqueName' => unique_name,
+                  'Events' => events,
+                  'WebhookUrl' => webhook_url,
+                  'WebhookMethod' => webhook_method,
+              })
+
+              payload = @version.create('POST', @uri, data: data)
+
+              WebhookInstance.new(@version, payload, assistant_sid: @solution[:assistant_sid], )
+            end
+
+            ##
+            # Provide a user friendly representation
+            def to_s
+              '#<Twilio.Autopilot.V1.WebhookList>'
+            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 WebhookPage < Page
+            ##
+            # Initialize the WebhookPage
+            # @param [Version] version Version that contains the resource
+            # @param [Response] response Response from the API
+            # @param [Hash] solution Path solution for the resource
+            # @return [WebhookPage] WebhookPage
+            def initialize(version, response, solution)
+              super(version, response)
+
+              # Path Solution
+              @solution = solution
+            end
+
+            ##
+            # Build an instance of WebhookInstance
+            # @param [Hash] payload Payload response from the API
+            # @return [WebhookInstance] WebhookInstance
+            def get_instance(payload)
+              WebhookInstance.new(@version, payload, assistant_sid: @solution[:assistant_sid], )
+            end
+
+            ##
+            # Provide a user friendly representation
+            def to_s
+              '<Twilio.Autopilot.V1.WebhookPage>'
+            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 WebhookContext < InstanceContext
+            ##
+            # Initialize the WebhookContext
+            # @param [Version] version Version that contains the resource
+            # @param [String] assistant_sid The SID of the
+            #   {Assistant}[https://www.twilio.com/docs/autopilot/api/assistant] that is the
+            #   parent of the resource to fetch.
+            # @param [String] sid The Twilio-provided string that uniquely identifies the
+            #   Webhook resource to fetch.
+            # @return [WebhookContext] WebhookContext
+            def initialize(version, assistant_sid, sid)
+              super(version)
+
+              # Path Solution
+              @solution = {assistant_sid: assistant_sid, sid: sid, }
+              @uri = "/Assistants/#{@solution[:assistant_sid]}/Webhooks/#{@solution[:sid]}"
+            end
+
+            ##
+            # Fetch the WebhookInstance
+            # @return [WebhookInstance] Fetched WebhookInstance
+            def fetch
+              payload = @version.fetch('GET', @uri)
+
+              WebhookInstance.new(
+                  @version,
+                  payload,
+                  assistant_sid: @solution[:assistant_sid],
+                  sid: @solution[:sid],
+              )
+            end
+
+            ##
+            # Update the WebhookInstance
+            # @param [String] unique_name An application-defined string that uniquely
+            #   identifies the new resource. It can be used as an alternative to the `sid` in
+            #   the URL path to address the resource. This value must be unique and 64
+            #   characters or less in length.
+            # @param [String] events The list of space-separated events that this Webhook will
+            #   subscribe to.
+            # @param [String] webhook_url The URL associated with this Webhook.
+            # @param [String] webhook_method The method to be used when calling the webhook's
+            #   URL.
+            # @return [WebhookInstance] Updated WebhookInstance
+            def update(unique_name: :unset, events: :unset, webhook_url: :unset, webhook_method: :unset)
+              data = Twilio::Values.of({
+                  'UniqueName' => unique_name,
+                  'Events' => events,
+                  'WebhookUrl' => webhook_url,
+                  'WebhookMethod' => webhook_method,
+              })
+
+              payload = @version.update('POST', @uri, data: data)
+
+              WebhookInstance.new(
+                  @version,
+                  payload,
+                  assistant_sid: @solution[:assistant_sid],
+                  sid: @solution[:sid],
+              )
+            end
+
+            ##
+            # Delete the WebhookInstance
+            # @return [Boolean] true if delete succeeds, false otherwise
+            def delete
+               @version.delete('DELETE', @uri)
+            end
+
+            ##
+            # Provide a user friendly representation
+            def to_s
+              context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+              "#<Twilio.Autopilot.V1.WebhookContext #{context}>"
+            end
+
+            ##
+            # Provide a detailed, user friendly representation
+            def inspect
+              context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+              "#<Twilio.Autopilot.V1.WebhookContext #{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 WebhookInstance < InstanceResource
+            ##
+            # Initialize the WebhookInstance
+            # @param [Version] version Version that contains the resource
+            # @param [Hash] payload payload that contains response from Twilio
+            # @param [String] assistant_sid The SID of the
+            #   {Assistant}[https://www.twilio.com/docs/autopilot/api/assistant] that is the
+            #   parent of the resource.
+            # @param [String] sid The Twilio-provided string that uniquely identifies the
+            #   Webhook resource to fetch.
+            # @return [WebhookInstance] WebhookInstance
+            def initialize(version, payload, assistant_sid: nil, sid: nil)
+              super(version)
+
+              # Marshaled Properties
+              @properties = {
+                  'url' => payload['url'],
+                  'account_sid' => payload['account_sid'],
+                  'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
+                  'date_updated' => Twilio.deserialize_iso8601_datetime(payload['date_updated']),
+                  'assistant_sid' => payload['assistant_sid'],
+                  'sid' => payload['sid'],
+                  'unique_name' => payload['unique_name'],
+                  'events' => payload['events'],
+                  'webhook_url' => payload['webhook_url'],
+                  'webhook_method' => payload['webhook_method'],
+              }
+
+              # Context
+              @instance_context = nil
+              @params = {'assistant_sid' => assistant_sid, '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 [WebhookContext] WebhookContext for this WebhookInstance
+            def context
+              unless @instance_context
+                @instance_context = WebhookContext.new(@version, @params['assistant_sid'], @params['sid'], )
+              end
+              @instance_context
+            end
+
+            ##
+            # @return [String] The absolute URL of the Webhook resource
+            def url
+              @properties['url']
+            end
+
+            ##
+            # @return [String] The SID of the Account that created the resource
+            def account_sid
+              @properties['account_sid']
+            end
+
+            ##
+            # @return [Time] The RFC 2822 date and time in GMT when the resource was created
+            def date_created
+              @properties['date_created']
+            end
+
+            ##
+            # @return [Time] The RFC 2822 date and time in GMT when the resource was last updated
+            def date_updated
+              @properties['date_updated']
+            end
+
+            ##
+            # @return [String] The SID of the Assistant that is the parent of the resource
+            def assistant_sid
+              @properties['assistant_sid']
+            end
+
+            ##
+            # @return [String] The unique string that identifies the resource
+            def sid
+              @properties['sid']
+            end
+
+            ##
+            # @return [String] An application-defined string that uniquely identifies the resource
+            def unique_name
+              @properties['unique_name']
+            end
+
+            ##
+            # @return [String] The list of space-separated events that this Webhook is subscribed to.
+            def events
+              @properties['events']
+            end
+
+            ##
+            # @return [String] The URL associated with this Webhook.
+            def webhook_url
+              @properties['webhook_url']
+            end
+
+            ##
+            # @return [String] The method used when calling the webhook's URL.
+            def webhook_method
+              @properties['webhook_method']
+            end
+
+            ##
+            # Fetch the WebhookInstance
+            # @return [WebhookInstance] Fetched WebhookInstance
+            def fetch
+              context.fetch
+            end
+
+            ##
+            # Update the WebhookInstance
+            # @param [String] unique_name An application-defined string that uniquely
+            #   identifies the new resource. It can be used as an alternative to the `sid` in
+            #   the URL path to address the resource. This value must be unique and 64
+            #   characters or less in length.
+            # @param [String] events The list of space-separated events that this Webhook will
+            #   subscribe to.
+            # @param [String] webhook_url The URL associated with this Webhook.
+            # @param [String] webhook_method The method to be used when calling the webhook's
+            #   URL.
+            # @return [WebhookInstance] Updated WebhookInstance
+            def update(unique_name: :unset, events: :unset, webhook_url: :unset, webhook_method: :unset)
+              context.update(
+                  unique_name: unique_name,
+                  events: events,
+                  webhook_url: webhook_url,
+                  webhook_method: webhook_method,
+              )
+            end
+
+            ##
+            # Delete the WebhookInstance
+            # @return [Boolean] true if delete succeeds, false otherwise
+            def delete
+              context.delete
+            end
+
+            ##
+            # Provide a user friendly representation
+            def to_s
+              values = @params.map{|k, v| "#{k}: #{v}"}.join(" ")
+              "<Twilio.Autopilot.V1.WebhookInstance #{values}>"
+            end
+
+            ##
+            # Provide a detailed, user friendly representation
+            def inspect
+              values = @properties.map{|k, v| "#{k}: #{v}"}.join(" ")
+              "<Twilio.Autopilot.V1.WebhookInstance #{values}>"
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/twilio-ruby/rest/autopilot/v1/assistant.rb

@@ -3,7 +3,7 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
-# 
+#
 # frozen_string_literal: true
 
 module Twilio
@@ -86,11 +86,9 @@ module Twilio
                 'Page' => page_number,
                 'PageSize' => page_size,
             })
-            response = @version.page(
-                'GET',
-                @uri,
-                params
-            )
+
+            response = @version.page('GET', @uri, params: params)
+
             AssistantPage.new(@version, response, @solution)
           end
 
@@ -108,22 +106,23 @@ module Twilio
           end
 
           ##
-          # Retrieve a single page of AssistantInstance records from the API.
-          # Request is executed immediately.
-          # @param [String] friendly_name A text description for the Assistant. It is
-          #   non-unique and can be up to 255 characters long.
-          # @param [Boolean] log_queries A boolean that specifies whether queries should be
-          #   logged for 30 days further training. If false, no queries will be stored, if
-          #   true, queries will be stored for 30 days and deleted thereafter. Defaults to
-          #   true if no value is provided.
-          # @param [String] unique_name A user-provided string that uniquely identifies this
-          #   resource as an alternative to the sid. Unique up to 64 characters long.
-          # @param [String] callback_url The callback_url
-          # @param [String] callback_events The callback_events
-          # @param [Hash] style_sheet A JSON object that defines the assistant style sheet
-          # @param [Hash] defaults A JSON object that defines the assistant's default tasks
-          #   for various scenarios
-          # @return [AssistantInstance] Newly created AssistantInstance
+          # Create the AssistantInstance
+          # @param [String] friendly_name A descriptive string that you create to describe
+          #   the new resource. It is not unique and can be up to 255 characters long.
+          # @param [Boolean] log_queries Whether queries should be logged and kept after
+          #   training. Can be: `true` or `false` and defaults to `true`. If `true`, queries
+          #   are stored for 30 days, and then deleted. If `false`, no queries are stored.
+          # @param [String] unique_name An application-defined string that uniquely
+          #   identifies the new resource. It can be used as an alternative to the `sid` in
+          #   the URL path to address the resource. The first 64 characters must be unique.
+          # @param [String] callback_url Reserved.
+          # @param [String] callback_events Reserved.
+          # @param [Hash] style_sheet The JSON string that defines the Assistant's {style
+          #   sheet}[https://www.twilio.com/docs/autopilot/api/assistant/stylesheet]
+          # @param [Hash] defaults A JSON object that defines the Assistant's {default
+          #   tasks}[https://www.twilio.com/docs/autopilot/api/assistant/defaults] for various
+          #   scenarios, including initiation actions and fallback tasks.
+          # @return [AssistantInstance] Created AssistantInstance
           def create(friendly_name: :unset, log_queries: :unset, unique_name: :unset, callback_url: :unset, callback_events: :unset, style_sheet: :unset, defaults: :unset)
             data = Twilio::Values.of({
                 'FriendlyName' => friendly_name,
@@ -135,11 +134,7 @@ module Twilio
                 'Defaults' => Twilio.serialize_object(defaults),
             })
 
-            payload = @version.create(
-                'POST',
-                @uri,
-                data: data
-            )
+            payload = @version.create('POST', @uri, data: data)
 
             AssistantInstance.new(@version, payload, )
           end
@@ -188,7 +183,8 @@ module Twilio
           ##
           # Initialize the AssistantContext
           # @param [Version] version Version that contains the resource
-          # @param [String] sid The sid
+          # @param [String] sid The Twilio-provided string that uniquely identifies the
+          #   Assistant resource to fetch.
           # @return [AssistantContext] AssistantContext
           def initialize(version, sid)
             super(version)
@@ -205,40 +201,39 @@ module Twilio
             @style_sheet = nil
             @defaults = nil
             @dialogues = nil
+            @webhooks = nil
           end
 
           ##
-          # Fetch a AssistantInstance
+          # Fetch the AssistantInstance
           # @return [AssistantInstance] Fetched AssistantInstance
           def fetch
-            params = Twilio::Values.of({})
-
-            payload = @version.fetch(
-                'GET',
-                @uri,
-                params,
-            )
+            payload = @version.fetch('GET', @uri)
 
             AssistantInstance.new(@version, payload, sid: @solution[:sid], )
           end
 
           ##
           # Update the AssistantInstance
-          # @param [String] friendly_name A text description for the Assistant. It is
-          #   non-unique and can be up to 255 characters long.
-          # @param [Boolean] log_queries A boolean that specifies whether queries should be
-          #   logged for 30 days further training. If false, no queries will be stored, if
-          #   true, queries will be stored for 30 days and deleted thereafter. Defaults to
-          #   true if no value is provided.
-          # @param [String] unique_name A user-provided string that uniquely identifies this
-          #   resource as an alternative to the sid. Unique up to 64 characters long.
-          # @param [String] callback_url The callback_url
-          # @param [String] callback_events The callback_events
-          # @param [Hash] style_sheet A JSON object that defines the assistant style sheet
-          # @param [Hash] defaults A JSON object that defines the assistant's default tasks
-          #   for various scenarios
+          # @param [String] friendly_name A descriptive string that you create to describe
+          #   the resource. It is not unique and can be up to 255 characters long.
+          # @param [Boolean] log_queries Whether queries should be logged and kept after
+          #   training. Can be: `true` or `false` and defaults to `true`. If `true`, queries
+          #   are stored for 30 days, and then deleted. If `false`, no queries are stored.
+          # @param [String] unique_name An application-defined string that uniquely
+          #   identifies the resource. It can be used as an alternative to the `sid` in the
+          #   URL path to address the resource. The first 64 characters must be unique.
+          # @param [String] callback_url Reserved.
+          # @param [String] callback_events Reserved.
+          # @param [Hash] style_sheet The JSON string that defines the Assistant's {style
+          #   sheet}[https://www.twilio.com/docs/autopilot/api/assistant/stylesheet]
+          # @param [Hash] defaults A JSON object that defines the Assistant's {default
+          #   tasks}[https://www.twilio.com/docs/autopilot/api/assistant/defaults] for various
+          #   scenarios, including initiation actions and fallback tasks.
+          # @param [String] development_stage A string describing the state of the
+          #   assistant.
           # @return [AssistantInstance] Updated AssistantInstance
-          def update(friendly_name: :unset, log_queries: :unset, unique_name: :unset, callback_url: :unset, callback_events: :unset, style_sheet: :unset, defaults: :unset)
+          def update(friendly_name: :unset, log_queries: :unset, unique_name: :unset, callback_url: :unset, callback_events: :unset, style_sheet: :unset, defaults: :unset, development_stage: :unset)
             data = Twilio::Values.of({
                 'FriendlyName' => friendly_name,
                 'LogQueries' => log_queries,
@@ -247,22 +242,19 @@ module Twilio
                 'CallbackEvents' => callback_events,
                 'StyleSheet' => Twilio.serialize_object(style_sheet),
                 'Defaults' => Twilio.serialize_object(defaults),
+                'DevelopmentStage' => development_stage,
             })
 
-            payload = @version.update(
-                'POST',
-                @uri,
-                data: data,
-            )
+            payload = @version.update('POST', @uri, data: data)
 
             AssistantInstance.new(@version, payload, sid: @solution[:sid], )
           end
 
           ##
-          # Deletes the AssistantInstance
-          # @return [Boolean] true if delete succeeds, true otherwise
+          # Delete the AssistantInstance
+          # @return [Boolean] true if delete succeeds, false otherwise
           def delete
-            @version.delete('delete', @uri)
+             @version.delete('DELETE', @uri)
           end
 
           ##
@@ -371,12 +363,37 @@ module Twilio
             @dialogues
           end
 
+          ##
+          # Access the webhooks
+          # @return [WebhookList]
+          # @return [WebhookContext] if sid was passed.
+          def webhooks(sid=:unset)
+            raise ArgumentError, 'sid cannot be nil' if sid.nil?
+
+            if sid != :unset
+              return WebhookContext.new(@version, @solution[:sid], sid, )
+            end
+
+            unless @webhooks
+              @webhooks = WebhookList.new(@version, assistant_sid: @solution[:sid], )
+            end
+
+            @webhooks
+          end
+
           ##
           # Provide a user friendly representation
           def to_s
             context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
             "#<Twilio.Autopilot.V1.AssistantContext #{context}>"
           end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+            "#<Twilio.Autopilot.V1.AssistantContext #{context}>"
+          end
         end
 
         ##
@@ -386,7 +403,8 @@ module Twilio
           # Initialize the AssistantInstance
           # @param [Version] version Version that contains the resource
           # @param [Hash] payload payload that contains response from Twilio
-          # @param [String] sid The sid
+          # @param [String] sid The Twilio-provided string that uniquely identifies the
+          #   Assistant resource to fetch.
           # @return [AssistantInstance] AssistantInstance
           def initialize(version, payload, sid: nil)
             super(version)
@@ -400,6 +418,8 @@ module Twilio
                 'latest_model_build_sid' => payload['latest_model_build_sid'],
                 'links' => payload['links'],
                 'log_queries' => payload['log_queries'],
+                'development_stage' => payload['development_stage'],
+                'needs_model_build' => payload['needs_model_build'],
                 'sid' => payload['sid'],
                 'unique_name' => payload['unique_name'],
                 'url' => payload['url'],
@@ -424,79 +444,91 @@ module Twilio
           end
 
           ##
-          # @return [String] The unique ID of the Account that created this Assistant.
+          # @return [String] The SID of the Account that created the resource
           def account_sid
             @properties['account_sid']
           end
 
           ##
-          # @return [Time] The date that this resource was created
+          # @return [Time] The RFC 2822 date and time in GMT when the resource was created
           def date_created
             @properties['date_created']
           end
 
           ##
-          # @return [Time] The date that this resource was last updated
+          # @return [Time] The RFC 2822 date and time in GMT when the resource was last updated
           def date_updated
             @properties['date_updated']
           end
 
           ##
-          # @return [String] A text description for the Assistant. It is non-unique and can be up to 255 characters long.
+          # @return [String] The string that you assigned to describe the resource
           def friendly_name
             @properties['friendly_name']
           end
 
           ##
-          # @return [String] The unique ID (Sid) of the latest model build. Null if no model has been built.
+          # @return [String] Reserved
           def latest_model_build_sid
             @properties['latest_model_build_sid']
           end
 
           ##
-          # @return [String] The links
+          # @return [String] A list of the URLs of the Assistant's related resources
           def links
             @properties['links']
           end
 
           ##
-          # @return [Boolean] A boolean that specifies whether queries should be logged for 30 days further training. If false, no queries will be stored, if true, queries will be stored for 30 days and deleted thereafter.
+          # @return [Boolean] Whether queries should be logged and kept after training
           def log_queries
             @properties['log_queries']
           end
 
           ##
-          # @return [String] A 34 character string that uniquely identifies this resource.
+          # @return [String] A string describing the state of the assistant.
+          def development_stage
+            @properties['development_stage']
+          end
+
+          ##
+          # @return [Boolean] Whether model needs to be rebuilt
+          def needs_model_build
+            @properties['needs_model_build']
+          end
+
+          ##
+          # @return [String] The unique string that identifies the resource
           def sid
             @properties['sid']
           end
 
           ##
-          # @return [String] A user-provided string that uniquely identifies this resource as an alternative to the sid. You can use the unique name in the URL path. Unique up to 64 characters long.
+          # @return [String] An application-defined string that uniquely identifies the resource
           def unique_name
             @properties['unique_name']
           end
 
           ##
-          # @return [String] The url
+          # @return [String] The absolute URL of the Assistant resource
           def url
             @properties['url']
           end
 
           ##
-          # @return [String] The callback_url
+          # @return [String] Reserved
           def callback_url
             @properties['callback_url']
           end
 
           ##
-          # @return [String] The callback_events
+          # @return [String] Reserved
           def callback_events
             @properties['callback_events']
           end
 
           ##
-          # Fetch a AssistantInstance
+          # Fetch the AssistantInstance
           # @return [AssistantInstance] Fetched AssistantInstance
           def fetch
             context.fetch
@@ -504,21 +536,25 @@ module Twilio
 
           ##
           # Update the AssistantInstance
-          # @param [String] friendly_name A text description for the Assistant. It is
-          #   non-unique and can be up to 255 characters long.
-          # @param [Boolean] log_queries A boolean that specifies whether queries should be
-          #   logged for 30 days further training. If false, no queries will be stored, if
-          #   true, queries will be stored for 30 days and deleted thereafter. Defaults to
-          #   true if no value is provided.
-          # @param [String] unique_name A user-provided string that uniquely identifies this
-          #   resource as an alternative to the sid. Unique up to 64 characters long.
-          # @param [String] callback_url The callback_url
-          # @param [String] callback_events The callback_events
-          # @param [Hash] style_sheet A JSON object that defines the assistant style sheet
-          # @param [Hash] defaults A JSON object that defines the assistant's default tasks
-          #   for various scenarios
+          # @param [String] friendly_name A descriptive string that you create to describe
+          #   the resource. It is not unique and can be up to 255 characters long.
+          # @param [Boolean] log_queries Whether queries should be logged and kept after
+          #   training. Can be: `true` or `false` and defaults to `true`. If `true`, queries
+          #   are stored for 30 days, and then deleted. If `false`, no queries are stored.
+          # @param [String] unique_name An application-defined string that uniquely
+          #   identifies the resource. It can be used as an alternative to the `sid` in the
+          #   URL path to address the resource. The first 64 characters must be unique.
+          # @param [String] callback_url Reserved.
+          # @param [String] callback_events Reserved.
+          # @param [Hash] style_sheet The JSON string that defines the Assistant's {style
+          #   sheet}[https://www.twilio.com/docs/autopilot/api/assistant/stylesheet]
+          # @param [Hash] defaults A JSON object that defines the Assistant's {default
+          #   tasks}[https://www.twilio.com/docs/autopilot/api/assistant/defaults] for various
+          #   scenarios, including initiation actions and fallback tasks.
+          # @param [String] development_stage A string describing the state of the
+          #   assistant.
           # @return [AssistantInstance] Updated AssistantInstance
-          def update(friendly_name: :unset, log_queries: :unset, unique_name: :unset, callback_url: :unset, callback_events: :unset, style_sheet: :unset, defaults: :unset)
+          def update(friendly_name: :unset, log_queries: :unset, unique_name: :unset, callback_url: :unset, callback_events: :unset, style_sheet: :unset, defaults: :unset, development_stage: :unset)
             context.update(
                 friendly_name: friendly_name,
                 log_queries: log_queries,
@@ -527,12 +563,13 @@ module Twilio
                 callback_events: callback_events,
                 style_sheet: style_sheet,
                 defaults: defaults,
+                development_stage: development_stage,
             )
           end
 
           ##
-          # Deletes the AssistantInstance
-          # @return [Boolean] true if delete succeeds, true otherwise
+          # Delete the AssistantInstance
+          # @return [Boolean] true if delete succeeds, false otherwise
           def delete
             context.delete
           end
@@ -586,6 +623,13 @@ module Twilio
             context.dialogues
           end
 
+          ##
+          # Access the webhooks
+          # @return [webhooks] webhooks
+          def webhooks
+            context.webhooks
+          end
+
           ##
           # Provide a user friendly representation
           def to_s