ibm_watson 1.6.0 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 409d6967d2bafb4da4062a2f5f5e6db07a110094af4ebb021782349907066d80
-  data.tar.gz: a4ec07dda5cf80e87b24f13c430d042cdced5805b40001aa8cd94052fd5b2c8f
+  metadata.gz: a856f95170a6ba51cbb7ea7dc4e04e9e5f99ed57d292c642b566e1c9017c3e9e
+  data.tar.gz: e81652472da29d3032abef05ebd539b639f73be51f0e91455d19bea389c29105
 SHA512:
-  metadata.gz: c27789e4c9a650579efe3547833dbb329394ca3b3db339bb5b36c4203e973915f6be60142e55ea35a034be47627200a9d4e5387edd0fcbb75491e7a5122b3c78
-  data.tar.gz: 7c5b71128abfaff86e6f648bf07932357f01f6574d5ca3f27553ff17a851ed6e0abc037af56a9be4e64d4aa8a1d7ef645d534a852fd2653b54f5e0d9c343723c
+  metadata.gz: b63bfa564a2e2ddefd1de282f0e0d228211fcfcd8f662136c8fe77a870f39e28b6e88772460aa9b43a652e523c16f116449de79c340bb72d94e3a9f962b95992
+  data.tar.gz: 7d5ec257697c47db06505a8948ed27e434eab18bb56171d298d9569a3c1cd7cae2711a7a19cb63d78d97ba32fa54a8d1da60db8716e5e3c04b3e2ad2a3517235

data/README.md

@@ -1,13 +1,17 @@
 # IBM Watson Ruby SDK
 
-[![Build Status](https://travis-ci.org/watson-developer-cloud/ruby-sdk.svg)](https://travis-ci.org/watson-developer-cloud/ruby-sdk)
-[![Build status](https://ci.appveyor.com/api/projects/status/ir3k0ue138o4u67e?svg=true)](https://ci.appveyor.com/project/maxnussbaum/ruby-sdk)
+[![Build and Test](https://github.com/watson-developer-cloud/ruby-sdk/workflows/Build%20and%20Test/badge.svg?branch=master)](https://github.com/watson-developer-cloud/ruby-sdk/actions?query=workflow%3A"Build+and+Test")
+[![Deploy and Publish](https://github.com/watson-developer-cloud/ruby-sdk/workflows/Deploy%20and%20Publish/badge.svg?branch=master)](https://github.com/watson-developer-cloud/ruby-sdk/actions?query=workflow%3A%22Deploy+and+Publish%22)
 [![Slack](https://wdc-slack-inviter.mybluemix.net/badge.svg)](https://wdc-slack-inviter.mybluemix.net)
 [![codecov.io](https://codecov.io/github/watson-developer-cloud/ruby-sdk/coverage.svg)](https://codecov.io/github/watson-developer-cloud/ruby-sdk)
 [![Gem Version](https://badge.fury.io/rb/ibm_watson.svg)](https://badge.fury.io/rb/ibm_watson)
 [![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release)
 [![CLA assistant](https://cla-assistant.io/readme/badge/watson-developer-cloud/ruby-sdk)](https://cla-assistant.io/watson-developer-cloud/ruby-sdk)
 
+## Deprecated builds
+[![Build Status](https://travis-ci.org/watson-developer-cloud/ruby-sdk.svg)](https://travis-ci.org/watson-developer-cloud/ruby-sdk)
+[![Build status](https://ci.appveyor.com/api/projects/status/ir3k0ue138o4u67e?svg=true)](https://ci.appveyor.com/project/maxnussbaum/ruby-sdk)
+
 Ruby gem to quickly get started with the various [IBM Watson][wdc] services.
 
 <details>
@@ -34,6 +38,24 @@ Ruby gem to quickly get started with the various [IBM Watson][wdc] services.
 
 </details>
 
+## Announcements
+### Support for 2.7 ruby
+To support 2.7 the http gem dependency is updated to 4.4.0. Since it conflicted with the dependency in the ruby-sdk-core that gem was also updated.  Using 2.0.2 or above ruby sdk will require a core of 1.1.3 or above.
+
+### Updating endpoint URLs from watsonplatform.net
+Watson API endpoint URLs at watsonplatform.net are changing and will not work after 26 May 2021. Update your calls to use the newer endpoint URLs. For more information, see https://cloud.ibm.com/docs/watson?topic=watson-endpoint-change.
+
+### Personality Insights deprecation
+IBM Watson™ Personality Insights is discontinued. For a period of one year from 1 December 2020, you will still be able to use Watson Personality Insights. However, as of 1 December 2021, the offering will no longer be available.
+
+As an alternative, we encourage you to consider migrating to IBM Watson™ [Natural Language Understanding](https://cloud.ibm.com/docs/natural-language-understanding), a service on IBM Cloud® that uses deep learning to extract data and insights from text such as keywords, categories, sentiment, emotion, and syntax to provide insights for your business or industry. For more information, see About Natural Language Understanding.
+
+### Visual Recognition deprecation
+IBM Watson™ Visual Recognition is discontinued. Existing instances are supported until 1 December 2021, but as of 7 January 2021, you can't create instances. Any instance that is provisioned on 1 December 2021 will be deleted.
+
+### Compare and Comply deprecation
+IBM Watson™ Compare and Comply is discontinued. Existing instances are supported until 30 November 2021, but as of 1 December 2020, you can't create instances. Any instance that exists on 30 November 2021 will be deleted. Consider migrating to Watson Discovery Premium on IBM Cloud for your Compare and Comply use cases. To start the migration process, visit https://ibm.biz/contact-wdc-premium.
+
 ## Before you begin
 
 * You need an [IBM Cloud][ibm-cloud-onboarding] account.
@@ -106,7 +128,7 @@ The file downloaded will be called `ibm-credentials.env`. This is the name the S
 discovery = DiscoveryV1(version: "2018-08-01")
 ```
 
- And that's it!
+ And that's it! 
 
  If you're using more than one service at a time in your code and get two different `ibm-credentials.env` files, just put the contents together in one `ibm-credentials.env` file and the SDK will handle assigning credentials to their appropriate services.
 
@@ -269,7 +291,7 @@ 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.
+Every SDK call returns a response with a transaction ID in the `X-Global-Transaction-Id` header. Together the service instance region, this ID helps support teams troubleshoot issues from relevant logs.
 
 ```ruby
 require "ibm_watson"
@@ -289,6 +311,22 @@ rescue IBMCloudSdkCore::ApiException => e
 end
 ```
 
+However, the transaction ID isn't available when the API doesn't return a response for some reason. In that case, you can set your own transaction ID in the request. For example, replace `<my-unique-transaction-id>` in the following example with a unique transaction ID.
+
+```ruby
+require "ibm_watson"
+include IBMWatson
+
+assistant = AssistantV1.new(
+  authenticator: "<authenticator>"
+  version: "2017-04-21"
+)
+
+response = assistant.headers(
+  "X-Global-Transaction-Id" => "<my-unique-transaction-id>"
+  ).list_workspaces
+```
+
 ## Configuring the HTTP client
 
 To set client configs like timeout or proxy use the `configure_http_client` function and pass in the configurations.

data/lib/ibm_watson/assistant_v1.rb

@@ -13,7 +13,9 @@
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
-
+#
+# IBM OpenAPI SDK Code Generator Version: 3.31.0-902c9336-20210504-161156
+#
 # The IBM Watson™ Assistant service combines machine learning, natural language
 # understanding, and an integrated dialog editor to create conversation flows between your
 # apps and your users.
@@ -27,7 +29,6 @@ require "json"
 require "ibm_cloud_sdk_core"
 require_relative "./common.rb"
 
-# Module for the Watson APIs
 module IBMWatson
   ##
   # The Assistant V1 service.
@@ -35,21 +36,14 @@ module IBMWatson
     include Concurrent::Async
     DEFAULT_SERVICE_NAME = "assistant"
     DEFAULT_SERVICE_URL = "https://api.us-south.assistant.watson.cloud.ibm.com"
+    attr_accessor :version
     ##
     # @!method initialize(args)
     # Construct a new client for the Assistant service.
     #
     # @param args [Hash] The args to initialize with
-    # @option args version [String] The API version date to use with the service, in
-    #   "YYYY-MM-DD" format. Whenever the API is changed in a backwards
-    #   incompatible way, a new minor version of the API is released.
-    #   The service uses the API version for the date you specify, or
-    #   the most recent version before that date. Note that you should
-    #   not programmatically specify the current date at runtime, in
-    #   case the API has been updated since your application's release.
-    #   Instead, specify a version date that is compatible with your
-    #   application, and don't change it until your application is
-    #   ready for a later version.
+    # @option args version [String] Release date of the API version you want to use. Specify dates in YYYY-MM-DD
+    #   format. The current version is `2020-04-01`.
     # @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.
@@ -58,10 +52,10 @@ module IBMWatson
     def initialize(args = {})
       @__async_initialized__ = false
       defaults = {}
-      defaults[:version] = nil
       defaults[:service_url] = DEFAULT_SERVICE_URL
       defaults[:service_name] = DEFAULT_SERVICE_NAME
       defaults[:authenticator] = nil
+      defaults[:version] = nil
       user_service_url = args[:service_url] unless args[:service_url].nil?
       args = defaults.merge(args)
       @version = args[:version]
@@ -77,7 +71,7 @@ module IBMWatson
     #########################
 
     ##
-    # @!method message(workspace_id:, input: nil, intents: nil, entities: nil, alternate_intents: nil, context: nil, output: nil, nodes_visited_details: nil)
+    # @!method message(workspace_id:, input: nil, intents: nil, entities: nil, alternate_intents: nil, context: nil, output: nil, user_id: nil, nodes_visited_details: nil)
     # Get response to user input.
     # Send user input to a workspace and receive a response.
     #
@@ -99,12 +93,24 @@ module IBMWatson
     #   from the previous response.
     # @param output [OutputData] An output object that includes the response to the user, the dialog nodes that
     #   were triggered, and messages from the log.
+    # @param user_id [String] A string value that identifies the user who is interacting with the workspace. The
+    #   client must provide a unique identifier for each individual end user who accesses
+    #   the application. For user-based plans, this user ID is used to identify unique
+    #   users for billing purposes. This string cannot contain carriage return, newline,
+    #   or tab characters. If no value is specified in the input, **user_id** is
+    #   automatically set to the value of **context.conversation_id**.
+    #
+    #   **Note:** This property is the same as the **user_id** property in the context
+    #   metadata. If **user_id** is specified in both locations in a message request, the
+    #   value specified at the root is used.
     # @param nodes_visited_details [Boolean] Whether to include additional diagnostic information about the dialog nodes that
     #   were visited during processing of the message.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def message(workspace_id:, input: nil, intents: nil, entities: nil, alternate_intents: nil, context: nil, output: nil, nodes_visited_details: nil)
+    def message(workspace_id:, input: nil, intents: nil, entities: nil, alternate_intents: nil, context: nil, output: nil, user_id: nil, nodes_visited_details: nil)
       raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
 
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "message")
@@ -121,7 +127,8 @@ module IBMWatson
         "entities" => entities,
         "alternate_intents" => alternate_intents,
         "context" => context,
-        "output" => output
+        "output" => output,
+        "user_id" => user_id
       }
 
       method_url = "/v1/workspaces/%s/message" % [ERB::Util.url_encode(workspace_id)]
@@ -137,21 +144,71 @@ module IBMWatson
       response
     end
     #########################
+    # Bulk classify
+    #########################
+
+    ##
+    # @!method bulk_classify(workspace_id:, input: nil)
+    # Identify intents and entities in multiple user utterances.
+    # Send multiple user inputs to a workspace in a single request and receive
+    #   information about the intents and entities recognized in each input. This method
+    #   is useful for testing and comparing the performance of different workspaces.
+    #
+    #   This method is available only with Enterprise with Data Isolation plans.
+    # @param workspace_id [String] Unique identifier of the workspace.
+    # @param input [Array[BulkClassifyUtterance]] An array of input utterances to classify.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def bulk_classify(workspace_id:, input: nil)
+      raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
+
+      raise ArgumentError.new("version must be provided") if version.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "bulk_classify")
+      headers.merge!(sdk_headers)
+
+      params = {
+        "version" => @version
+      }
+
+      data = {
+        "input" => input
+      }
+
+      method_url = "/v1/workspaces/%s/bulk_classify" % [ERB::Util.url_encode(workspace_id)]
+
+      response = request(
+        method: "POST",
+        url: method_url,
+        headers: headers,
+        params: params,
+        json: data,
+        accept_json: true
+      )
+      response
+    end
+    #########################
     # Workspaces
     #########################
 
     ##
-    # @!method list_workspaces(page_limit: nil, sort: nil, cursor: nil, include_audit: nil)
+    # @!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.
     # @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 that satisfy the
+    #   request, regardless of the page limit. If this parameter is `true`, the
+    #   `pagination` object in the response includes the `total` property.
     # @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, sort: nil, cursor: nil, include_audit: nil)
+    def list_workspaces(page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "list_workspaces")
@@ -160,6 +217,7 @@ module IBMWatson
       params = {
         "version" => @version,
         "page_limit" => page_limit,
+        "include_count" => include_count,
         "sort" => sort,
         "cursor" => cursor,
         "include_audit" => include_audit
@@ -178,7 +236,7 @@ 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, include_audit: nil)
+    # @!method create_workspace(name: nil, description: nil, language: nil, dialog_nodes: nil, counterexamples: nil, metadata: nil, learning_opt_out: nil, system_settings: nil, webhooks: nil, intents: nil, entities: 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.
@@ -187,21 +245,23 @@ module IBMWatson
     # @param description [String] The description of the workspace. This string cannot contain carriage return,
     #   newline, or tab characters.
     # @param language [String] The language of the workspace.
+    # @param dialog_nodes [Array[DialogNode]] An array of objects describing the dialog nodes in the workspace.
+    # @param counterexamples [Array[Counterexample]] An array of objects defining input examples that have been marked as irrelevant
+    #   input.
     # @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
     #   entities) can be used by IBM for general service improvements. `true` indicates
     #   that workspace training data is not to be used.
     # @param system_settings [WorkspaceSystemSettings] Global settings for the workspace.
+    # @param webhooks [Array[Webhook]]
     # @param intents [Array[CreateIntent]] An array of objects defining the intents for the workspace.
     # @param entities [Array[CreateEntity]] An array of objects describing the entities for the workspace.
-    # @param dialog_nodes [Array[DialogNode]] An array of objects describing the dialog nodes in the workspace.
-    # @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, include_audit: nil)
+    def create_workspace(name: nil, description: nil, language: nil, dialog_nodes: nil, counterexamples: nil, metadata: nil, learning_opt_out: nil, system_settings: nil, webhooks: nil, intents: nil, entities: nil, include_audit: nil)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "create_workspace")
@@ -216,14 +276,14 @@ module IBMWatson
         "name" => name,
         "description" => description,
         "language" => language,
+        "dialog_nodes" => dialog_nodes,
+        "counterexamples" => counterexamples,
         "metadata" => metadata,
         "learning_opt_out" => learning_opt_out,
         "system_settings" => system_settings,
+        "webhooks" => webhooks,
         "intents" => intents,
-        "entities" => entities,
-        "dialog_nodes" => dialog_nodes,
-        "counterexamples" => counterexamples,
-        "webhooks" => webhooks
+        "entities" => entities
       }
 
       method_url = "/v1/workspaces"
@@ -256,6 +316,8 @@ module IBMWatson
     def get_workspace(workspace_id:, export: nil, include_audit: nil, sort: nil)
       raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
 
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "get_workspace")
@@ -281,7 +343,7 @@ 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, include_audit: nil)
+    # @!method update_workspace(workspace_id:, name: nil, description: nil, language: nil, dialog_nodes: nil, counterexamples: nil, metadata: nil, learning_opt_out: nil, system_settings: nil, webhooks: nil, intents: nil, entities: 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.
@@ -291,17 +353,17 @@ module IBMWatson
     # @param description [String] The description of the workspace. This string cannot contain carriage return,
     #   newline, or tab characters.
     # @param language [String] The language of the workspace.
+    # @param dialog_nodes [Array[DialogNode]] An array of objects describing the dialog nodes in the workspace.
+    # @param counterexamples [Array[Counterexample]] An array of objects defining input examples that have been marked as irrelevant
+    #   input.
     # @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
     #   entities) can be used by IBM for general service improvements. `true` indicates
     #   that workspace training data is not to be used.
     # @param system_settings [WorkspaceSystemSettings] Global settings for the workspace.
+    # @param webhooks [Array[Webhook]]
     # @param intents [Array[CreateIntent]] An array of objects defining the intents for the workspace.
     # @param entities [Array[CreateEntity]] An array of objects describing the entities for the workspace.
-    # @param dialog_nodes [Array[DialogNode]] An array of objects describing the dialog nodes in the workspace.
-    # @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 object. If
     #   **append**=`false`, elements included in the new data completely replace the
     #   corresponding existing elements, including all subelements. For example, if the
@@ -315,9 +377,11 @@ module IBMWatson
     # @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, include_audit: nil)
+    def update_workspace(workspace_id:, name: nil, description: nil, language: nil, dialog_nodes: nil, counterexamples: nil, metadata: nil, learning_opt_out: nil, system_settings: nil, webhooks: nil, intents: nil, entities: nil, append: nil, include_audit: nil)
       raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
 
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "update_workspace")
@@ -333,14 +397,14 @@ module IBMWatson
         "name" => name,
         "description" => description,
         "language" => language,
+        "dialog_nodes" => dialog_nodes,
+        "counterexamples" => counterexamples,
         "metadata" => metadata,
         "learning_opt_out" => learning_opt_out,
         "system_settings" => system_settings,
+        "webhooks" => webhooks,
         "intents" => intents,
-        "entities" => entities,
-        "dialog_nodes" => dialog_nodes,
-        "counterexamples" => counterexamples,
-        "webhooks" => webhooks
+        "entities" => entities
       }
 
       method_url = "/v1/workspaces/%s" % [ERB::Util.url_encode(workspace_id)]
@@ -365,6 +429,8 @@ module IBMWatson
     def delete_workspace(workspace_id:)
       raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
 
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "delete_workspace")
@@ -390,7 +456,7 @@ module IBMWatson
     #########################
 
     ##
-    # @!method list_intents(workspace_id:, export: nil, page_limit: nil, sort: nil, cursor: nil, include_audit: nil)
+    # @!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.
     # @param workspace_id [String] Unique identifier of the workspace.
@@ -398,15 +464,20 @@ module IBMWatson
     #   **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 that satisfy the
+    #   request, regardless of the page limit. If this parameter is `true`, the
+    #   `pagination` object in the response includes the `total` property.
     # @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, sort: nil, cursor: nil, include_audit: 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("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "list_intents")
@@ -416,6 +487,7 @@ module IBMWatson
         "version" => @version,
         "export" => export,
         "page_limit" => page_limit,
+        "include_count" => include_count,
         "sort" => sort,
         "cursor" => cursor,
         "include_audit" => include_audit
@@ -454,6 +526,8 @@ module IBMWatson
     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("version must be provided") if version.nil?
+
       raise ArgumentError.new("intent must be provided") if intent.nil?
 
       headers = {
@@ -502,6 +576,8 @@ module IBMWatson
 
       raise ArgumentError.new("intent must be provided") if intent.nil?
 
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "get_intent")
@@ -559,6 +635,8 @@ module IBMWatson
 
       raise ArgumentError.new("intent must be provided") if intent.nil?
 
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "update_intent")
@@ -601,6 +679,8 @@ module IBMWatson
 
       raise ArgumentError.new("intent must be provided") if intent.nil?
 
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "delete_intent")
@@ -626,24 +706,29 @@ module IBMWatson
     #########################
 
     ##
-    # @!method list_examples(workspace_id:, intent:, page_limit: nil, sort: nil, cursor: nil, include_audit: nil)
+    # @!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.
     # @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 that satisfy the
+    #   request, regardless of the page limit. If this parameter is `true`, the
+    #   `pagination` object in the response includes the `total` property.
     # @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, sort: nil, cursor: nil, include_audit: nil)
+    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("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "list_examples")
@@ -652,6 +737,7 @@ module IBMWatson
       params = {
         "version" => @version,
         "page_limit" => page_limit,
+        "include_count" => include_count,
         "sort" => sort,
         "cursor" => cursor,
         "include_audit" => include_audit
@@ -691,6 +777,8 @@ module IBMWatson
 
       raise ArgumentError.new("intent must be provided") if intent.nil?
 
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("text must be provided") if text.nil?
 
       headers = {
@@ -738,6 +826,8 @@ module IBMWatson
 
       raise ArgumentError.new("text must be provided") if text.nil?
 
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "get_example")
@@ -785,6 +875,8 @@ module IBMWatson
 
       raise ArgumentError.new("text must be provided") if text.nil?
 
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "update_example")
@@ -828,6 +920,8 @@ module IBMWatson
 
       raise ArgumentError.new("text must be provided") if text.nil?
 
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "delete_example")
@@ -853,21 +947,26 @@ module IBMWatson
     #########################
 
     ##
-    # @!method list_counterexamples(workspace_id:, page_limit: nil, sort: nil, cursor: nil, include_audit: nil)
+    # @!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.
     # @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 that satisfy the
+    #   request, regardless of the page limit. If this parameter is `true`, the
+    #   `pagination` object in the response includes the `total` property.
     # @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, sort: nil, cursor: nil, include_audit: nil)
+    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("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "list_counterexamples")
@@ -876,6 +975,7 @@ module IBMWatson
       params = {
         "version" => @version,
         "page_limit" => page_limit,
+        "include_count" => include_count,
         "sort" => sort,
         "cursor" => cursor,
         "include_audit" => include_audit
@@ -912,6 +1012,8 @@ module IBMWatson
     def create_counterexample(workspace_id:, text:, include_audit: nil)
       raise ArgumentError.new("workspace_id must be provided") if workspace_id.nil?
 
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("text must be provided") if text.nil?
 
       headers = {
@@ -956,6 +1058,8 @@ module IBMWatson
 
       raise ArgumentError.new("text must be provided") if text.nil?
 
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "get_counterexample")
@@ -997,6 +1101,8 @@ module IBMWatson
 
       raise ArgumentError.new("text must be provided") if text.nil?
 
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "update_counterexample")
@@ -1037,6 +1143,8 @@ module IBMWatson
 
       raise ArgumentError.new("text must be provided") if text.nil?
 
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "delete_counterexample")
@@ -1062,7 +1170,7 @@ module IBMWatson
     #########################
 
     ##
-    # @!method list_entities(workspace_id:, export: nil, page_limit: nil, sort: nil, cursor: nil, include_audit: nil)
+    # @!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.
     # @param workspace_id [String] Unique identifier of the workspace.
@@ -1070,15 +1178,20 @@ module IBMWatson
     #   **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 that satisfy the
+    #   request, regardless of the page limit. If this parameter is `true`, the
+    #   `pagination` object in the response includes the `total` property.
     # @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, sort: nil, cursor: nil, include_audit: nil)
+    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?
 
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "list_entities")
@@ -1088,6 +1201,7 @@ module IBMWatson
         "version" => @version,
         "export" => export,
         "page_limit" => page_limit,
+        "include_count" => include_count,
         "sort" => sort,
         "cursor" => cursor,
         "include_audit" => include_audit
@@ -1129,6 +1243,8 @@ module IBMWatson
     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("version must be provided") if version.nil?
+
       raise ArgumentError.new("entity must be provided") if entity.nil?
 
       headers = {
@@ -1179,6 +1295,8 @@ module IBMWatson
 
       raise ArgumentError.new("entity must be provided") if entity.nil?
 
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "get_entity")
@@ -1237,6 +1355,8 @@ module IBMWatson
 
       raise ArgumentError.new("entity must be provided") if entity.nil?
 
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "update_entity")
@@ -1281,6 +1401,8 @@ module IBMWatson
 
       raise ArgumentError.new("entity must be provided") if entity.nil?
 
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "delete_entity")
@@ -1323,6 +1445,8 @@ module IBMWatson
 
       raise ArgumentError.new("entity must be provided") if entity.nil?
 
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "list_mentions")
@@ -1350,7 +1474,7 @@ module IBMWatson
     #########################
 
     ##
-    # @!method list_values(workspace_id:, entity:, export: nil, page_limit: nil, sort: nil, cursor: nil, include_audit: nil)
+    # @!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.
     # @param workspace_id [String] Unique identifier of the workspace.
@@ -1359,17 +1483,22 @@ module IBMWatson
     #   **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 that satisfy the
+    #   request, regardless of the page limit. If this parameter is `true`, the
+    #   `pagination` object in the response includes the `total` property.
     # @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, sort: nil, cursor: 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?
 
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "list_values")
@@ -1379,6 +1508,7 @@ module IBMWatson
         "version" => @version,
         "export" => export,
         "page_limit" => page_limit,
+        "include_count" => include_count,
         "sort" => sort,
         "cursor" => cursor,
         "include_audit" => include_audit
@@ -1428,6 +1558,8 @@ module IBMWatson
 
       raise ArgumentError.new("entity must be provided") if entity.nil?
 
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("value must be provided") if value.nil?
 
       headers = {
@@ -1481,6 +1613,8 @@ module IBMWatson
 
       raise ArgumentError.new("value must be provided") if value.nil?
 
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "get_value")
@@ -1550,6 +1684,8 @@ module IBMWatson
 
       raise ArgumentError.new("value must be provided") if value.nil?
 
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "update_value")
@@ -1597,6 +1733,8 @@ module IBMWatson
 
       raise ArgumentError.new("value must be provided") if value.nil?
 
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "delete_value")
@@ -1622,26 +1760,31 @@ module IBMWatson
     #########################
 
     ##
-    # @!method list_synonyms(workspace_id:, entity:, value:, page_limit: nil, sort: nil, cursor: nil, include_audit: nil)
+    # @!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.
     # @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 that satisfy the
+    #   request, regardless of the page limit. If this parameter is `true`, the
+    #   `pagination` object in the response includes the `total` property.
     # @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, sort: nil, cursor: nil, include_audit: nil)
+    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("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "list_synonyms")
@@ -1650,6 +1793,7 @@ module IBMWatson
       params = {
         "version" => @version,
         "page_limit" => page_limit,
+        "include_count" => include_count,
         "sort" => sort,
         "cursor" => cursor,
         "include_audit" => include_audit
@@ -1691,6 +1835,8 @@ module IBMWatson
 
       raise ArgumentError.new("value must be provided") if value.nil?
 
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("synonym must be provided") if synonym.nil?
 
       headers = {
@@ -1740,6 +1886,8 @@ module IBMWatson
 
       raise ArgumentError.new("synonym must be provided") if synonym.nil?
 
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "get_synonym")
@@ -1789,6 +1937,8 @@ module IBMWatson
 
       raise ArgumentError.new("synonym must be provided") if synonym.nil?
 
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "update_synonym")
@@ -1834,6 +1984,8 @@ module IBMWatson
 
       raise ArgumentError.new("synonym must be provided") if synonym.nil?
 
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "delete_synonym")
@@ -1859,20 +2011,25 @@ module IBMWatson
     #########################
 
     ##
-    # @!method list_dialog_nodes(workspace_id:, page_limit: nil, sort: nil, cursor: nil, include_audit: nil)
+    # @!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.
     # @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 that satisfy the
+    #   request, regardless of the page limit. If this parameter is `true`, the
+    #   `pagination` object in the response includes the `total` property.
     # @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, sort: nil, cursor: nil, include_audit: nil)
+    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?
 
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "list_dialog_nodes")
@@ -1881,6 +2038,7 @@ module IBMWatson
       params = {
         "version" => @version,
         "page_limit" => page_limit,
+        "include_count" => include_count,
         "sort" => sort,
         "cursor" => cursor,
         "include_audit" => include_audit
@@ -1906,27 +2064,34 @@ module IBMWatson
     #   If you want to create multiple dialog nodes with a single API call, consider using
     #   the **[Update workspace](#update-workspace)** method instead.
     # @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.
+    # @param dialog_node [String] The unique ID of the dialog node. This is an internal identifier used to refer to
+    #   the dialog node from other dialog nodes and in the diagnostic information included
+    #   with message responses.
+    #
+    #   This string can contain only Unicode alphanumeric, space, underscore, hyphen, and
+    #   dot characters.
     # @param description [String] The description of the dialog node. This string cannot contain carriage return,
     #   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.
-    # @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 parent [String] The unique ID of the parent dialog node. This property is omitted if the dialog
+    #   node has no parent.
+    # @param previous_sibling [String] The unique 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/assistant?topic=assistant-dialog-overview#dialog-overview-responses).
-    # @param context [Hash] The context for the dialog node.
+    # @param context [DialogNodeContext] 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.
-    # @param title [String] The alias used to identify the dialog node. This string must conform to the
-    #   following restrictions:
-    #   - It can contain only Unicode alphanumeric, space, underscore, hyphen, and dot
-    #   characters.
+    # @param title [String] A human-readable name for the dialog node. If the node is included in
+    #   disambiguation, this title is used to populate the **label** property of the
+    #   corresponding suggestion in the `suggestion` response type (unless it is
+    #   overridden by the **user_label** property). The title is also used to populate the
+    #   **topic** property in the `connect_to_agent` response type.
+    #
+    #   This string can contain only Unicode alphanumeric, space, underscore, hyphen, and
+    #   dot characters.
     # @param 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.
@@ -1935,7 +2100,8 @@ 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.
+    #   users. If set, this label is used to identify the node in disambiguation responses
+    #   (overriding the value of the **title** property).
     # @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
@@ -1944,6 +2110,8 @@ module IBMWatson
     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("version must be provided") if version.nil?
+
       raise ArgumentError.new("dialog_node must be provided") if dialog_node.nil?
 
       headers = {
@@ -1996,7 +2164,7 @@ module IBMWatson
     # Get dialog node.
     # Get information about a dialog node.
     # @param workspace_id [String] Unique identifier of the workspace.
-    # @param dialog_node [String] The dialog node ID (for example, `get_order`).
+    # @param dialog_node [String] The dialog node ID (for example, `node_1_1479323581900`).
     # @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.
@@ -2005,6 +2173,8 @@ module IBMWatson
 
       raise ArgumentError.new("dialog_node must be provided") if dialog_node.nil?
 
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "get_dialog_node")
@@ -2035,28 +2205,35 @@ module IBMWatson
     #   If you want to update multiple dialog nodes with a single API call, consider using
     #   the **[Update workspace](#update-workspace)** method instead.
     # @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:
-    #   - It can contain only Unicode alphanumeric, space, underscore, hyphen, and dot
-    #   characters.
+    # @param dialog_node [String] The dialog node ID (for example, `node_1_1479323581900`).
+    # @param new_dialog_node [String] The unique ID of the dialog node. This is an internal identifier used to refer to
+    #   the dialog node from other dialog nodes and in the diagnostic information included
+    #   with message responses.
+    #
+    #   This string can contain only Unicode alphanumeric, space, underscore, hyphen, and
+    #   dot characters.
     # @param new_description [String] The description of the dialog node. This string cannot contain carriage return,
     #   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.
-    # @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_parent [String] The unique ID of the parent dialog node. This property is omitted if the dialog
+    #   node has no parent.
+    # @param new_previous_sibling [String] The unique 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/assistant?topic=assistant-dialog-overview#dialog-overview-responses).
-    # @param new_context [Hash] The context for the dialog node.
+    # @param new_context [DialogNodeContext] 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.
-    # @param new_title [String] The alias used to identify the dialog node. This string must conform to the
-    #   following restrictions:
-    #   - It can contain only Unicode alphanumeric, space, underscore, hyphen, and dot
-    #   characters.
+    # @param new_title [String] A human-readable name for the dialog node. If the node is included in
+    #   disambiguation, this title is used to populate the **label** property of the
+    #   corresponding suggestion in the `suggestion` response type (unless it is
+    #   overridden by the **user_label** property). The title is also used to populate the
+    #   **topic** property in the `connect_to_agent` response type.
+    #
+    #   This string can contain only Unicode alphanumeric, space, underscore, hyphen, and
+    #   dot characters.
     # @param new_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.
@@ -2065,7 +2242,8 @@ 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.
+    #   users. If set, this label is used to identify the node in disambiguation responses
+    #   (overriding the value of the **title** property).
     # @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
@@ -2076,6 +2254,8 @@ module IBMWatson
 
       raise ArgumentError.new("dialog_node must be provided") if dialog_node.nil?
 
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "update_dialog_node")
@@ -2126,13 +2306,15 @@ module IBMWatson
     # Delete dialog node.
     # Delete a dialog node from a workspace.
     # @param workspace_id [String] Unique identifier of the workspace.
-    # @param dialog_node [String] The dialog node ID (for example, `get_order`).
+    # @param dialog_node [String] The dialog node ID (for example, `node_1_1479323581900`).
     # @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?
 
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "delete_dialog_node")
@@ -2161,6 +2343,8 @@ 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.
+    #
+    #   This method requires Manager access.
     # @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 (`-`).
@@ -2173,6 +2357,8 @@ module IBMWatson
     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?
 
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("conversation", "V1", "list_logs")
@@ -2213,6 +2399,8 @@ module IBMWatson
     # @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("version must be provided") if version.nil?
+
       raise ArgumentError.new("filter must be provided") if filter.nil?
 
       headers = {
@@ -2253,9 +2441,17 @@ module IBMWatson
     #   with a request that passes data. For more information about personal data and
     #   customer IDs, see [Information
     #   security](https://cloud.ibm.com/docs/assistant?topic=assistant-information-security#information-security).
+    #
+    #   **Note:** This operation is intended only for deleting data associated with a
+    #   single specific customer, not for deleting data associated with multiple customers
+    #   or for any other purpose. For more information, see [Labeling and deleting data in
+    #   Watson
+    #   Assistant](https://cloud.ibm.com/docs/assistant?topic=assistant-information-security#information-security-gdpr-wa).
     # @param customer_id [String] The customer ID for which all data is to be deleted.
     # @return [nil]
     def delete_user_data(customer_id:)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("customer_id must be provided") if customer_id.nil?
 
       headers = {