ibm_watson 1.2.0 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7c6d7f5a377f215adb0729cf0382278e5ffaab799600af790f34ccbdfc23c9bc
-  data.tar.gz: 2bcd42b40f431dd384e98ed4bb2189f31bc9f2e3079d3e6f99616c04dac0058e
+  metadata.gz: 409d6967d2bafb4da4062a2f5f5e6db07a110094af4ebb021782349907066d80
+  data.tar.gz: a4ec07dda5cf80e87b24f13c430d042cdced5805b40001aa8cd94052fd5b2c8f
 SHA512:
-  metadata.gz: 0c596c85d58113d53c16e02d146efd8a8dcad0e182b09b5be788cd0f407270b8cdb74dc367cfd970843d29bd698e94123769322da23c35a044426b8a6e039cef
-  data.tar.gz: c36a5db2c61384052d8d1df6cbacaae5eec21a8acf6050c8bb3bf7eac419ccb60b34028b870d4b88845e0750698c1bb0dc08e04730265a6c30066c138428d3b6
+  metadata.gz: c27789e4c9a650579efe3547833dbb329394ca3b3db339bb5b36c4203e973915f6be60142e55ea35a034be47627200a9d4e5387edd0fcbb75491e7a5122b3c78
+  data.tar.gz: 7c5b71128abfaff86e6f648bf07932357f01f6574d5ca3f27553ff17a851ed6e0abc037af56a9be4e64d4aa8a1d7ef645d534a852fd2653b54f5e0d9c343723c

data/README.md

@@ -129,7 +129,7 @@ IBM Cloud is migrating to token-based Identity and Access Management (IAM) authe
 You supply either an IAM service **API key** or an **access token**:
 
 * Use the API key to have the SDK manage the lifecycle of the access token. The SDK requests an access token, ensures that the access token is valid, and refreshes it if necessary.
-* Use the access token if you want to manage the lifecycle yourself. For details, see [Authenticating with IAM tokens](https://cloud.ibm.com/docs/services/watson?topic=watson-iam).
+* Use the access token if you want to manage the lifecycle yourself. For details, see [Authenticating with IAM tokens](https://cloud.ibm.com/docs/watson?topic=watson-iam).
 
 #### Supplying the IAM API key
 
@@ -267,6 +267,28 @@ Headers: "<http response headers>"
 Result: "<response returned by service>"
 ```
 
+### Transaction IDs
+
+Every SDK call will return a response which will contain a transaction ID, accessible via the `x-global-transaction-id` header. This transaction ID is useful for troubleshooting and accessing relevant logs from your service instance.
+
+```ruby
+require "ibm_watson"
+include IBMWatson
+
+assistant = AssistantV1.new(
+  authenticator: "<authenticator>"
+  version: "2017-04-21"
+)
+
+begin
+  response = assistant.list_workspaces
+  p "Global transaction id: #{response.headers["X-Global-Transaction-Id"]}"
+rescue IBMCloudSdkCore::ApiException => e
+  # Global transaction on failed api call is contained in the error message
+  print "Error: ##{e}"
+end
+```
+
 ## Configuring the HTTP client
 
 To set client configs like timeout or proxy use the `configure_http_client` function and pass in the configurations.
@@ -368,12 +390,18 @@ assistant = IBMWatson::AssistantV1.new(
 
 ```
 
+## Questions
+
+If you have issues with the APIs or have a question about the Watson services, see [Stack Overflow](https://stackoverflow.com/questions/tagged/ibm-watson+ruby).
+
 ## Ruby version
 
 Tested on:
 
-* MRI Ruby (RVM): 2.3.7, 2.4.4, 2.5.1
-* RubyInstaller (Windows x64): 2.3.3, 2.4.4, 2.5.1
+* MRI Ruby (RVM): 2.5.1, 2.6.1
+* RubyInstaller (Windows x64): 2.5.1, 2.6.1
+
+2.3.7 and 2.4.4 should still work but support will be deprecated in next major release.
 
 ## Contributing
 
@@ -397,6 +425,6 @@ We'd love to highlight cool open-source projects that use this SDK! If you'd lik
 [examples]: https://github.com/watson-developer-cloud/ruby-sdk/tree/master/examples
 [CONTRIBUTING]: https://github.com/watson-developer-cloud/ruby-sdk/blob/master/CONTRIBUTING.md
 [license]: http://www.apache.org/licenses/LICENSE-2.0
-[vcap_services]: https://cloud.ibm.com/docs/services/watson?topic=watson-vcapServices
+[vcap_services]: https://cloud.ibm.com/docs/watson?topic=watson-vcapServices
 [ibm-cloud-onboarding]: http://cloud.ibm.com/registration?target=/developer/watson&cm_sp=WatsonPlatform-WatsonServices-_-OnPageNavLink-IBMWatson_SDKs-_-Ruby
-[ivar]: http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/IVar.html
+[ivar]: http://ruby-concurrency.github.io/concurrent-ruby/Concurrent/IVar.html

data/lib/ibm_watson/assistant_v1.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# (C) Copyright IBM Corp. 2020.
+# (C) Copyright IBM Corp. 2018, 2020.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -33,6 +33,8 @@ module IBMWatson
   # The Assistant V1 service.
   class AssistantV1 < IBMCloudSdkCore::BaseService
     include Concurrent::Async
+    DEFAULT_SERVICE_NAME = "assistant"
+    DEFAULT_SERVICE_URL = "https://api.us-south.assistant.watson.cloud.ibm.com"
     ##
     # @!method initialize(args)
     # Construct a new client for the Assistant service.
@@ -51,19 +53,23 @@ module IBMWatson
     # @option args service_url [String] The base service URL to use when contacting the service.
     #   The base service_url may differ between IBM Cloud regions.
     # @option args authenticator [Object] The Authenticator instance to be configured for this service.
+    # @option args service_name [String] The name of the service to configure. Will be used as the key to load
+    #   any external configuration, if applicable.
     def initialize(args = {})
       @__async_initialized__ = false
       defaults = {}
       defaults[:version] = nil
-      defaults[:service_url] = "https://gateway.watsonplatform.net/assistant/api"
+      defaults[:service_url] = DEFAULT_SERVICE_URL
+      defaults[:service_name] = DEFAULT_SERVICE_NAME
       defaults[:authenticator] = nil
+      user_service_url = args[:service_url] unless args[:service_url].nil?
       args = defaults.merge(args)
       @version = args[:version]
       raise ArgumentError.new("version must be provided") if @version.nil?
 
-      args[:service_name] = "assistant"
       args[:authenticator] = IBMCloudSdkCore::ConfigBasedAuthenticatorFactory.new.get_authenticator(service_name: args[:service_name]) if args[:authenticator].nil?
       super
+      @service_url = user_service_url unless user_service_url.nil?
     end
 
     #########################
@@ -78,9 +84,7 @@ module IBMWatson
     #   **Important:** This method has been superseded by the new v2 runtime API. The v2
     #   API offers significant advantages, including ease of deployment, automatic state
     #   management, versioning, and search capabilities. For more information, see the
-    #   [documentation](https://cloud.ibm.com/docs/services/assistant?topic=assistant-api-overview).
-    #
-    #   There is no rate limit for this operation.
+    #   [documentation](https://cloud.ibm.com/docs/assistant?topic=assistant-api-overview).
     # @param workspace_id [String] Unique identifier of the workspace.
     # @param input [MessageInput] An input object that includes the input text.
     # @param intents [Array[RuntimeIntent]] Intents to use when evaluating the user input. Include intents from the previous
@@ -140,9 +144,6 @@ module IBMWatson
     # @!method list_workspaces(page_limit: 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 sort [String] The attribute by which returned workspaces will be sorted. To reverse the sort
     #   order, prefix the value with a minus sign (`-`).
@@ -177,13 +178,10 @@ module IBMWatson
     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, webhooks: nil)
+    # @!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, webhooks: nil, include_audit: nil)
     # Create workspace.
     # Create a workspace based on component objects. You must provide workspace
     #   components defining the content of the new workspace.
-    #
-    #   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.
     # @param description [String] The description of the workspace. This string cannot contain carriage return,
@@ -200,15 +198,18 @@ module IBMWatson
     # @param counterexamples [Array[Counterexample]] An array of objects defining input examples that have been marked as irrelevant
     #   input.
     # @param webhooks [Array[Webhook]]
+    # @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_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, webhooks: nil)
+    def 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, webhooks: nil, include_audit: nil)
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "create_workspace")
       headers.merge!(sdk_headers)
 
       params = {
-        "version" => @version
+        "version" => @version,
+        "include_audit" => include_audit
       }
 
       data = {
@@ -242,10 +243,6 @@ module IBMWatson
     # @!method get_workspace(workspace_id:, export: nil, include_audit: nil, sort: nil)
     # Get information about a workspace.
     # Get information about a workspace, optionally including all workspace content.
-    #
-    #   With **export**=`false`, this operation is limited to 6000 requests per 5 minutes.
-    #   With **export**=`true`, the limit is 20 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
@@ -284,13 +281,10 @@ module IBMWatson
     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, webhooks: nil, append: nil)
+    # @!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, webhooks: nil, append: nil, include_audit: nil)
     # Update workspace.
     # Update an existing workspace with new or modified data. You must provide component
     #   objects defining the content of the updated workspace.
-    #
-    #   This operation is limited to 30 request per 30 minutes. For more information, see
-    #   **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.
@@ -308,17 +302,20 @@ module IBMWatson
     # @param counterexamples [Array[Counterexample]] An array of objects defining input examples that have been marked as irrelevant
     #   input.
     # @param webhooks [Array[Webhook]]
-    # @param append [Boolean] Whether the new data is to be appended to the existing data in the workspace. If
+    # @param append [Boolean] Whether the new data is to be appended to the existing data in the object. If
     #   **append**=`false`, elements included in the new data completely replace the
     #   corresponding existing elements, including all subelements. For example, if the
-    #   new data includes **entities** and **append**=`false`, all existing entities in
-    #   the workspace are discarded and replaced with the new entities.
+    #   new data for a workspace includes **entities** and **append**=`false`, all
+    #   existing entities in the workspace are discarded and replaced with the new
+    #   entities.
     #
     #   If **append**=`true`, existing elements are preserved, and the new elements are
     #   added. If any elements in the new data collide with existing elements, the update
     #   request fails.
+    # @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_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, webhooks: nil, append: nil)
+    def 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, webhooks: nil, append: nil, include_audit: nil)
       raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
 
       headers = {
@@ -328,7 +325,8 @@ module IBMWatson
 
       params = {
         "version" => @version,
-        "append" => append
+        "append" => append,
+        "include_audit" => include_audit
       }
 
       data = {
@@ -362,9 +360,6 @@ module IBMWatson
     # @!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:)
@@ -398,10 +393,6 @@ module IBMWatson
     # @!method list_intents(workspace_id:, export: nil, page_limit: nil, sort: nil, cursor: nil, include_audit: nil)
     # List intents.
     # List the intents for a workspace.
-    #
-    #   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
@@ -443,15 +434,12 @@ module IBMWatson
     end
 
     ##
-    # @!method create_intent(workspace_id:, intent:, description: nil, examples: nil)
+    # @!method create_intent(workspace_id:, intent:, description: nil, examples: nil, include_audit: 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 name of the intent. This string must conform to the following restrictions:
     #   - It can contain only Unicode alphanumeric, underscore, hyphen, and dot
@@ -460,8 +448,10 @@ module IBMWatson
     # @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.
+    # @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 create_intent(workspace_id:, intent:, description: nil, examples: 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?
@@ -472,7 +462,8 @@ module IBMWatson
       headers.merge!(sdk_headers)
 
       params = {
-        "version" => @version
+        "version" => @version,
+        "include_audit" => include_audit
       }
 
       data = {
@@ -498,10 +489,6 @@ module IBMWatson
     # @!method get_intent(workspace_id:, intent:, export: nil, include_audit: nil)
     # Get intent.
     # Get information about an intent, optionally including all intent content.
-    #
-    #   With **export**=`false`, this operation is limited to 6000 requests per 5 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 intent name.
     # @param export [Boolean] Whether to include all element content in the returned data. If
@@ -539,16 +526,13 @@ module IBMWatson
     end
 
     ##
-    # @!method update_intent(workspace_id:, intent:, new_intent: nil, new_description: nil, new_examples: nil)
+    # @!method update_intent(workspace_id:, intent:, new_intent: nil, new_description: nil, new_examples: nil, append: nil, include_audit: nil)
     # Update intent.
     # Update an existing intent with new or modified data. You must provide component
     #   objects defining the content of the updated intent.
     #
     #   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:
@@ -558,8 +542,19 @@ module IBMWatson
     # @param new_description [String] The description of the intent. This string cannot contain carriage return,
     #   newline, or tab characters.
     # @param new_examples [Array[Example]] An array of user input examples for the intent.
+    # @param append [Boolean] Whether the new data is to be appended to the existing data in the object. If
+    #   **append**=`false`, elements included in the new data completely replace the
+    #   corresponding existing elements, including all subelements. For example, if the
+    #   new data for the intent includes **examples** and **append**=`false`, all existing
+    #   examples for the intent are discarded and replaced with the new examples.
+    #
+    #   If **append**=`true`, existing elements are preserved, and the new elements are
+    #   added. If any elements in the new data collide with existing elements, the update
+    #   request fails.
+    # @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_intent(workspace_id:, intent:, new_intent: nil, new_description: nil, new_examples: nil)
+    def update_intent(workspace_id:, intent:, new_intent: nil, new_description: nil, new_examples: nil, append: 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?
@@ -570,7 +565,9 @@ module IBMWatson
       headers.merge!(sdk_headers)
 
       params = {
-        "version" => @version
+        "version" => @version,
+        "append" => append,
+        "include_audit" => include_audit
       }
 
       data = {
@@ -596,9 +593,6 @@ module IBMWatson
     # @!method delete_intent(workspace_id:, intent:)
     # Delete intent.
     # Delete an intent from a workspace.
-    #
-    #   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]
@@ -636,9 +630,6 @@ module IBMWatson
     # List user input examples.
     # List the user input examples for an intent, optionally including contextual entity
     #   mentions.
-    #
-    #   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 page_limit [Fixnum] The number of records to return in each page of results.
@@ -679,15 +670,12 @@ module IBMWatson
     end
 
     ##
-    # @!method create_example(workspace_id:, intent:, text:, mentions: nil)
+    # @!method create_example(workspace_id:, intent:, text:, mentions: nil, include_audit: nil)
     # Create user input example.
     # Add a new user input example to an intent.
     #
-    #   If you want to add multiple exaples with a single API call, consider using the
+    #   If you want to add 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.
     # @param intent [String] The intent name.
     # @param text [String] The text of a user input example. This string must conform to the following
@@ -695,8 +683,10 @@ module IBMWatson
     #   - 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.
+    # @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_example(workspace_id:, intent:, text:, mentions: nil)
+    def create_example(workspace_id:, intent:, text:, mentions: 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?
@@ -709,7 +699,8 @@ module IBMWatson
       headers.merge!(sdk_headers)
 
       params = {
-        "version" => @version
+        "version" => @version,
+        "include_audit" => include_audit
       }
 
       data = {
@@ -734,9 +725,6 @@ module IBMWatson
     # @!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 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 text [String] The text of the user input example.
@@ -773,15 +761,12 @@ module IBMWatson
     end
 
     ##
-    # @!method update_example(workspace_id:, intent:, text:, new_text: nil, new_mentions: nil)
+    # @!method update_example(workspace_id:, intent:, text:, new_text: nil, new_mentions: nil, include_audit: nil)
     # 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.
     # @param intent [String] The intent name.
     # @param text [String] The text of the user input example.
@@ -790,8 +775,10 @@ module IBMWatson
     #   - It cannot contain carriage return, newline, or tab characters.
     #   - It cannot consist of only whitespace characters.
     # @param new_mentions [Array[Mention]] An array of contextual entity mentions.
+    # @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_example(workspace_id:, intent:, text:, new_text: nil, new_mentions: nil)
+    def update_example(workspace_id:, intent:, text:, new_text: nil, new_mentions: 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?
@@ -804,7 +791,8 @@ module IBMWatson
       headers.merge!(sdk_headers)
 
       params = {
-        "version" => @version
+        "version" => @version,
+        "include_audit" => include_audit
       }
 
       data = {
@@ -829,9 +817,6 @@ module IBMWatson
     # @!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 intent [String] The intent name.
     # @param text [String] The text of the user input example.
@@ -872,9 +857,6 @@ module IBMWatson
     # List counterexamples.
     # List the counterexamples for a workspace. Counterexamples are examples that have
     #   been marked as irrelevant input.
-    #
-    #   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 sort [String] The attribute by which returned counterexamples will be sorted. To reverse the
@@ -912,23 +894,22 @@ module IBMWatson
     end
 
     ##
-    # @!method create_counterexample(workspace_id:, text:)
+    # @!method create_counterexample(workspace_id:, text:, include_audit: nil)
     # Create counterexample.
     # Add a new counterexample to a workspace. Counterexamples are examples that have
     #   been marked as irrelevant input.
     #
     #   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 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.
+    # @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_counterexample(workspace_id:, text:)
+    def create_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?
@@ -939,7 +920,8 @@ module IBMWatson
       headers.merge!(sdk_headers)
 
       params = {
-        "version" => @version
+        "version" => @version,
+        "include_audit" => include_audit
       }
 
       data = {
@@ -964,9 +946,6 @@ module IBMWatson
     # Get counterexample.
     # Get information about a counterexample. Counterexamples are examples that have
     #   been marked as irrelevant input.
-    #
-    #   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 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
@@ -1000,24 +979,20 @@ module IBMWatson
     end
 
     ##
-    # @!method update_counterexample(workspace_id:, text:, new_text: nil)
+    # @!method update_counterexample(workspace_id:, text:, new_text: nil, include_audit: nil)
     # Update counterexample.
     # 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.
+    # @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_counterexample(workspace_id:, text:, new_text: nil)
+    def update_counterexample(workspace_id:, text:, new_text: 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?
@@ -1028,7 +1003,8 @@ module IBMWatson
       headers.merge!(sdk_headers)
 
       params = {
-        "version" => @version
+        "version" => @version,
+        "include_audit" => include_audit
       }
 
       data = {
@@ -1053,9 +1029,6 @@ module IBMWatson
     # 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]
@@ -1092,10 +1065,6 @@ module IBMWatson
     # @!method list_entities(workspace_id:, export: nil, page_limit: 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
@@ -1137,15 +1106,12 @@ module IBMWatson
     end
 
     ##
-    # @!method create_entity(workspace_id:, entity:, description: nil, metadata: nil, fuzzy_match: nil, values: nil)
+    # @!method create_entity(workspace_id:, entity:, description: nil, metadata: nil, fuzzy_match: nil, values: nil, include_audit: 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.
@@ -1157,8 +1123,10 @@ module IBMWatson
     # @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.
+    # @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_entity(workspace_id:, entity:, description: nil, metadata: nil, fuzzy_match: nil, values: nil)
+    def create_entity(workspace_id:, entity:, description: nil, metadata: nil, fuzzy_match: nil, values: 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?
@@ -1169,7 +1137,8 @@ module IBMWatson
       headers.merge!(sdk_headers)
 
       params = {
-        "version" => @version
+        "version" => @version,
+        "include_audit" => include_audit
       }
 
       data = {
@@ -1197,10 +1166,6 @@ module IBMWatson
     # @!method get_entity(workspace_id:, entity:, export: nil, include_audit: nil)
     # Get entity.
     # Get information about an entity, optionally including all entity content.
-    #
-    #   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.
     # @param export [Boolean] Whether to include all element content in the returned data. If
@@ -1238,16 +1203,13 @@ module IBMWatson
     end
 
     ##
-    # @!method update_entity(workspace_id:, entity:, new_entity: nil, new_description: nil, new_metadata: nil, new_fuzzy_match: nil, new_values: nil)
+    # @!method update_entity(workspace_id:, entity:, new_entity: nil, new_description: nil, new_metadata: nil, new_fuzzy_match: nil, new_values: nil, append: nil, include_audit: nil)
     # Update entity.
     # Update an existing entity with new or modified data. You must provide component
     #   objects defining the content of the updated entity.
     #
     #   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 new_entity [String] The name of the entity. This string must conform to the following restrictions:
@@ -1258,8 +1220,19 @@ module IBMWatson
     # @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 append [Boolean] Whether the new data is to be appended to the existing data in the entity. If
+    #   **append**=`false`, elements included in the new data completely replace the
+    #   corresponding existing elements, including all subelements. For example, if the
+    #   new data for the entity includes **values** and **append**=`false`, all existing
+    #   values for the entity are discarded and replaced with the new values.
+    #
+    #   If **append**=`true`, existing elements are preserved, and the new elements are
+    #   added. If any elements in the new data collide with existing elements, the update
+    #   request fails.
+    # @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 update_entity(workspace_id:, entity:, new_entity: nil, new_description: nil, new_metadata: nil, new_fuzzy_match: nil, new_values: nil, append: 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?
@@ -1270,7 +1243,9 @@ module IBMWatson
       headers.merge!(sdk_headers)
 
       params = {
-        "version" => @version
+        "version" => @version,
+        "append" => append,
+        "include_audit" => include_audit
       }
 
       data = {
@@ -1298,9 +1273,6 @@ module IBMWatson
     # @!method delete_entity(workspace_id:, entity:)
     # Delete entity.
     # Delete an entity from a workspace, or disable a system 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.
     # @return [nil]
@@ -1338,9 +1310,6 @@ module IBMWatson
     # 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 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 export [Boolean] Whether to include all element content in the returned data. If
@@ -1384,9 +1353,6 @@ module IBMWatson
     # @!method list_values(workspace_id:, entity:, export: nil, page_limit: 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
@@ -1431,15 +1397,12 @@ module IBMWatson
     end
 
     ##
-    # @!method create_value(workspace_id:, entity:, value:, metadata: nil, type: nil, synonyms: nil, patterns: nil)
+    # @!method create_value(workspace_id:, entity:, value:, metadata: nil, type: nil, synonyms: nil, patterns: nil, include_audit: 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.
     # @param entity [String] The name of the entity.
     # @param value [String] The text of the entity value. This string must conform to the following
@@ -1456,9 +1419,11 @@ module IBMWatson
     # @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; 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).
+    #   [documentation](https://cloud.ibm.com/docs/assistant?topic=assistant-entities#entities-create-dictionary-based).
+    # @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_value(workspace_id:, entity:, value:, metadata: nil, type: nil, synonyms: nil, patterns: nil)
+    def create_value(workspace_id:, entity:, value:, metadata: nil, type: nil, synonyms: nil, patterns: 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?
@@ -1471,7 +1436,8 @@ module IBMWatson
       headers.merge!(sdk_headers)
 
       params = {
-        "version" => @version
+        "version" => @version,
+        "include_audit" => include_audit
       }
 
       data = {
@@ -1499,9 +1465,6 @@ module IBMWatson
     # @!method get_value(workspace_id:, entity:, value:, export: nil, include_audit: nil)
     # Get entity value.
     # Get information about an entity value.
-    #
-    #   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.
@@ -1542,16 +1505,13 @@ module IBMWatson
     end
 
     ##
-    # @!method update_value(workspace_id:, entity:, value:, new_value: nil, new_metadata: nil, new_type: nil, new_synonyms: nil, new_patterns: nil)
+    # @!method update_value(workspace_id:, entity:, value:, new_value: nil, new_metadata: nil, new_type: nil, new_synonyms: nil, new_patterns: nil, append: nil, include_audit: 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.
     # @param entity [String] The name of the entity.
     # @param value [String] The text of the entity value.
@@ -1569,9 +1529,21 @@ module IBMWatson
     # @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; 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).
+    #   [documentation](https://cloud.ibm.com/docs/assistant?topic=assistant-entities#entities-create-dictionary-based).
+    # @param append [Boolean] Whether the new data is to be appended to the existing data in the entity value.
+    #   If **append**=`false`, elements included in the new data completely replace the
+    #   corresponding existing elements, including all subelements. For example, if the
+    #   new data for the entity value includes **synonyms** and **append**=`false`, all
+    #   existing synonyms for the entity value are discarded and replaced with the new
+    #   synonyms.
+    #
+    #   If **append**=`true`, existing elements are preserved, and the new elements are
+    #   added. If any elements in the new data collide with existing elements, the update
+    #   request fails.
+    # @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_value(workspace_id:, entity:, value:, new_value: nil, new_metadata: nil, new_type: nil, new_synonyms: nil, new_patterns: nil)
+    def update_value(workspace_id:, entity:, value:, new_value: nil, new_metadata: nil, new_type: nil, new_synonyms: nil, new_patterns: nil, append: 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?
@@ -1584,7 +1556,9 @@ module IBMWatson
       headers.merge!(sdk_headers)
 
       params = {
-        "version" => @version
+        "version" => @version,
+        "append" => append,
+        "include_audit" => include_audit
       }
 
       data = {
@@ -1612,9 +1586,6 @@ module IBMWatson
     # @!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.
@@ -1654,9 +1625,6 @@ module IBMWatson
     # @!method list_synonyms(workspace_id:, entity:, value:, page_limit: nil, sort: nil, cursor: nil, include_audit: nil)
     # List entity value synonyms.
     # List the synonyms for an entity value.
-    #
-    #   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.
@@ -1700,24 +1668,23 @@ module IBMWatson
     end
 
     ##
-    # @!method create_synonym(workspace_id:, entity:, value:, synonym:)
+    # @!method create_synonym(workspace_id:, entity:, value:, synonym:, include_audit: nil)
     # Create entity value synonym.
     # Add a new synonym to an entity value.
     #
     #   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. 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 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_synonym(workspace_id:, entity:, value:, synonym:)
+    def create_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?
@@ -1732,7 +1699,8 @@ module IBMWatson
       headers.merge!(sdk_headers)
 
       params = {
-        "version" => @version
+        "version" => @version,
+        "include_audit" => include_audit
       }
 
       data = {
@@ -1756,9 +1724,6 @@ module IBMWatson
     # @!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 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.
@@ -1798,16 +1763,13 @@ module IBMWatson
     end
 
     ##
-    # @!method update_synonym(workspace_id:, entity:, value:, synonym:, new_synonym: nil)
+    # @!method update_synonym(workspace_id:, entity:, value:, synonym:, new_synonym: nil, include_audit: nil)
     # 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.
     # @param entity [String] The name of the entity.
     # @param value [String] The text of the entity value.
@@ -1815,8 +1777,10 @@ 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.
+    # @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_synonym(workspace_id:, entity:, value:, synonym:, new_synonym: nil)
+    def update_synonym(workspace_id:, entity:, value:, synonym:, new_synonym: 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?
@@ -1831,7 +1795,8 @@ module IBMWatson
       headers.merge!(sdk_headers)
 
       params = {
-        "version" => @version
+        "version" => @version,
+        "include_audit" => include_audit
       }
 
       data = {
@@ -1855,9 +1820,6 @@ module IBMWatson
     # @!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.
@@ -1900,9 +1862,6 @@ module IBMWatson
     # @!method list_dialog_nodes(workspace_id:, page_limit: 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 sort [String] The attribute by which returned dialog nodes will be sorted. To reverse the sort
@@ -1940,15 +1899,12 @@ module IBMWatson
     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, type: nil, event_name: nil, variable: nil, actions: nil, digress_in: nil, digress_out: nil, digress_out_slots: nil, user_label: nil, disambiguation_opt_out: nil)
+    # @!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, type: nil, event_name: nil, variable: nil, actions: nil, digress_in: nil, digress_out: nil, digress_out_slots: nil, user_label: nil, disambiguation_opt_out: nil, include_audit: 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
@@ -1963,7 +1919,7 @@ module IBMWatson
     #   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?topic=assistant-dialog-overview#dialog-overview-responses).
+    #   [documentation](https://cloud.ibm.com/docs/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.
@@ -1980,9 +1936,12 @@ module IBMWatson
     # @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.
-    # @param disambiguation_opt_out [Boolean] Whether the dialog node should be excluded from disambiguation suggestions.
+    # @param disambiguation_opt_out [Boolean] Whether the dialog node should be excluded from disambiguation suggestions. Valid
+    #   only when **type**=`standard` or `frame`.
+    # @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_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, type: nil, event_name: nil, variable: nil, actions: nil, digress_in: nil, digress_out: nil, digress_out_slots: nil, user_label: nil, disambiguation_opt_out: nil)
+    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, type: nil, event_name: nil, variable: nil, actions: nil, digress_in: nil, digress_out: nil, digress_out_slots: nil, user_label: nil, disambiguation_opt_out: nil, include_audit: nil)
       raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
 
       raise ArgumentError.new("dialog_node must be provided") if dialog_node.nil?
@@ -1993,7 +1952,8 @@ module IBMWatson
       headers.merge!(sdk_headers)
 
       params = {
-        "version" => @version
+        "version" => @version,
+        "include_audit" => include_audit
       }
 
       data = {
@@ -2035,9 +1995,6 @@ module IBMWatson
     # @!method get_dialog_node(workspace_id:, dialog_node:, include_audit: nil)
     # Get dialog node.
     # Get information about a dialog node.
-    #
-    #   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 dialog_node [String] The dialog node ID (for example, `get_order`).
     # @param include_audit [Boolean] Whether to include the audit properties (`created` and `updated` timestamps) in
@@ -2071,15 +2028,12 @@ module IBMWatson
     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_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, new_disambiguation_opt_out: nil)
+    # @!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_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, new_disambiguation_opt_out: nil, include_audit: 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.
     # @param dialog_node [String] The dialog node ID (for example, `get_order`).
     # @param new_dialog_node [String] The dialog node ID. This string must conform to the following restrictions:
@@ -2095,7 +2049,7 @@ module IBMWatson
     #   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?topic=assistant-dialog-overview#dialog-overview-responses).
+    #   [documentation](https://cloud.ibm.com/docs/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.
@@ -2112,9 +2066,12 @@ module IBMWatson
     # @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.
-    # @param new_disambiguation_opt_out [Boolean] Whether the dialog node should be excluded from disambiguation suggestions.
+    # @param new_disambiguation_opt_out [Boolean] Whether the dialog node should be excluded from disambiguation suggestions. Valid
+    #   only when **type**=`standard` or `frame`.
+    # @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_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_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, new_disambiguation_opt_out: nil)
+    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_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, new_disambiguation_opt_out: nil, include_audit: nil)
       raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
 
       raise ArgumentError.new("dialog_node must be provided") if dialog_node.nil?
@@ -2125,7 +2082,8 @@ module IBMWatson
       headers.merge!(sdk_headers)
 
       params = {
-        "version" => @version
+        "version" => @version,
+        "include_audit" => include_audit
       }
 
       data = {
@@ -2167,9 +2125,6 @@ module IBMWatson
     # @!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]
@@ -2206,16 +2161,12 @@ module IBMWatson
     # @!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 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).
+    #   [documentation](https://cloud.ibm.com/docs/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.
@@ -2251,15 +2202,11 @@ module IBMWatson
     # @!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 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 `request.context.system.assistant_id`, `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).
+    #   [documentation](https://cloud.ibm.com/docs/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 page_limit [Fixnum] The number of records to return in each page of results.
@@ -2305,10 +2252,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?topic=assistant-information-security#information-security).
-    #
-    #   This operation is limited to 4 requests per minute. For more information, see
-    #   **Rate limiting**.
+    #   security](https://cloud.ibm.com/docs/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:)