ibm_watson 0.16.1 → 0.17.0

data/lib/ibm_watson/assistant_v1.rb

@@ -15,7 +15,7 @@
 # limitations under the License.
 
 # The IBM Watson™ Assistant service combines machine learning, natural language
-# understanding, and integrated dialog tools to create conversation flows between your
+# understanding, and an integrated dialog editor to create conversation flows between your
 # apps and your users.
 
 require "concurrent"
@@ -47,16 +47,16 @@ module IBMWatson
     #   ready for a later version.
     # @option args url [String] The base url to use when contacting the service (e.g.
     #   "https://gateway.watsonplatform.net/assistant/api").
-    #   The base url may differ between Bluemix regions.
+    #   The base url may differ between IBM Cloud regions.
     # @option args username [String] The username used to authenticate with the service.
     #   Username and password credentials are only required to run your
-    #   application locally or outside of Bluemix. When running on
-    #   Bluemix, the credentials will be automatically loaded from the
+    #   application locally or outside of IBM Cloud. When running on
+    #   IBM Cloud, the credentials will be automatically loaded from the
     #   `VCAP_SERVICES` environment variable.
     # @option args password [String] The password used to authenticate with the service.
     #   Username and password credentials are only required to run your
-    #   application locally or outside of Bluemix. When running on
-    #   Bluemix, the credentials will be automatically loaded from the
+    #   application locally or outside of IBM Cloud. When running on
+    #   IBM Cloud, the credentials will be automatically loaded from the
     #   `VCAP_SERVICES` environment variable.
     # @option args iam_apikey [String] An API key that can be used to request IAM tokens. If
     #   this API key is provided, the SDK will manage the token and handle the
@@ -66,7 +66,9 @@ module IBMWatson
     #   it expires or reactively upon receiving a 401 from the service as any requests
     #   made with an expired token will fail.
     # @option args iam_url [String] An optional URL for the IAM service API. Defaults to
-    #   'https://iam.ng.bluemix.net/identity/token'.
+    #   'https://iam.cloud.ibm.com/identity/token'.
+    # @option args iam_client_id [String] An optional client id for the IAM service API.
+    # @option args iam_client_secret [String] An optional client secret for the IAM service API.
     def initialize(args = {})
       @__async_initialized__ = false
       defaults = {}
@@ -77,6 +79,8 @@ module IBMWatson
       defaults[:iam_apikey] = nil
       defaults[:iam_access_token] = nil
       defaults[:iam_url] = nil
+      defaults[:iam_client_id] = nil
+      defaults[:iam_client_secret] = nil
       args = defaults.merge(args)
       args[:vcap_services_name] = "conversation"
       super
@@ -149,6 +153,48 @@ module IBMWatson
     # Workspaces
     #########################
 
+    ##
+    # @!method list_workspaces(page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
+    # List workspaces.
+    # List the workspaces associated with a Watson Assistant service instance.
+    #
+    #   This operation is limited to 500 requests per 30 minutes. For more information,
+    #   see **Rate limiting**.
+    # @param page_limit [Fixnum] The number of records to return in each page of results.
+    # @param include_count [Boolean] Whether to include information about the number of records returned.
+    # @param sort [String] The attribute by which returned workspaces will be sorted. To reverse the sort
+    #   order, prefix the value with a minus sign (`-`).
+    # @param cursor [String] A token identifying the page of results to retrieve.
+    # @param include_audit [Boolean] Whether to include the audit properties (`created` and `updated` timestamps) in
+    #   the response.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def list_workspaces(page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "list_workspaces")
+      headers.merge!(sdk_headers)
+
+      params = {
+        "version" => @version,
+        "page_limit" => page_limit,
+        "include_count" => include_count,
+        "sort" => sort,
+        "cursor" => cursor,
+        "include_audit" => include_audit
+      }
+
+      method_url = "/v1/workspaces"
+
+      response = request(
+        method: "GET",
+        url: method_url,
+        headers: headers,
+        params: params,
+        accept_json: true
+      )
+      response
+    end
+
     ##
     # @!method create_workspace(name: nil, description: nil, language: nil, metadata: nil, learning_opt_out: nil, system_settings: nil, intents: nil, entities: nil, dialog_nodes: nil, counterexamples: nil)
     # Create workspace.
@@ -158,9 +204,9 @@ module IBMWatson
     #   This operation is limited to 30 requests per 30 minutes. For more information, see
     #   **Rate limiting**.
     # @param name [String] The name of the workspace. This string cannot contain carriage return, newline, or
-    #   tab characters, and it must be no longer than 64 characters.
+    #   tab characters.
     # @param description [String] The description of the workspace. This string cannot contain carriage return,
-    #   newline, or tab characters, and it must be no longer than 128 characters.
+    #   newline, or tab characters.
     # @param language [String] The language of the workspace.
     # @param metadata [Hash] Any metadata related to the workspace.
     # @param learning_opt_out [Boolean] Whether training data from the workspace (including artifacts such as intents and
@@ -209,39 +255,6 @@ module IBMWatson
       response
     end
 
-    ##
-    # @!method delete_workspace(workspace_id:)
-    # Delete workspace.
-    # Delete a workspace from the service instance.
-    #
-    #   This operation is limited to 30 requests per 30 minutes. For more information, see
-    #   **Rate limiting**.
-    # @param workspace_id [String] Unique identifier of the workspace.
-    # @return [nil]
-    def delete_workspace(workspace_id:)
-      raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
-
-      headers = {
-      }
-      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "delete_workspace")
-      headers.merge!(sdk_headers)
-
-      params = {
-        "version" => @version
-      }
-
-      method_url = "/v1/workspaces/%s" % [ERB::Util.url_encode(workspace_id)]
-
-      request(
-        method: "DELETE",
-        url: method_url,
-        headers: headers,
-        params: params,
-        accept_json: true
-      )
-      nil
-    end
-
     ##
     # @!method get_workspace(workspace_id:, export: nil, include_audit: nil, sort: nil)
     # Get information about a workspace.
@@ -287,48 +300,6 @@ module IBMWatson
       response
     end
 
-    ##
-    # @!method list_workspaces(page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
-    # List workspaces.
-    # List the workspaces associated with a Watson Assistant service instance.
-    #
-    #   This operation is limited to 500 requests per 30 minutes. For more information,
-    #   see **Rate limiting**.
-    # @param page_limit [Fixnum] The number of records to return in each page of results.
-    # @param include_count [Boolean] Whether to include information about the number of records returned.
-    # @param sort [String] The attribute by which returned workspaces will be sorted. To reverse the sort
-    #   order, prefix the value with a minus sign (`-`).
-    # @param cursor [String] A token identifying the page of results to retrieve.
-    # @param include_audit [Boolean] Whether to include the audit properties (`created` and `updated` timestamps) in
-    #   the response.
-    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def list_workspaces(page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
-      headers = {
-      }
-      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "list_workspaces")
-      headers.merge!(sdk_headers)
-
-      params = {
-        "version" => @version,
-        "page_limit" => page_limit,
-        "include_count" => include_count,
-        "sort" => sort,
-        "cursor" => cursor,
-        "include_audit" => include_audit
-      }
-
-      method_url = "/v1/workspaces"
-
-      response = request(
-        method: "GET",
-        url: method_url,
-        headers: headers,
-        params: params,
-        accept_json: true
-      )
-      response
-    end
-
     ##
     # @!method update_workspace(workspace_id:, name: nil, description: nil, language: nil, metadata: nil, learning_opt_out: nil, system_settings: nil, intents: nil, entities: nil, dialog_nodes: nil, counterexamples: nil, append: nil)
     # Update workspace.
@@ -339,9 +310,9 @@ module IBMWatson
     #   **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
     # @param name [String] The name of the workspace. This string cannot contain carriage return, newline, or
-    #   tab characters, and it must be no longer than 64 characters.
+    #   tab characters.
     # @param description [String] The description of the workspace. This string cannot contain carriage return,
-    #   newline, or tab characters, and it must be no longer than 128 characters.
+    #   newline, or tab characters.
     # @param language [String] The language of the workspace.
     # @param metadata [Hash] Any metadata related to the workspace.
     # @param learning_opt_out [Boolean] Whether training data from the workspace (including artifacts such as intents and
@@ -401,94 +372,143 @@ module IBMWatson
       )
       response
     end
+
+    ##
+    # @!method delete_workspace(workspace_id:)
+    # Delete workspace.
+    # Delete a workspace from the service instance.
+    #
+    #   This operation is limited to 30 requests per 30 minutes. For more information, see
+    #   **Rate limiting**.
+    # @param workspace_id [String] Unique identifier of the workspace.
+    # @return [nil]
+    def delete_workspace(workspace_id:)
+      raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "delete_workspace")
+      headers.merge!(sdk_headers)
+
+      params = {
+        "version" => @version
+      }
+
+      method_url = "/v1/workspaces/%s" % [ERB::Util.url_encode(workspace_id)]
+
+      request(
+        method: "DELETE",
+        url: method_url,
+        headers: headers,
+        params: params,
+        accept_json: true
+      )
+      nil
+    end
     #########################
     # Intents
     #########################
 
     ##
-    # @!method create_intent(workspace_id:, intent:, description: nil, examples: nil)
-    # Create intent.
-    # Create a new intent.
+    # @!method list_intents(workspace_id:, export: nil, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
+    # List intents.
+    # List the intents for a workspace.
     #
-    #   This operation is limited to 2000 requests per 30 minutes. For more information,
-    #   see **Rate limiting**.
+    #   With **export**=`false`, this operation is limited to 2000 requests per 30
+    #   minutes. With **export**=`true`, the limit is 400 requests per 30 minutes. For
+    #   more information, see **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
-    # @param intent [String] The name of the intent. This string must conform to the following restrictions:
-    #   - It can contain only Unicode alphanumeric, underscore, hyphen, and dot
-    #   characters.
-    #   - It cannot begin with the reserved prefix `sys-`.
-    #   - It must be no longer than 128 characters.
-    # @param description [String] The description of the intent. This string cannot contain carriage return,
-    #   newline, or tab characters, and it must be no longer than 128 characters.
-    # @param examples [Array[Example]] An array of user input examples for the intent.
+    # @param export [Boolean] Whether to include all element content in the returned data. If
+    #   **export**=`false`, the returned data includes only information about the element
+    #   itself. If **export**=`true`, all content, including subelements, is included.
+    # @param page_limit [Fixnum] The number of records to return in each page of results.
+    # @param include_count [Boolean] Whether to include information about the number of records returned.
+    # @param sort [String] The attribute by which returned intents will be sorted. To reverse the sort order,
+    #   prefix the value with a minus sign (`-`).
+    # @param cursor [String] A token identifying the page of results to retrieve.
+    # @param include_audit [Boolean] Whether to include the audit properties (`created` and `updated` timestamps) in
+    #   the response.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def create_intent(workspace_id:, intent:, description: nil, examples: nil)
+    def list_intents(workspace_id:, export: nil, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
       raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
 
-      raise ArgumentError.new("intent must be provided") if intent.nil?
-
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "create_intent")
+      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "list_intents")
       headers.merge!(sdk_headers)
 
       params = {
-        "version" => @version
-      }
-
-      data = {
-        "intent" => intent,
-        "description" => description,
-        "examples" => examples
+        "version" => @version,
+        "export" => export,
+        "page_limit" => page_limit,
+        "include_count" => include_count,
+        "sort" => sort,
+        "cursor" => cursor,
+        "include_audit" => include_audit
       }
 
       method_url = "/v1/workspaces/%s/intents" % [ERB::Util.url_encode(workspace_id)]
 
       response = request(
-        method: "POST",
+        method: "GET",
         url: method_url,
         headers: headers,
         params: params,
-        json: data,
         accept_json: true
       )
       response
     end
 
     ##
-    # @!method delete_intent(workspace_id:, intent:)
-    # Delete intent.
-    # Delete an intent from a workspace.
+    # @!method create_intent(workspace_id:, intent:, description: nil, examples: nil)
+    # Create intent.
+    # Create a new intent.
+    #
+    #   If you want to create multiple intents with a single API call, consider using the
+    #   **[Update workspace](#update-workspace)** method instead.
     #
     #   This operation is limited to 2000 requests per 30 minutes. For more information,
     #   see **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
-    # @param intent [String] The intent name.
-    # @return [nil]
-    def delete_intent(workspace_id:, intent:)
+    # @param intent [String] The name of the intent. This string must conform to the following restrictions:
+    #   - It can contain only Unicode alphanumeric, underscore, hyphen, and dot
+    #   characters.
+    #   - It cannot begin with the reserved prefix `sys-`.
+    # @param description [String] The description of the intent. This string cannot contain carriage return,
+    #   newline, or tab characters.
+    # @param examples [Array[Example]] An array of user input examples for the intent.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def create_intent(workspace_id:, intent:, description: nil, examples: nil)
       raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
 
       raise ArgumentError.new("intent must be provided") if intent.nil?
 
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "delete_intent")
+      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "create_intent")
       headers.merge!(sdk_headers)
 
       params = {
         "version" => @version
       }
 
-      method_url = "/v1/workspaces/%s/intents/%s" % [ERB::Util.url_encode(workspace_id), ERB::Util.url_encode(intent)]
+      data = {
+        "intent" => intent,
+        "description" => description,
+        "examples" => examples
+      }
 
-      request(
-        method: "DELETE",
+      method_url = "/v1/workspaces/%s/intents" % [ERB::Util.url_encode(workspace_id)]
+
+      response = request(
+        method: "POST",
         url: method_url,
         headers: headers,
         params: params,
+        json: data,
         accept_json: true
       )
-      nil
+      response
     end
 
     ##
@@ -536,72 +556,24 @@ module IBMWatson
     end
 
     ##
-    # @!method list_intents(workspace_id:, export: nil, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
-    # List intents.
-    # List the intents for a workspace.
+    # @!method update_intent(workspace_id:, intent:, new_intent: nil, new_description: nil, new_examples: nil)
+    # Update intent.
+    # Update an existing intent with new or modified data. You must provide component
+    #   objects defining the content of the updated intent.
     #
-    #   With **export**=`false`, this operation is limited to 2000 requests per 30
-    #   minutes. With **export**=`true`, the limit is 400 requests per 30 minutes. For
-    #   more information, see **Rate limiting**.
-    # @param workspace_id [String] Unique identifier of the workspace.
-    # @param export [Boolean] Whether to include all element content in the returned data. If
-    #   **export**=`false`, the returned data includes only information about the element
-    #   itself. If **export**=`true`, all content, including subelements, is included.
-    # @param page_limit [Fixnum] The number of records to return in each page of results.
-    # @param include_count [Boolean] Whether to include information about the number of records returned.
-    # @param sort [String] The attribute by which returned intents will be sorted. To reverse the sort order,
-    #   prefix the value with a minus sign (`-`).
-    # @param cursor [String] A token identifying the page of results to retrieve.
-    # @param include_audit [Boolean] Whether to include the audit properties (`created` and `updated` timestamps) in
-    #   the response.
-    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def list_intents(workspace_id:, export: nil, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
-      raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
-
-      headers = {
-      }
-      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "list_intents")
-      headers.merge!(sdk_headers)
-
-      params = {
-        "version" => @version,
-        "export" => export,
-        "page_limit" => page_limit,
-        "include_count" => include_count,
-        "sort" => sort,
-        "cursor" => cursor,
-        "include_audit" => include_audit
-      }
-
-      method_url = "/v1/workspaces/%s/intents" % [ERB::Util.url_encode(workspace_id)]
-
-      response = request(
-        method: "GET",
-        url: method_url,
-        headers: headers,
-        params: params,
-        accept_json: true
-      )
-      response
-    end
-
-    ##
-    # @!method update_intent(workspace_id:, intent:, new_intent: nil, new_description: nil, new_examples: nil)
-    # Update intent.
-    # Update an existing intent with new or modified data. You must provide component
-    #   objects defining the content of the updated intent.
-    #
-    #   This operation is limited to 2000 requests per 30 minutes. For more information,
-    #   see **Rate limiting**.
+    #   If you want to update multiple intents with a single API call, consider using the
+    #   **[Update workspace](#update-workspace)** method instead.
+    #
+    #   This operation is limited to 2000 requests per 30 minutes. For more information,
+    #   see **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
     # @param intent [String] The intent name.
     # @param new_intent [String] The name of the intent. This string must conform to the following restrictions:
     #   - It can contain only Unicode alphanumeric, underscore, hyphen, and dot
     #   characters.
     #   - It cannot begin with the reserved prefix `sys-`.
-    #   - It must be no longer than 128 characters.
     # @param new_description [String] The description of the intent. This string cannot contain carriage return,
-    #   newline, or tab characters, and it must be no longer than 128 characters.
+    #   newline, or tab characters.
     # @param new_examples [Array[Example]] An array of user input examples for the intent.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def update_intent(workspace_id:, intent:, new_intent: nil, new_description: nil, new_examples: nil)
@@ -636,113 +608,114 @@ module IBMWatson
       )
       response
     end
-    #########################
-    # Examples
-    #########################
 
     ##
-    # @!method create_example(workspace_id:, intent:, text:, mentions: nil)
-    # Create user input example.
-    # Add a new user input example to an intent.
+    # @!method delete_intent(workspace_id:, intent:)
+    # Delete intent.
+    # Delete an intent from a workspace.
     #
-    #   This operation is limited to 1000 requests per 30 minutes. For more information,
+    #   This operation is limited to 2000 requests per 30 minutes. For more information,
     #   see **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
     # @param intent [String] The intent name.
-    # @param text [String] The text of a user input example. This string must conform to the following
-    #   restrictions:
-    #   - It cannot contain carriage return, newline, or tab characters.
-    #   - It cannot consist of only whitespace characters.
-    #   - It must be no longer than 1024 characters.
-    # @param mentions [Array[Mention]] An array of contextual entity mentions.
-    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def create_example(workspace_id:, intent:, text:, mentions: nil)
+    # @return [nil]
+    def delete_intent(workspace_id:, intent:)
       raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
 
       raise ArgumentError.new("intent must be provided") if intent.nil?
 
-      raise ArgumentError.new("text must be provided") if text.nil?
-
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "create_example")
+      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "delete_intent")
       headers.merge!(sdk_headers)
 
       params = {
         "version" => @version
       }
 
-      data = {
-        "text" => text,
-        "mentions" => mentions
-      }
-
-      method_url = "/v1/workspaces/%s/intents/%s/examples" % [ERB::Util.url_encode(workspace_id), ERB::Util.url_encode(intent)]
+      method_url = "/v1/workspaces/%s/intents/%s" % [ERB::Util.url_encode(workspace_id), ERB::Util.url_encode(intent)]
 
-      response = request(
-        method: "POST",
+      request(
+        method: "DELETE",
         url: method_url,
         headers: headers,
         params: params,
-        json: data,
         accept_json: true
       )
-      response
+      nil
     end
+    #########################
+    # Examples
+    #########################
 
     ##
-    # @!method delete_example(workspace_id:, intent:, text:)
-    # Delete user input example.
-    # Delete a user input example from an intent.
+    # @!method list_examples(workspace_id:, intent:, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
+    # List user input examples.
+    # List the user input examples for an intent, optionally including contextual entity
+    #   mentions.
     #
-    #   This operation is limited to 1000 requests per 30 minutes. For more information,
+    #   This operation is limited to 2500 requests per 30 minutes. For more information,
     #   see **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
     # @param intent [String] The intent name.
-    # @param text [String] The text of the user input example.
-    # @return [nil]
-    def delete_example(workspace_id:, intent:, text:)
+    # @param page_limit [Fixnum] The number of records to return in each page of results.
+    # @param include_count [Boolean] Whether to include information about the number of records returned.
+    # @param sort [String] The attribute by which returned examples will be sorted. To reverse the sort
+    #   order, prefix the value with a minus sign (`-`).
+    # @param cursor [String] A token identifying the page of results to retrieve.
+    # @param include_audit [Boolean] Whether to include the audit properties (`created` and `updated` timestamps) in
+    #   the response.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def list_examples(workspace_id:, intent:, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
       raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
 
       raise ArgumentError.new("intent must be provided") if intent.nil?
 
-      raise ArgumentError.new("text must be provided") if text.nil?
-
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "delete_example")
+      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "list_examples")
       headers.merge!(sdk_headers)
 
       params = {
-        "version" => @version
+        "version" => @version,
+        "page_limit" => page_limit,
+        "include_count" => include_count,
+        "sort" => sort,
+        "cursor" => cursor,
+        "include_audit" => include_audit
       }
 
-      method_url = "/v1/workspaces/%s/intents/%s/examples/%s" % [ERB::Util.url_encode(workspace_id), ERB::Util.url_encode(intent), ERB::Util.url_encode(text)]
+      method_url = "/v1/workspaces/%s/intents/%s/examples" % [ERB::Util.url_encode(workspace_id), ERB::Util.url_encode(intent)]
 
-      request(
-        method: "DELETE",
+      response = request(
+        method: "GET",
         url: method_url,
         headers: headers,
         params: params,
         accept_json: true
       )
-      nil
+      response
     end
 
     ##
-    # @!method get_example(workspace_id:, intent:, text:, include_audit: nil)
-    # Get user input example.
-    # Get information about a user input example.
+    # @!method create_example(workspace_id:, intent:, text:, mentions: nil)
+    # Create user input example.
+    # Add a new user input example to an intent.
     #
-    #   This operation is limited to 6000 requests per 5 minutes. For more information,
+    #   If you want to add multiple exaples with a single API call, consider using the
+    #   **[Update intent](#update-intent)** method instead.
+    #
+    #   This operation is limited to 1000 requests per 30 minutes. For more information,
     #   see **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
     # @param intent [String] The intent name.
-    # @param text [String] The text of the user input example.
-    # @param include_audit [Boolean] Whether to include the audit properties (`created` and `updated` timestamps) in
-    #   the response.
+    # @param text [String] The text of a user input example. This string must conform to the following
+    #   restrictions:
+    #   - It cannot contain carriage return, newline, or tab characters.
+    #   - It cannot consist of only whitespace characters.
+    # @param mentions [Array[Mention]] An array of contextual entity mentions.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def get_example(workspace_id:, intent:, text:, include_audit: nil)
+    def create_example(workspace_id:, intent:, text:, mentions: nil)
       raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
 
       raise ArgumentError.new("intent must be provided") if intent.nil?
@@ -751,64 +724,62 @@ module IBMWatson
 
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "get_example")
+      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "create_example")
       headers.merge!(sdk_headers)
 
       params = {
-        "version" => @version,
-        "include_audit" => include_audit
+        "version" => @version
       }
 
-      method_url = "/v1/workspaces/%s/intents/%s/examples/%s" % [ERB::Util.url_encode(workspace_id), ERB::Util.url_encode(intent), ERB::Util.url_encode(text)]
+      data = {
+        "text" => text,
+        "mentions" => mentions
+      }
+
+      method_url = "/v1/workspaces/%s/intents/%s/examples" % [ERB::Util.url_encode(workspace_id), ERB::Util.url_encode(intent)]
 
       response = request(
-        method: "GET",
+        method: "POST",
         url: method_url,
         headers: headers,
         params: params,
+        json: data,
         accept_json: true
       )
       response
     end
 
     ##
-    # @!method list_examples(workspace_id:, intent:, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
-    # List user input examples.
-    # List the user input examples for an intent, optionally including contextual entity
-    #   mentions.
+    # @!method get_example(workspace_id:, intent:, text:, include_audit: nil)
+    # Get user input example.
+    # Get information about a user input example.
     #
-    #   This operation is limited to 2500 requests per 30 minutes. For more information,
+    #   This operation is limited to 6000 requests per 5 minutes. For more information,
     #   see **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
     # @param intent [String] The intent name.
-    # @param page_limit [Fixnum] The number of records to return in each page of results.
-    # @param include_count [Boolean] Whether to include information about the number of records returned.
-    # @param sort [String] The attribute by which returned examples will be sorted. To reverse the sort
-    #   order, prefix the value with a minus sign (`-`).
-    # @param cursor [String] A token identifying the page of results to retrieve.
+    # @param text [String] The text of the user input example.
     # @param include_audit [Boolean] Whether to include the audit properties (`created` and `updated` timestamps) in
     #   the response.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def list_examples(workspace_id:, intent:, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
+    def get_example(workspace_id:, intent:, text:, include_audit: nil)
       raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
 
       raise ArgumentError.new("intent must be provided") if intent.nil?
 
+      raise ArgumentError.new("text must be provided") if text.nil?
+
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "list_examples")
+      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "get_example")
       headers.merge!(sdk_headers)
 
       params = {
         "version" => @version,
-        "page_limit" => page_limit,
-        "include_count" => include_count,
-        "sort" => sort,
-        "cursor" => cursor,
         "include_audit" => include_audit
       }
 
-      method_url = "/v1/workspaces/%s/intents/%s/examples" % [ERB::Util.url_encode(workspace_id), ERB::Util.url_encode(intent)]
+      method_url = "/v1/workspaces/%s/intents/%s/examples/%s" % [ERB::Util.url_encode(workspace_id), ERB::Util.url_encode(intent), ERB::Util.url_encode(text)]
 
       response = request(
         method: "GET",
@@ -825,6 +796,9 @@ module IBMWatson
     # Update user input example.
     # Update the text of a user input example.
     #
+    #   If you want to update multiple examples with a single API call, consider using the
+    #   **[Update intent](#update-intent)** method instead.
+    #
     #   This operation is limited to 1000 requests per 30 minutes. For more information,
     #   see **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
@@ -834,7 +808,6 @@ module IBMWatson
     #   restrictions:
     #   - It cannot contain carriage return, newline, or tab characters.
     #   - It cannot consist of only whitespace characters.
-    #   - It must be no longer than 1024 characters.
     # @param new_mentions [Array[Mention]] An array of contextual entity mentions.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def update_example(workspace_id:, intent:, text:, new_text: nil, new_mentions: nil)
@@ -870,168 +843,172 @@ module IBMWatson
       )
       response
     end
-    #########################
-    # Counterexamples
-    #########################
 
     ##
-    # @!method create_counterexample(workspace_id:, text:)
-    # Create counterexample.
-    # Add a new counterexample to a workspace. Counterexamples are examples that have
-    #   been marked as irrelevant input.
+    # @!method delete_example(workspace_id:, intent:, text:)
+    # Delete user input example.
+    # Delete a user input example from an intent.
     #
     #   This operation is limited to 1000 requests per 30 minutes. For more information,
     #   see **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
-    # @param text [String] The text of a user input marked as irrelevant input. This string must conform to
-    #   the following restrictions:
-    #   - It cannot contain carriage return, newline, or tab characters
-    #   - It cannot consist of only whitespace characters
-    #   - It must be no longer than 1024 characters.
-    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def create_counterexample(workspace_id:, text:)
+    # @param intent [String] The intent name.
+    # @param text [String] The text of the user input example.
+    # @return [nil]
+    def delete_example(workspace_id:, intent:, text:)
       raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
 
+      raise ArgumentError.new("intent must be provided") if intent.nil?
+
       raise ArgumentError.new("text must be provided") if text.nil?
 
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "create_counterexample")
+      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "delete_example")
       headers.merge!(sdk_headers)
 
       params = {
         "version" => @version
       }
 
-      data = {
-        "text" => text
-      }
-
-      method_url = "/v1/workspaces/%s/counterexamples" % [ERB::Util.url_encode(workspace_id)]
+      method_url = "/v1/workspaces/%s/intents/%s/examples/%s" % [ERB::Util.url_encode(workspace_id), ERB::Util.url_encode(intent), ERB::Util.url_encode(text)]
 
-      response = request(
-        method: "POST",
+      request(
+        method: "DELETE",
         url: method_url,
         headers: headers,
         params: params,
-        json: data,
         accept_json: true
       )
-      response
+      nil
     end
+    #########################
+    # Counterexamples
+    #########################
 
     ##
-    # @!method delete_counterexample(workspace_id:, text:)
-    # Delete counterexample.
-    # Delete a counterexample from a workspace. Counterexamples are examples that have
+    # @!method list_counterexamples(workspace_id:, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
+    # List counterexamples.
+    # List the counterexamples for a workspace. Counterexamples are examples that have
     #   been marked as irrelevant input.
     #
-    #   This operation is limited to 1000 requests per 30 minutes. For more information,
+    #   This operation is limited to 2500 requests per 30 minutes. For more information,
     #   see **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
-    # @param text [String] The text of a user input counterexample (for example, `What are you wearing?`).
-    # @return [nil]
-    def delete_counterexample(workspace_id:, text:)
+    # @param page_limit [Fixnum] The number of records to return in each page of results.
+    # @param include_count [Boolean] Whether to include information about the number of records returned.
+    # @param sort [String] The attribute by which returned counterexamples will be sorted. To reverse the
+    #   sort order, prefix the value with a minus sign (`-`).
+    # @param cursor [String] A token identifying the page of results to retrieve.
+    # @param include_audit [Boolean] Whether to include the audit properties (`created` and `updated` timestamps) in
+    #   the response.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def list_counterexamples(workspace_id:, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
       raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
 
-      raise ArgumentError.new("text must be provided") if text.nil?
-
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "delete_counterexample")
+      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "list_counterexamples")
       headers.merge!(sdk_headers)
 
       params = {
-        "version" => @version
+        "version" => @version,
+        "page_limit" => page_limit,
+        "include_count" => include_count,
+        "sort" => sort,
+        "cursor" => cursor,
+        "include_audit" => include_audit
       }
 
-      method_url = "/v1/workspaces/%s/counterexamples/%s" % [ERB::Util.url_encode(workspace_id), ERB::Util.url_encode(text)]
+      method_url = "/v1/workspaces/%s/counterexamples" % [ERB::Util.url_encode(workspace_id)]
 
-      request(
-        method: "DELETE",
+      response = request(
+        method: "GET",
         url: method_url,
         headers: headers,
         params: params,
         accept_json: true
       )
-      nil
+      response
     end
 
     ##
-    # @!method get_counterexample(workspace_id:, text:, include_audit: nil)
-    # Get counterexample.
-    # Get information about a counterexample. Counterexamples are examples that have
+    # @!method create_counterexample(workspace_id:, text:)
+    # Create counterexample.
+    # Add a new counterexample to a workspace. Counterexamples are examples that have
     #   been marked as irrelevant input.
     #
-    #   This operation is limited to 6000 requests per 5 minutes. For more information,
+    #   If you want to add multiple counterexamples with a single API call, consider using
+    #   the **[Update workspace](#update-workspace)** method instead.
+    #
+    #   This operation is limited to 1000 requests per 30 minutes. For more information,
     #   see **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
-    # @param text [String] The text of a user input counterexample (for example, `What are you wearing?`).
-    # @param include_audit [Boolean] Whether to include the audit properties (`created` and `updated` timestamps) in
-    #   the response.
+    # @param text [String] The text of a user input marked as irrelevant input. This string must conform to
+    #   the following restrictions:
+    #   - It cannot contain carriage return, newline, or tab characters.
+    #   - It cannot consist of only whitespace characters.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def get_counterexample(workspace_id:, text:, include_audit: nil)
+    def create_counterexample(workspace_id:, text:)
       raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
 
       raise ArgumentError.new("text must be provided") if text.nil?
 
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "get_counterexample")
+      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "create_counterexample")
       headers.merge!(sdk_headers)
 
       params = {
-        "version" => @version,
-        "include_audit" => include_audit
+        "version" => @version
       }
 
-      method_url = "/v1/workspaces/%s/counterexamples/%s" % [ERB::Util.url_encode(workspace_id), ERB::Util.url_encode(text)]
+      data = {
+        "text" => text
+      }
+
+      method_url = "/v1/workspaces/%s/counterexamples" % [ERB::Util.url_encode(workspace_id)]
 
       response = request(
-        method: "GET",
+        method: "POST",
         url: method_url,
         headers: headers,
         params: params,
+        json: data,
         accept_json: true
       )
       response
     end
 
     ##
-    # @!method list_counterexamples(workspace_id:, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
-    # List counterexamples.
-    # List the counterexamples for a workspace. Counterexamples are examples that have
+    # @!method get_counterexample(workspace_id:, text:, include_audit: nil)
+    # Get counterexample.
+    # Get information about a counterexample. Counterexamples are examples that have
     #   been marked as irrelevant input.
     #
-    #   This operation is limited to 2500 requests per 30 minutes. For more information,
+    #   This operation is limited to 6000 requests per 5 minutes. For more information,
     #   see **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
-    # @param page_limit [Fixnum] The number of records to return in each page of results.
-    # @param include_count [Boolean] Whether to include information about the number of records returned.
-    # @param sort [String] The attribute by which returned counterexamples will be sorted. To reverse the
-    #   sort order, prefix the value with a minus sign (`-`).
-    # @param cursor [String] A token identifying the page of results to retrieve.
+    # @param text [String] The text of a user input counterexample (for example, `What are you wearing?`).
     # @param include_audit [Boolean] Whether to include the audit properties (`created` and `updated` timestamps) in
     #   the response.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def list_counterexamples(workspace_id:, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
+    def get_counterexample(workspace_id:, text:, include_audit: nil)
       raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
 
+      raise ArgumentError.new("text must be provided") if text.nil?
+
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "list_counterexamples")
+      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "get_counterexample")
       headers.merge!(sdk_headers)
 
       params = {
         "version" => @version,
-        "page_limit" => page_limit,
-        "include_count" => include_count,
-        "sort" => sort,
-        "cursor" => cursor,
         "include_audit" => include_audit
       }
 
-      method_url = "/v1/workspaces/%s/counterexamples" % [ERB::Util.url_encode(workspace_id)]
+      method_url = "/v1/workspaces/%s/counterexamples/%s" % [ERB::Util.url_encode(workspace_id), ERB::Util.url_encode(text)]
 
       response = request(
         method: "GET",
@@ -1049,15 +1026,17 @@ module IBMWatson
     # Update the text of a counterexample. Counterexamples are examples that have been
     #   marked as irrelevant input.
     #
+    #   If you want to update multiple counterexamples with a single API call, consider
+    #   using the **[Update workspace](#update-workspace)** method instead.
+    #
     #   This operation is limited to 1000 requests per 30 minutes. For more information,
     #   see **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
     # @param text [String] The text of a user input counterexample (for example, `What are you wearing?`).
     # @param new_text [String] The text of a user input marked as irrelevant input. This string must conform to
     #   the following restrictions:
-    #   - It cannot contain carriage return, newline, or tab characters
-    #   - It cannot consist of only whitespace characters
-    #   - It must be no longer than 1024 characters.
+    #   - It cannot contain carriage return, newline, or tab characters.
+    #   - It cannot consist of only whitespace characters.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def update_counterexample(workspace_id:, text:, new_text: nil)
       raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
@@ -1089,27 +1068,115 @@ module IBMWatson
       )
       response
     end
+
+    ##
+    # @!method delete_counterexample(workspace_id:, text:)
+    # Delete counterexample.
+    # Delete a counterexample from a workspace. Counterexamples are examples that have
+    #   been marked as irrelevant input.
+    #
+    #   This operation is limited to 1000 requests per 30 minutes. For more information,
+    #   see **Rate limiting**.
+    # @param workspace_id [String] Unique identifier of the workspace.
+    # @param text [String] The text of a user input counterexample (for example, `What are you wearing?`).
+    # @return [nil]
+    def delete_counterexample(workspace_id:, text:)
+      raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
+
+      raise ArgumentError.new("text must be provided") if text.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "delete_counterexample")
+      headers.merge!(sdk_headers)
+
+      params = {
+        "version" => @version
+      }
+
+      method_url = "/v1/workspaces/%s/counterexamples/%s" % [ERB::Util.url_encode(workspace_id), ERB::Util.url_encode(text)]
+
+      request(
+        method: "DELETE",
+        url: method_url,
+        headers: headers,
+        params: params,
+        accept_json: true
+      )
+      nil
+    end
     #########################
     # Entities
     #########################
 
+    ##
+    # @!method list_entities(workspace_id:, export: nil, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
+    # List entities.
+    # List the entities for a workspace.
+    #
+    #   With **export**=`false`, this operation is limited to 1000 requests per 30
+    #   minutes. With **export**=`true`, the limit is 200 requests per 30 minutes. For
+    #   more information, see **Rate limiting**.
+    # @param workspace_id [String] Unique identifier of the workspace.
+    # @param export [Boolean] Whether to include all element content in the returned data. If
+    #   **export**=`false`, the returned data includes only information about the element
+    #   itself. If **export**=`true`, all content, including subelements, is included.
+    # @param page_limit [Fixnum] The number of records to return in each page of results.
+    # @param include_count [Boolean] Whether to include information about the number of records returned.
+    # @param sort [String] The attribute by which returned entities will be sorted. To reverse the sort
+    #   order, prefix the value with a minus sign (`-`).
+    # @param cursor [String] A token identifying the page of results to retrieve.
+    # @param include_audit [Boolean] Whether to include the audit properties (`created` and `updated` timestamps) in
+    #   the response.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def list_entities(workspace_id:, export: nil, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
+      raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "list_entities")
+      headers.merge!(sdk_headers)
+
+      params = {
+        "version" => @version,
+        "export" => export,
+        "page_limit" => page_limit,
+        "include_count" => include_count,
+        "sort" => sort,
+        "cursor" => cursor,
+        "include_audit" => include_audit
+      }
+
+      method_url = "/v1/workspaces/%s/entities" % [ERB::Util.url_encode(workspace_id)]
+
+      response = request(
+        method: "GET",
+        url: method_url,
+        headers: headers,
+        params: params,
+        accept_json: true
+      )
+      response
+    end
+
     ##
     # @!method create_entity(workspace_id:, entity:, description: nil, metadata: nil, fuzzy_match: nil, values: nil)
     # Create entity.
     # Create a new entity, or enable a system entity.
     #
+    #   If you want to create multiple entities with a single API call, consider using the
+    #   **[Update workspace](#update-workspace)** method instead.
+    #
     #   This operation is limited to 1000 requests per 30 minutes. For more information,
     #   see **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
     # @param entity [String] The name of the entity. This string must conform to the following restrictions:
     #   - It can contain only Unicode alphanumeric, underscore, and hyphen characters.
-    #   - It must be no longer than 64 characters.
-    #
-    #   If you specify an entity name beginning with the reserved prefix `sys-`, it must
+    #   - If you specify an entity name beginning with the reserved prefix `sys-`, it must
     #   be the name of a system entity that you want to enable. (Any entity content
     #   specified with the request is ignored.).
     # @param description [String] The description of the entity. This string cannot contain carriage return,
-    #   newline, or tab characters, and it must be no longer than 128 characters.
+    #   newline, or tab characters.
     # @param metadata [Hash] Any metadata related to the entity.
     # @param fuzzy_match [Boolean] Whether to use fuzzy matching for the entity.
     # @param values [Array[CreateValue]] An array of objects describing the entity values.
@@ -1150,226 +1217,233 @@ module IBMWatson
     end
 
     ##
-    # @!method delete_entity(workspace_id:, entity:)
-    # Delete entity.
-    # Delete an entity from a workspace, or disable a system entity.
+    # @!method get_entity(workspace_id:, entity:, export: nil, include_audit: nil)
+    # Get entity.
+    # Get information about an entity, optionally including all entity content.
     #
-    #   This operation is limited to 1000 requests per 30 minutes. For more information,
-    #   see **Rate limiting**.
+    #   With **export**=`false`, this operation is limited to 6000 requests per 5 minutes.
+    #   With **export**=`true`, the limit is 200 requests per 30 minutes. For more
+    #   information, see **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
     # @param entity [String] The name of the entity.
-    # @return [nil]
-    def delete_entity(workspace_id:, entity:)
+    # @param export [Boolean] Whether to include all element content in the returned data. If
+    #   **export**=`false`, the returned data includes only information about the element
+    #   itself. If **export**=`true`, all content, including subelements, is included.
+    # @param include_audit [Boolean] Whether to include the audit properties (`created` and `updated` timestamps) in
+    #   the response.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def get_entity(workspace_id:, entity:, export: nil, include_audit: nil)
       raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
 
       raise ArgumentError.new("entity must be provided") if entity.nil?
 
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "delete_entity")
+      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "get_entity")
       headers.merge!(sdk_headers)
 
       params = {
-        "version" => @version
+        "version" => @version,
+        "export" => export,
+        "include_audit" => include_audit
       }
 
       method_url = "/v1/workspaces/%s/entities/%s" % [ERB::Util.url_encode(workspace_id), ERB::Util.url_encode(entity)]
 
-      request(
-        method: "DELETE",
+      response = request(
+        method: "GET",
         url: method_url,
         headers: headers,
         params: params,
         accept_json: true
       )
-      nil
+      response
     end
 
     ##
-    # @!method get_entity(workspace_id:, entity:, export: nil, include_audit: nil)
-    # Get entity.
-    # Get information about an entity, optionally including all entity content.
+    # @!method update_entity(workspace_id:, entity:, new_entity: nil, new_description: nil, new_metadata: nil, new_fuzzy_match: nil, new_values: nil)
+    # Update entity.
+    # Update an existing entity with new or modified data. You must provide component
+    #   objects defining the content of the updated entity.
     #
-    #   With **export**=`false`, this operation is limited to 6000 requests per 5 minutes.
-    #   With **export**=`true`, the limit is 200 requests per 30 minutes. For more
-    #   information, see **Rate limiting**.
+    #   If you want to update multiple entities with a single API call, consider using the
+    #   **[Update workspace](#update-workspace)** method instead.
+    #
+    #   This operation is limited to 1000 requests per 30 minutes. For more information,
+    #   see **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
     # @param entity [String] The name of the entity.
-    # @param export [Boolean] Whether to include all element content in the returned data. If
-    #   **export**=`false`, the returned data includes only information about the element
-    #   itself. If **export**=`true`, all content, including subelements, is included.
-    # @param include_audit [Boolean] Whether to include the audit properties (`created` and `updated` timestamps) in
-    #   the response.
+    # @param new_entity [String] The name of the entity. This string must conform to the following restrictions:
+    #   - It can contain only Unicode alphanumeric, underscore, and hyphen characters.
+    #   - It cannot begin with the reserved prefix `sys-`.
+    # @param new_description [String] The description of the entity. This string cannot contain carriage return,
+    #   newline, or tab characters.
+    # @param new_metadata [Hash] Any metadata related to the entity.
+    # @param new_fuzzy_match [Boolean] Whether to use fuzzy matching for the entity.
+    # @param new_values [Array[CreateValue]] An array of objects describing the entity values.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def get_entity(workspace_id:, entity:, export: nil, include_audit: nil)
+    def update_entity(workspace_id:, entity:, new_entity: nil, new_description: nil, new_metadata: nil, new_fuzzy_match: nil, new_values: nil)
       raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
 
       raise ArgumentError.new("entity must be provided") if entity.nil?
 
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "get_entity")
+      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "update_entity")
       headers.merge!(sdk_headers)
 
       params = {
-        "version" => @version,
-        "export" => export,
-        "include_audit" => include_audit
+        "version" => @version
+      }
+
+      data = {
+        "entity" => new_entity,
+        "description" => new_description,
+        "metadata" => new_metadata,
+        "fuzzy_match" => new_fuzzy_match,
+        "values" => new_values
       }
 
       method_url = "/v1/workspaces/%s/entities/%s" % [ERB::Util.url_encode(workspace_id), ERB::Util.url_encode(entity)]
 
       response = request(
-        method: "GET",
+        method: "POST",
         url: method_url,
         headers: headers,
         params: params,
+        json: data,
         accept_json: true
       )
       response
     end
 
     ##
-    # @!method list_entities(workspace_id:, export: nil, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
-    # List entities.
-    # List the entities for a workspace.
+    # @!method delete_entity(workspace_id:, entity:)
+    # Delete entity.
+    # Delete an entity from a workspace, or disable a system entity.
     #
-    #   With **export**=`false`, this operation is limited to 1000 requests per 30
-    #   minutes. With **export**=`true`, the limit is 200 requests per 30 minutes. For
-    #   more information, see **Rate limiting**.
+    #   This operation is limited to 1000 requests per 30 minutes. For more information,
+    #   see **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
-    # @param export [Boolean] Whether to include all element content in the returned data. If
-    #   **export**=`false`, the returned data includes only information about the element
-    #   itself. If **export**=`true`, all content, including subelements, is included.
-    # @param page_limit [Fixnum] The number of records to return in each page of results.
-    # @param include_count [Boolean] Whether to include information about the number of records returned.
-    # @param sort [String] The attribute by which returned entities will be sorted. To reverse the sort
-    #   order, prefix the value with a minus sign (`-`).
-    # @param cursor [String] A token identifying the page of results to retrieve.
-    # @param include_audit [Boolean] Whether to include the audit properties (`created` and `updated` timestamps) in
-    #   the response.
-    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def list_entities(workspace_id:, export: nil, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
+    # @param entity [String] The name of the entity.
+    # @return [nil]
+    def delete_entity(workspace_id:, entity:)
       raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
 
+      raise ArgumentError.new("entity must be provided") if entity.nil?
+
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "list_entities")
+      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "delete_entity")
       headers.merge!(sdk_headers)
 
       params = {
-        "version" => @version,
-        "export" => export,
-        "page_limit" => page_limit,
-        "include_count" => include_count,
-        "sort" => sort,
-        "cursor" => cursor,
-        "include_audit" => include_audit
+        "version" => @version
       }
 
-      method_url = "/v1/workspaces/%s/entities" % [ERB::Util.url_encode(workspace_id)]
+      method_url = "/v1/workspaces/%s/entities/%s" % [ERB::Util.url_encode(workspace_id), ERB::Util.url_encode(entity)]
 
-      response = request(
-        method: "GET",
+      request(
+        method: "DELETE",
         url: method_url,
         headers: headers,
         params: params,
         accept_json: true
       )
-      response
+      nil
     end
+    #########################
+    # Mentions
+    #########################
 
     ##
-    # @!method update_entity(workspace_id:, entity:, new_entity: nil, new_description: nil, new_metadata: nil, new_fuzzy_match: nil, new_values: nil)
-    # Update entity.
-    # Update an existing entity with new or modified data. You must provide component
-    #   objects defining the content of the updated entity.
+    # @!method list_mentions(workspace_id:, entity:, export: nil, include_audit: nil)
+    # List entity mentions.
+    # List mentions for a contextual entity. An entity mention is an occurrence of a
+    #   contextual entity in the context of an intent user input example.
     #
-    #   This operation is limited to 1000 requests per 30 minutes. For more information,
+    #   This operation is limited to 200 requests per 30 minutes. For more information,
     #   see **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
     # @param entity [String] The name of the entity.
-    # @param new_entity [String] The name of the entity. This string must conform to the following restrictions:
-    #   - It can contain only Unicode alphanumeric, underscore, and hyphen characters.
-    #   - It cannot begin with the reserved prefix `sys-`.
-    #   - It must be no longer than 64 characters.
-    # @param new_description [String] The description of the entity. This string cannot contain carriage return,
-    #   newline, or tab characters, and it must be no longer than 128 characters.
-    # @param new_metadata [Hash] Any metadata related to the entity.
-    # @param new_fuzzy_match [Boolean] Whether to use fuzzy matching for the entity.
-    # @param new_values [Array[CreateValue]] An array of objects describing the entity values.
+    # @param export [Boolean] Whether to include all element content in the returned data. If
+    #   **export**=`false`, the returned data includes only information about the element
+    #   itself. If **export**=`true`, all content, including subelements, is included.
+    # @param include_audit [Boolean] Whether to include the audit properties (`created` and `updated` timestamps) in
+    #   the response.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def update_entity(workspace_id:, entity:, new_entity: nil, new_description: nil, new_metadata: nil, new_fuzzy_match: nil, new_values: nil)
+    def list_mentions(workspace_id:, entity:, export: nil, include_audit: nil)
       raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
 
       raise ArgumentError.new("entity must be provided") if entity.nil?
 
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "update_entity")
+      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "list_mentions")
       headers.merge!(sdk_headers)
 
       params = {
-        "version" => @version
-      }
-
-      data = {
-        "entity" => new_entity,
-        "description" => new_description,
-        "metadata" => new_metadata,
-        "fuzzy_match" => new_fuzzy_match,
-        "values" => new_values
+        "version" => @version,
+        "export" => export,
+        "include_audit" => include_audit
       }
 
-      method_url = "/v1/workspaces/%s/entities/%s" % [ERB::Util.url_encode(workspace_id), ERB::Util.url_encode(entity)]
+      method_url = "/v1/workspaces/%s/entities/%s/mentions" % [ERB::Util.url_encode(workspace_id), ERB::Util.url_encode(entity)]
 
       response = request(
-        method: "POST",
+        method: "GET",
         url: method_url,
         headers: headers,
         params: params,
-        json: data,
         accept_json: true
       )
       response
     end
     #########################
-    # Mentions
+    # Values
     #########################
 
     ##
-    # @!method list_mentions(workspace_id:, entity:, export: nil, include_audit: nil)
-    # List entity mentions.
-    # List mentions for a contextual entity. An entity mention is an occurrence of a
-    #   contextual entity in the context of an intent user input example.
+    # @!method list_values(workspace_id:, entity:, export: nil, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
+    # List entity values.
+    # List the values for an entity.
     #
-    #   This operation is limited to 200 requests per 30 minutes. For more information,
+    #   This operation is limited to 2500 requests per 30 minutes. For more information,
     #   see **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
     # @param entity [String] The name of the entity.
     # @param export [Boolean] Whether to include all element content in the returned data. If
     #   **export**=`false`, the returned data includes only information about the element
     #   itself. If **export**=`true`, all content, including subelements, is included.
+    # @param page_limit [Fixnum] The number of records to return in each page of results.
+    # @param include_count [Boolean] Whether to include information about the number of records returned.
+    # @param sort [String] The attribute by which returned entity values will be sorted. To reverse the sort
+    #   order, prefix the value with a minus sign (`-`).
+    # @param cursor [String] A token identifying the page of results to retrieve.
     # @param include_audit [Boolean] Whether to include the audit properties (`created` and `updated` timestamps) in
     #   the response.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def list_mentions(workspace_id:, entity:, export: nil, include_audit: nil)
+    def list_values(workspace_id:, entity:, export: nil, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
       raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
 
       raise ArgumentError.new("entity must be provided") if entity.nil?
 
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "list_mentions")
+      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "list_values")
       headers.merge!(sdk_headers)
 
       params = {
         "version" => @version,
         "export" => export,
+        "page_limit" => page_limit,
+        "include_count" => include_count,
+        "sort" => sort,
+        "cursor" => cursor,
         "include_audit" => include_audit
       }
 
-      method_url = "/v1/workspaces/%s/entities/%s/mentions" % [ERB::Util.url_encode(workspace_id), ERB::Util.url_encode(entity)]
+      method_url = "/v1/workspaces/%s/entities/%s/values" % [ERB::Util.url_encode(workspace_id), ERB::Util.url_encode(entity)]
 
       response = request(
         method: "GET",
@@ -1380,15 +1454,15 @@ module IBMWatson
       )
       response
     end
-    #########################
-    # Values
-    #########################
 
     ##
     # @!method create_value(workspace_id:, entity:, value:, metadata: nil, value_type: nil, synonyms: nil, patterns: nil)
     # Create entity value.
     # Create a new value for an entity.
     #
+    #   If you want to create multiple entity values with a single API call, consider
+    #   using the **[Update entity](#update-entity)** method instead.
+    #
     #   This operation is limited to 1000 requests per 30 minutes. For more information,
     #   see **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
@@ -1397,7 +1471,6 @@ module IBMWatson
     #   restrictions:
     #   - It cannot contain carriage return, newline, or tab characters.
     #   - It cannot consist of only whitespace characters.
-    #   - It must be no longer than 64 characters.
     # @param metadata [Hash] Any metadata related to the entity value.
     # @param value_type [String] Specifies the type of entity value.
     # @param synonyms [Array[String]] An array of synonyms for the entity value. A value can specify either synonyms or
@@ -1405,12 +1478,10 @@ module IBMWatson
     #   the following resrictions:
     #   - It cannot contain carriage return, newline, or tab characters.
     #   - It cannot consist of only whitespace characters.
-    #   - It must be no longer than 64 characters.
     # @param patterns [Array[String]] An array of patterns for the entity value. A value can specify either synonyms or
     #   patterns (depending on the value type), but not both. A pattern is a regular
-    #   expression no longer than 512 characters. For more information about how to
-    #   specify a pattern, see the
-    #   [documentation](https://cloud.ibm.com/docs/services/assistant/entities.html#entities-create-dictionary-based).
+    #   expression; for more information about how to specify a pattern, see the
+    #   [documentation](https://cloud.ibm.com/docs/services/assistant?topic=assistant-entities#entities-create-dictionary-based).
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def create_value(workspace_id:, entity:, value:, metadata: nil, value_type: nil, synonyms: nil, patterns: nil)
       raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
@@ -1449,45 +1520,6 @@ module IBMWatson
       response
     end
 
-    ##
-    # @!method delete_value(workspace_id:, entity:, value:)
-    # Delete entity value.
-    # Delete a value from an entity.
-    #
-    #   This operation is limited to 1000 requests per 30 minutes. For more information,
-    #   see **Rate limiting**.
-    # @param workspace_id [String] Unique identifier of the workspace.
-    # @param entity [String] The name of the entity.
-    # @param value [String] The text of the entity value.
-    # @return [nil]
-    def delete_value(workspace_id:, entity:, value:)
-      raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
-
-      raise ArgumentError.new("entity must be provided") if entity.nil?
-
-      raise ArgumentError.new("value must be provided") if value.nil?
-
-      headers = {
-      }
-      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "delete_value")
-      headers.merge!(sdk_headers)
-
-      params = {
-        "version" => @version
-      }
-
-      method_url = "/v1/workspaces/%s/entities/%s/values/%s" % [ERB::Util.url_encode(workspace_id), ERB::Util.url_encode(entity), ERB::Util.url_encode(value)]
-
-      request(
-        method: "DELETE",
-        url: method_url,
-        headers: headers,
-        params: params,
-        accept_json: true
-      )
-      nil
-    end
-
     ##
     # @!method get_value(workspace_id:, entity:, value:, export: nil, include_audit: nil)
     # Get entity value.
@@ -1534,64 +1566,15 @@ module IBMWatson
       response
     end
 
-    ##
-    # @!method list_values(workspace_id:, entity:, export: nil, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
-    # List entity values.
-    # List the values for an entity.
-    #
-    #   This operation is limited to 2500 requests per 30 minutes. For more information,
-    #   see **Rate limiting**.
-    # @param workspace_id [String] Unique identifier of the workspace.
-    # @param entity [String] The name of the entity.
-    # @param export [Boolean] Whether to include all element content in the returned data. If
-    #   **export**=`false`, the returned data includes only information about the element
-    #   itself. If **export**=`true`, all content, including subelements, is included.
-    # @param page_limit [Fixnum] The number of records to return in each page of results.
-    # @param include_count [Boolean] Whether to include information about the number of records returned.
-    # @param sort [String] The attribute by which returned entity values will be sorted. To reverse the sort
-    #   order, prefix the value with a minus sign (`-`).
-    # @param cursor [String] A token identifying the page of results to retrieve.
-    # @param include_audit [Boolean] Whether to include the audit properties (`created` and `updated` timestamps) in
-    #   the response.
-    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def list_values(workspace_id:, entity:, export: nil, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
-      raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
-
-      raise ArgumentError.new("entity must be provided") if entity.nil?
-
-      headers = {
-      }
-      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "list_values")
-      headers.merge!(sdk_headers)
-
-      params = {
-        "version" => @version,
-        "export" => export,
-        "page_limit" => page_limit,
-        "include_count" => include_count,
-        "sort" => sort,
-        "cursor" => cursor,
-        "include_audit" => include_audit
-      }
-
-      method_url = "/v1/workspaces/%s/entities/%s/values" % [ERB::Util.url_encode(workspace_id), ERB::Util.url_encode(entity)]
-
-      response = request(
-        method: "GET",
-        url: method_url,
-        headers: headers,
-        params: params,
-        accept_json: true
-      )
-      response
-    end
-
     ##
     # @!method update_value(workspace_id:, entity:, value:, new_value: nil, new_metadata: nil, new_value_type: nil, new_synonyms: nil, new_patterns: nil)
     # Update entity value.
     # Update an existing entity value with new or modified data. You must provide
     #   component objects defining the content of the updated entity value.
     #
+    #   If you want to update multiple entity values with a single API call, consider
+    #   using the **[Update entity](#update-entity)** method instead.
+    #
     #   This operation is limited to 1000 requests per 30 minutes. For more information,
     #   see **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
@@ -1601,7 +1584,6 @@ module IBMWatson
     #   restrictions:
     #   - It cannot contain carriage return, newline, or tab characters.
     #   - It cannot consist of only whitespace characters.
-    #   - It must be no longer than 64 characters.
     # @param new_metadata [Hash] Any metadata related to the entity value.
     # @param new_value_type [String] Specifies the type of entity value.
     # @param new_synonyms [Array[String]] An array of synonyms for the entity value. A value can specify either synonyms or
@@ -1609,12 +1591,10 @@ module IBMWatson
     #   the following resrictions:
     #   - It cannot contain carriage return, newline, or tab characters.
     #   - It cannot consist of only whitespace characters.
-    #   - It must be no longer than 64 characters.
     # @param new_patterns [Array[String]] An array of patterns for the entity value. A value can specify either synonyms or
     #   patterns (depending on the value type), but not both. A pattern is a regular
-    #   expression no longer than 512 characters. For more information about how to
-    #   specify a pattern, see the
-    #   [documentation](https://cloud.ibm.com/docs/services/assistant/entities.html#entities-create-dictionary-based).
+    #   expression; for more information about how to specify a pattern, see the
+    #   [documentation](https://cloud.ibm.com/docs/services/assistant?topic=assistant-entities#entities-create-dictionary-based).
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def update_value(workspace_id:, entity:, value:, new_value: nil, new_metadata: nil, new_value_type: nil, new_synonyms: nil, new_patterns: nil)
       raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
@@ -1652,117 +1632,119 @@ module IBMWatson
       )
       response
     end
-    #########################
-    # Synonyms
-    #########################
 
     ##
-    # @!method create_synonym(workspace_id:, entity:, value:, synonym:)
-    # Create entity value synonym.
-    # Add a new synonym to an entity value.
+    # @!method delete_value(workspace_id:, entity:, value:)
+    # Delete entity value.
+    # Delete a value from an entity.
     #
     #   This operation is limited to 1000 requests per 30 minutes. For more information,
     #   see **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
     # @param entity [String] The name of the entity.
     # @param value [String] The text of the entity value.
-    # @param synonym [String] The text of the synonym. This string must conform to the following restrictions:
-    #   - It cannot contain carriage return, newline, or tab characters.
-    #   - It cannot consist of only whitespace characters.
-    #   - It must be no longer than 64 characters.
-    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def create_synonym(workspace_id:, entity:, value:, synonym:)
+    # @return [nil]
+    def delete_value(workspace_id:, entity:, value:)
       raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
 
       raise ArgumentError.new("entity must be provided") if entity.nil?
 
       raise ArgumentError.new("value must be provided") if value.nil?
 
-      raise ArgumentError.new("synonym must be provided") if synonym.nil?
-
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "create_synonym")
+      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "delete_value")
       headers.merge!(sdk_headers)
 
       params = {
         "version" => @version
       }
 
-      data = {
-        "synonym" => synonym
-      }
-
-      method_url = "/v1/workspaces/%s/entities/%s/values/%s/synonyms" % [ERB::Util.url_encode(workspace_id), ERB::Util.url_encode(entity), ERB::Util.url_encode(value)]
+      method_url = "/v1/workspaces/%s/entities/%s/values/%s" % [ERB::Util.url_encode(workspace_id), ERB::Util.url_encode(entity), ERB::Util.url_encode(value)]
 
-      response = request(
-        method: "POST",
+      request(
+        method: "DELETE",
         url: method_url,
         headers: headers,
         params: params,
-        json: data,
         accept_json: true
       )
-      response
+      nil
     end
+    #########################
+    # Synonyms
+    #########################
 
     ##
-    # @!method delete_synonym(workspace_id:, entity:, value:, synonym:)
-    # Delete entity value synonym.
-    # Delete a synonym from an entity value.
+    # @!method list_synonyms(workspace_id:, entity:, value:, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
+    # List entity value synonyms.
+    # List the synonyms for an entity value.
     #
-    #   This operation is limited to 1000 requests per 30 minutes. For more information,
+    #   This operation is limited to 2500 requests per 30 minutes. For more information,
     #   see **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
     # @param entity [String] The name of the entity.
     # @param value [String] The text of the entity value.
-    # @param synonym [String] The text of the synonym.
-    # @return [nil]
-    def delete_synonym(workspace_id:, entity:, value:, synonym:)
+    # @param page_limit [Fixnum] The number of records to return in each page of results.
+    # @param include_count [Boolean] Whether to include information about the number of records returned.
+    # @param sort [String] The attribute by which returned entity value synonyms will be sorted. To reverse
+    #   the sort order, prefix the value with a minus sign (`-`).
+    # @param cursor [String] A token identifying the page of results to retrieve.
+    # @param include_audit [Boolean] Whether to include the audit properties (`created` and `updated` timestamps) in
+    #   the response.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def list_synonyms(workspace_id:, entity:, value:, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
       raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
 
       raise ArgumentError.new("entity must be provided") if entity.nil?
 
       raise ArgumentError.new("value must be provided") if value.nil?
 
-      raise ArgumentError.new("synonym must be provided") if synonym.nil?
-
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "delete_synonym")
+      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "list_synonyms")
       headers.merge!(sdk_headers)
 
       params = {
-        "version" => @version
+        "version" => @version,
+        "page_limit" => page_limit,
+        "include_count" => include_count,
+        "sort" => sort,
+        "cursor" => cursor,
+        "include_audit" => include_audit
       }
 
-      method_url = "/v1/workspaces/%s/entities/%s/values/%s/synonyms/%s" % [ERB::Util.url_encode(workspace_id), ERB::Util.url_encode(entity), ERB::Util.url_encode(value), ERB::Util.url_encode(synonym)]
+      method_url = "/v1/workspaces/%s/entities/%s/values/%s/synonyms" % [ERB::Util.url_encode(workspace_id), ERB::Util.url_encode(entity), ERB::Util.url_encode(value)]
 
-      request(
-        method: "DELETE",
+      response = request(
+        method: "GET",
         url: method_url,
         headers: headers,
         params: params,
         accept_json: true
       )
-      nil
+      response
     end
 
     ##
-    # @!method get_synonym(workspace_id:, entity:, value:, synonym:, include_audit: nil)
-    # Get entity value synonym.
-    # Get information about a synonym of an entity value.
+    # @!method create_synonym(workspace_id:, entity:, value:, synonym:)
+    # Create entity value synonym.
+    # Add a new synonym to an entity value.
     #
-    #   This operation is limited to 6000 requests per 5 minutes. For more information,
+    #   If you want to create multiple synonyms with a single API call, consider using the
+    #   **[Update entity](#update-entity)** or **[Update entity
+    #   value](#update-entity-value)** method instead.
+    #
+    #   This operation is limited to 1000 requests per 30 minutes. For more information,
     #   see **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
     # @param entity [String] The name of the entity.
     # @param value [String] The text of the entity value.
-    # @param synonym [String] The text of the synonym.
-    # @param include_audit [Boolean] Whether to include the audit properties (`created` and `updated` timestamps) in
-    #   the response.
+    # @param synonym [String] The text of the synonym. This string must conform to the following restrictions:
+    #   - It cannot contain carriage return, newline, or tab characters.
+    #   - It cannot consist of only whitespace characters.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def get_synonym(workspace_id:, entity:, value:, synonym:, include_audit: nil)
+    def create_synonym(workspace_id:, entity:, value:, synonym:)
       raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
 
       raise ArgumentError.new("entity must be provided") if entity.nil?
@@ -1773,66 +1755,64 @@ module IBMWatson
 
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "get_synonym")
+      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "create_synonym")
       headers.merge!(sdk_headers)
 
       params = {
-        "version" => @version,
-        "include_audit" => include_audit
+        "version" => @version
       }
 
-      method_url = "/v1/workspaces/%s/entities/%s/values/%s/synonyms/%s" % [ERB::Util.url_encode(workspace_id), ERB::Util.url_encode(entity), ERB::Util.url_encode(value), ERB::Util.url_encode(synonym)]
+      data = {
+        "synonym" => synonym
+      }
+
+      method_url = "/v1/workspaces/%s/entities/%s/values/%s/synonyms" % [ERB::Util.url_encode(workspace_id), ERB::Util.url_encode(entity), ERB::Util.url_encode(value)]
 
       response = request(
-        method: "GET",
+        method: "POST",
         url: method_url,
         headers: headers,
         params: params,
+        json: data,
         accept_json: true
       )
       response
     end
 
     ##
-    # @!method list_synonyms(workspace_id:, entity:, value:, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
-    # List entity value synonyms.
-    # List the synonyms for an entity value.
+    # @!method get_synonym(workspace_id:, entity:, value:, synonym:, include_audit: nil)
+    # Get entity value synonym.
+    # Get information about a synonym of an entity value.
     #
-    #   This operation is limited to 2500 requests per 30 minutes. For more information,
+    #   This operation is limited to 6000 requests per 5 minutes. For more information,
     #   see **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
     # @param entity [String] The name of the entity.
     # @param value [String] The text of the entity value.
-    # @param page_limit [Fixnum] The number of records to return in each page of results.
-    # @param include_count [Boolean] Whether to include information about the number of records returned.
-    # @param sort [String] The attribute by which returned entity value synonyms will be sorted. To reverse
-    #   the sort order, prefix the value with a minus sign (`-`).
-    # @param cursor [String] A token identifying the page of results to retrieve.
+    # @param synonym [String] The text of the synonym.
     # @param include_audit [Boolean] Whether to include the audit properties (`created` and `updated` timestamps) in
     #   the response.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def list_synonyms(workspace_id:, entity:, value:, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
+    def get_synonym(workspace_id:, entity:, value:, synonym:, include_audit: nil)
       raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
 
       raise ArgumentError.new("entity must be provided") if entity.nil?
 
       raise ArgumentError.new("value must be provided") if value.nil?
 
+      raise ArgumentError.new("synonym must be provided") if synonym.nil?
+
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "list_synonyms")
+      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "get_synonym")
       headers.merge!(sdk_headers)
 
       params = {
         "version" => @version,
-        "page_limit" => page_limit,
-        "include_count" => include_count,
-        "sort" => sort,
-        "cursor" => cursor,
         "include_audit" => include_audit
       }
 
-      method_url = "/v1/workspaces/%s/entities/%s/values/%s/synonyms" % [ERB::Util.url_encode(workspace_id), ERB::Util.url_encode(entity), ERB::Util.url_encode(value)]
+      method_url = "/v1/workspaces/%s/entities/%s/values/%s/synonyms/%s" % [ERB::Util.url_encode(workspace_id), ERB::Util.url_encode(entity), ERB::Util.url_encode(value), ERB::Util.url_encode(synonym)]
 
       response = request(
         method: "GET",
@@ -1849,6 +1829,10 @@ module IBMWatson
     # Update entity value synonym.
     # Update an existing entity value synonym with new text.
     #
+    #   If you want to update multiple synonyms with a single API call, consider using the
+    #   **[Update entity](#update-entity)** or **[Update entity
+    #   value](#update-entity-value)** method instead.
+    #
     #   This operation is limited to 1000 requests per 30 minutes. For more information,
     #   see **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
@@ -1858,7 +1842,6 @@ module IBMWatson
     # @param new_synonym [String] The text of the synonym. This string must conform to the following restrictions:
     #   - It cannot contain carriage return, newline, or tab characters.
     #   - It cannot consist of only whitespace characters.
-    #   - It must be no longer than 64 characters.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def update_synonym(workspace_id:, entity:, value:, synonym:, new_synonym: nil)
       raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
@@ -1894,34 +1877,122 @@ module IBMWatson
       )
       response
     end
+
+    ##
+    # @!method delete_synonym(workspace_id:, entity:, value:, synonym:)
+    # Delete entity value synonym.
+    # Delete a synonym from an entity value.
+    #
+    #   This operation is limited to 1000 requests per 30 minutes. For more information,
+    #   see **Rate limiting**.
+    # @param workspace_id [String] Unique identifier of the workspace.
+    # @param entity [String] The name of the entity.
+    # @param value [String] The text of the entity value.
+    # @param synonym [String] The text of the synonym.
+    # @return [nil]
+    def delete_synonym(workspace_id:, entity:, value:, synonym:)
+      raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
+
+      raise ArgumentError.new("entity must be provided") if entity.nil?
+
+      raise ArgumentError.new("value must be provided") if value.nil?
+
+      raise ArgumentError.new("synonym must be provided") if synonym.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "delete_synonym")
+      headers.merge!(sdk_headers)
+
+      params = {
+        "version" => @version
+      }
+
+      method_url = "/v1/workspaces/%s/entities/%s/values/%s/synonyms/%s" % [ERB::Util.url_encode(workspace_id), ERB::Util.url_encode(entity), ERB::Util.url_encode(value), ERB::Util.url_encode(synonym)]
+
+      request(
+        method: "DELETE",
+        url: method_url,
+        headers: headers,
+        params: params,
+        accept_json: true
+      )
+      nil
+    end
     #########################
     # Dialog nodes
     #########################
 
+    ##
+    # @!method list_dialog_nodes(workspace_id:, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
+    # List dialog nodes.
+    # List the dialog nodes for a workspace.
+    #
+    #   This operation is limited to 2500 requests per 30 minutes. For more information,
+    #   see **Rate limiting**.
+    # @param workspace_id [String] Unique identifier of the workspace.
+    # @param page_limit [Fixnum] The number of records to return in each page of results.
+    # @param include_count [Boolean] Whether to include information about the number of records returned.
+    # @param sort [String] The attribute by which returned dialog nodes will be sorted. To reverse the sort
+    #   order, prefix the value with a minus sign (`-`).
+    # @param cursor [String] A token identifying the page of results to retrieve.
+    # @param include_audit [Boolean] Whether to include the audit properties (`created` and `updated` timestamps) in
+    #   the response.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def list_dialog_nodes(workspace_id:, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
+      raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "list_dialog_nodes")
+      headers.merge!(sdk_headers)
+
+      params = {
+        "version" => @version,
+        "page_limit" => page_limit,
+        "include_count" => include_count,
+        "sort" => sort,
+        "cursor" => cursor,
+        "include_audit" => include_audit
+      }
+
+      method_url = "/v1/workspaces/%s/dialog_nodes" % [ERB::Util.url_encode(workspace_id)]
+
+      response = request(
+        method: "GET",
+        url: method_url,
+        headers: headers,
+        params: params,
+        accept_json: true
+      )
+      response
+    end
+
     ##
     # @!method create_dialog_node(workspace_id:, dialog_node:, description: nil, conditions: nil, parent: nil, previous_sibling: nil, output: nil, context: nil, metadata: nil, next_step: nil, title: nil, node_type: nil, event_name: nil, variable: nil, actions: nil, digress_in: nil, digress_out: nil, digress_out_slots: nil, user_label: nil)
     # Create dialog node.
     # Create a new dialog node.
     #
+    #   If you want to create multiple dialog nodes with a single API call, consider using
+    #   the **[Update workspace](#update-workspace)** method instead.
+    #
     #   This operation is limited to 500 requests per 30 minutes. For more information,
     #   see **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
     # @param dialog_node [String] The dialog node ID. This string must conform to the following restrictions:
     #   - It can contain only Unicode alphanumeric, space, underscore, hyphen, and dot
     #   characters.
-    #   - It must be no longer than 1024 characters.
     # @param description [String] The description of the dialog node. This string cannot contain carriage return,
-    #   newline, or tab characters, and it must be no longer than 128 characters.
+    #   newline, or tab characters.
     # @param conditions [String] The condition that will trigger the dialog node. This string cannot contain
-    #   carriage return, newline, or tab characters, and it must be no longer than 2048
-    #   characters.
+    #   carriage return, newline, or tab characters.
     # @param parent [String] The ID of the parent dialog node. This property is omitted if the dialog node has
     #   no parent.
     # @param previous_sibling [String] The ID of the previous sibling dialog node. This property is omitted if the dialog
     #   node has no previous sibling.
     # @param output [DialogNodeOutput] The output of the dialog node. For more information about how to specify dialog
     #   node output, see the
-    #   [documentation](https://cloud.ibm.com/docs/services/assistant/dialog-overview.html#dialog-overview-responses).
+    #   [documentation](https://cloud.ibm.com/docs/services/assistant?topic=assistant-dialog-overview#dialog-overview-responses).
     # @param context [Hash] The context for the dialog node.
     # @param metadata [Hash] The metadata for the dialog node.
     # @param next_step [DialogNodeNextStep] The next step to execute following this dialog node.
@@ -1929,7 +2000,6 @@ module IBMWatson
     #   following restrictions:
     #   - It can contain only Unicode alphanumeric, space, underscore, hyphen, and dot
     #   characters.
-    #   - It must be no longer than 64 characters.
     # @param node_type [String] How the dialog node is processed.
     # @param event_name [String] How an `event_handler` node is processed.
     # @param variable [String] The location in the dialog context where output is stored.
@@ -1938,7 +2008,7 @@ module IBMWatson
     # @param digress_out [String] Whether this dialog node can be returned to after a digression.
     # @param digress_out_slots [String] Whether the user can digress to top-level nodes while filling out slots.
     # @param user_label [String] A label that can be displayed externally to describe the purpose of the node to
-    #   users. This string must be no longer than 512 characters.
+    #   users.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def create_dialog_node(workspace_id:, dialog_node:, description: nil, conditions: nil, parent: nil, previous_sibling: nil, output: nil, context: nil, metadata: nil, next_step: nil, title: nil, node_type: nil, event_name: nil, variable: nil, actions: nil, digress_in: nil, digress_out: nil, digress_out_slots: nil, user_label: nil)
       raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
@@ -1988,42 +2058,6 @@ module IBMWatson
       response
     end
 
-    ##
-    # @!method delete_dialog_node(workspace_id:, dialog_node:)
-    # Delete dialog node.
-    # Delete a dialog node from a workspace.
-    #
-    #   This operation is limited to 500 requests per 30 minutes. For more information,
-    #   see **Rate limiting**.
-    # @param workspace_id [String] Unique identifier of the workspace.
-    # @param dialog_node [String] The dialog node ID (for example, `get_order`).
-    # @return [nil]
-    def delete_dialog_node(workspace_id:, dialog_node:)
-      raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
-
-      raise ArgumentError.new("dialog_node must be provided") if dialog_node.nil?
-
-      headers = {
-      }
-      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "delete_dialog_node")
-      headers.merge!(sdk_headers)
-
-      params = {
-        "version" => @version
-      }
-
-      method_url = "/v1/workspaces/%s/dialog_nodes/%s" % [ERB::Util.url_encode(workspace_id), ERB::Util.url_encode(dialog_node)]
-
-      request(
-        method: "DELETE",
-        url: method_url,
-        headers: headers,
-        params: params,
-        accept_json: true
-      )
-      nil
-    end
-
     ##
     # @!method get_dialog_node(workspace_id:, dialog_node:, include_audit: nil)
     # Get dialog node.
@@ -2063,56 +2097,14 @@ module IBMWatson
       response
     end
 
-    ##
-    # @!method list_dialog_nodes(workspace_id:, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
-    # List dialog nodes.
-    # List the dialog nodes for a workspace.
-    #
-    #   This operation is limited to 2500 requests per 30 minutes. For more information,
-    #   see **Rate limiting**.
-    # @param workspace_id [String] Unique identifier of the workspace.
-    # @param page_limit [Fixnum] The number of records to return in each page of results.
-    # @param include_count [Boolean] Whether to include information about the number of records returned.
-    # @param sort [String] The attribute by which returned dialog nodes will be sorted. To reverse the sort
-    #   order, prefix the value with a minus sign (`-`).
-    # @param cursor [String] A token identifying the page of results to retrieve.
-    # @param include_audit [Boolean] Whether to include the audit properties (`created` and `updated` timestamps) in
-    #   the response.
-    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def list_dialog_nodes(workspace_id:, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
-      raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
-
-      headers = {
-      }
-      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "list_dialog_nodes")
-      headers.merge!(sdk_headers)
-
-      params = {
-        "version" => @version,
-        "page_limit" => page_limit,
-        "include_count" => include_count,
-        "sort" => sort,
-        "cursor" => cursor,
-        "include_audit" => include_audit
-      }
-
-      method_url = "/v1/workspaces/%s/dialog_nodes" % [ERB::Util.url_encode(workspace_id)]
-
-      response = request(
-        method: "GET",
-        url: method_url,
-        headers: headers,
-        params: params,
-        accept_json: true
-      )
-      response
-    end
-
     ##
     # @!method update_dialog_node(workspace_id:, dialog_node:, new_dialog_node: nil, new_description: nil, new_conditions: nil, new_parent: nil, new_previous_sibling: nil, new_output: nil, new_context: nil, new_metadata: nil, new_next_step: nil, new_title: nil, new_node_type: nil, new_event_name: nil, new_variable: nil, new_actions: nil, new_digress_in: nil, new_digress_out: nil, new_digress_out_slots: nil, new_user_label: nil)
     # Update dialog node.
     # Update an existing dialog node with new or modified data.
     #
+    #   If you want to update multiple dialog nodes with a single API call, consider using
+    #   the **[Update workspace](#update-workspace)** method instead.
+    #
     #   This operation is limited to 500 requests per 30 minutes. For more information,
     #   see **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
@@ -2120,19 +2112,17 @@ module IBMWatson
     # @param new_dialog_node [String] The dialog node ID. This string must conform to the following restrictions:
     #   - It can contain only Unicode alphanumeric, space, underscore, hyphen, and dot
     #   characters.
-    #   - It must be no longer than 1024 characters.
     # @param new_description [String] The description of the dialog node. This string cannot contain carriage return,
-    #   newline, or tab characters, and it must be no longer than 128 characters.
+    #   newline, or tab characters.
     # @param new_conditions [String] The condition that will trigger the dialog node. This string cannot contain
-    #   carriage return, newline, or tab characters, and it must be no longer than 2048
-    #   characters.
+    #   carriage return, newline, or tab characters.
     # @param new_parent [String] The ID of the parent dialog node. This property is omitted if the dialog node has
     #   no parent.
     # @param new_previous_sibling [String] The ID of the previous sibling dialog node. This property is omitted if the dialog
     #   node has no previous sibling.
     # @param new_output [DialogNodeOutput] The output of the dialog node. For more information about how to specify dialog
     #   node output, see the
-    #   [documentation](https://cloud.ibm.com/docs/services/assistant/dialog-overview.html#dialog-overview-responses).
+    #   [documentation](https://cloud.ibm.com/docs/services/assistant?topic=assistant-dialog-overview#dialog-overview-responses).
     # @param new_context [Hash] The context for the dialog node.
     # @param new_metadata [Hash] The metadata for the dialog node.
     # @param new_next_step [DialogNodeNextStep] The next step to execute following this dialog node.
@@ -2140,7 +2130,6 @@ module IBMWatson
     #   following restrictions:
     #   - It can contain only Unicode alphanumeric, space, underscore, hyphen, and dot
     #   characters.
-    #   - It must be no longer than 64 characters.
     # @param new_node_type [String] How the dialog node is processed.
     # @param new_event_name [String] How an `event_handler` node is processed.
     # @param new_variable [String] The location in the dialog context where output is stored.
@@ -2149,7 +2138,7 @@ module IBMWatson
     # @param new_digress_out [String] Whether this dialog node can be returned to after a digression.
     # @param new_digress_out_slots [String] Whether the user can digress to top-level nodes while filling out slots.
     # @param new_user_label [String] A label that can be displayed externally to describe the purpose of the node to
-    #   users. This string must be no longer than 512 characters.
+    #   users.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def update_dialog_node(workspace_id:, dialog_node:, new_dialog_node: nil, new_description: nil, new_conditions: nil, new_parent: nil, new_previous_sibling: nil, new_output: nil, new_context: nil, new_metadata: nil, new_next_step: nil, new_title: nil, new_node_type: nil, new_event_name: nil, new_variable: nil, new_actions: nil, new_digress_in: nil, new_digress_out: nil, new_digress_out_slots: nil, new_user_label: nil)
       raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
@@ -2198,45 +2187,80 @@ module IBMWatson
       )
       response
     end
+
+    ##
+    # @!method delete_dialog_node(workspace_id:, dialog_node:)
+    # Delete dialog node.
+    # Delete a dialog node from a workspace.
+    #
+    #   This operation is limited to 500 requests per 30 minutes. For more information,
+    #   see **Rate limiting**.
+    # @param workspace_id [String] Unique identifier of the workspace.
+    # @param dialog_node [String] The dialog node ID (for example, `get_order`).
+    # @return [nil]
+    def delete_dialog_node(workspace_id:, dialog_node:)
+      raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
+
+      raise ArgumentError.new("dialog_node must be provided") if dialog_node.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "delete_dialog_node")
+      headers.merge!(sdk_headers)
+
+      params = {
+        "version" => @version
+      }
+
+      method_url = "/v1/workspaces/%s/dialog_nodes/%s" % [ERB::Util.url_encode(workspace_id), ERB::Util.url_encode(dialog_node)]
+
+      request(
+        method: "DELETE",
+        url: method_url,
+        headers: headers,
+        params: params,
+        accept_json: true
+      )
+      nil
+    end
     #########################
     # Logs
     #########################
 
     ##
-    # @!method list_all_logs(filter:, sort: nil, page_limit: nil, cursor: nil)
-    # List log events in all workspaces.
-    # List the events from the logs of all workspaces in the service instance.
+    # @!method list_logs(workspace_id:, sort: nil, filter: nil, page_limit: nil, cursor: nil)
+    # List log events in a workspace.
+    # List the events from the log of a specific workspace.
     #
     #   If **cursor** is not specified, this operation is limited to 40 requests per 30
     #   minutes. If **cursor** is specified, the limit is 120 requests per minute. For
     #   more information, see **Rate limiting**.
-    # @param filter [String] A cacheable parameter that limits the results to those matching the specified
-    #   filter. You must specify a filter query that includes a value for `language`, as
-    #   well as a value for `workspace_id` or `request.context.metadata.deployment`. For
-    #   more information, see the
-    #   [documentation](https://cloud.ibm.com/docs/services/assistant/filter-reference.html#filter-reference-syntax).
+    # @param workspace_id [String] Unique identifier of the workspace.
     # @param sort [String] How to sort the returned log events. You can sort by **request_timestamp**. To
     #   reverse the sort order, prefix the parameter value with a minus sign (`-`).
+    # @param filter [String] A cacheable parameter that limits the results to those matching the specified
+    #   filter. For more information, see the
+    #   [documentation](https://cloud.ibm.com/docs/services/assistant?topic=assistant-filter-reference#filter-reference).
     # @param page_limit [Fixnum] The number of records to return in each page of results.
     # @param cursor [String] A token identifying the page of results to retrieve.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def list_all_logs(filter:, sort: nil, page_limit: nil, cursor: nil)
-      raise ArgumentError.new("filter must be provided") if filter.nil?
+    def list_logs(workspace_id:, sort: nil, filter: nil, page_limit: nil, cursor: nil)
+      raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
 
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "list_all_logs")
+      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "list_logs")
       headers.merge!(sdk_headers)
 
       params = {
         "version" => @version,
-        "filter" => filter,
         "sort" => sort,
+        "filter" => filter,
         "page_limit" => page_limit,
         "cursor" => cursor
       }
 
-      method_url = "/v1/logs"
+      method_url = "/v1/workspaces/%s/logs" % [ERB::Util.url_encode(workspace_id)]
 
       response = request(
         method: "GET",
@@ -2249,39 +2273,40 @@ module IBMWatson
     end
 
     ##
-    # @!method list_logs(workspace_id:, sort: nil, filter: nil, page_limit: nil, cursor: nil)
-    # List log events in a workspace.
-    # List the events from the log of a specific workspace.
+    # @!method list_all_logs(filter:, sort: nil, page_limit: nil, cursor: nil)
+    # List log events in all workspaces.
+    # List the events from the logs of all workspaces in the service instance.
     #
     #   If **cursor** is not specified, this operation is limited to 40 requests per 30
     #   minutes. If **cursor** is specified, the limit is 120 requests per minute. For
     #   more information, see **Rate limiting**.
-    # @param workspace_id [String] Unique identifier of the workspace.
+    # @param filter [String] A cacheable parameter that limits the results to those matching the specified
+    #   filter. You must specify a filter query that includes a value for `language`, as
+    #   well as a value for `workspace_id` or `request.context.metadata.deployment`. For
+    #   more information, see the
+    #   [documentation](https://cloud.ibm.com/docs/services/assistant?topic=assistant-filter-reference#filter-reference).
     # @param sort [String] How to sort the returned log events. You can sort by **request_timestamp**. To
     #   reverse the sort order, prefix the parameter value with a minus sign (`-`).
-    # @param filter [String] A cacheable parameter that limits the results to those matching the specified
-    #   filter. For more information, see the
-    #   [documentation](https://cloud.ibm.com/docs/services/assistant/filter-reference.html#filter-reference-syntax).
     # @param page_limit [Fixnum] The number of records to return in each page of results.
     # @param cursor [String] A token identifying the page of results to retrieve.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def list_logs(workspace_id:, sort: nil, filter: nil, page_limit: nil, cursor: nil)
-      raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
+    def list_all_logs(filter:, sort: nil, page_limit: nil, cursor: nil)
+      raise ArgumentError.new("filter must be provided") if filter.nil?
 
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "list_logs")
+      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "list_all_logs")
       headers.merge!(sdk_headers)
 
       params = {
         "version" => @version,
-        "sort" => sort,
         "filter" => filter,
+        "sort" => sort,
         "page_limit" => page_limit,
         "cursor" => cursor
       }
 
-      method_url = "/v1/workspaces/%s/logs" % [ERB::Util.url_encode(workspace_id)]
+      method_url = "/v1/logs"
 
       response = request(
         method: "GET",
@@ -2305,7 +2330,7 @@ module IBMWatson
     #   You associate a customer ID with data by passing the `X-Watson-Metadata` header
     #   with a request that passes data. For more information about personal data and
     #   customer IDs, see [Information
-    #   security](https://cloud.ibm.com/docs/services/assistant/information-security.html).
+    #   security](https://cloud.ibm.com/docs/services/assistant?topic=assistant-information-security#information-security).
     # @param customer_id [String] The customer ID for which all data is to be deleted.
     # @return [nil]
     def delete_user_data(customer_id:)