ibm_watson 1.3.1 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c838e01be7a29c86664614e73080b4fe60a85735f13d5a6507ffb170dec5abef
-  data.tar.gz: 7ab1438cd84748d94ce274415cb630b3c3674f816266d62db0c8e2ca515cc475
+  metadata.gz: c7e49f743ec6be9987f928f1ef0cfb20940e25d725cbcb615fe91ac7ccf358a9
+  data.tar.gz: eaca308aac3243d51701f84360eded5d2bb80e9afeac79ef38f1c17803732823
 SHA512:
-  metadata.gz: 33da6c05de9c94139b1452a4e301bc703bedb1fd924e79932cd5eec3636115302460ae17fa418a5393ee680042102195fbe042d58e5853a7610dd901585c4c6b
-  data.tar.gz: a838a1d1eba30f7df87c7f7fe3cf80a5167c0fba422bcd30cb46ac5a34f2b604ea34dac1c1a58e504288b65566c4e98bdca77bbd5facab104e091027b38ba79c
+  metadata.gz: 064c105ef4d1e9f40f2c5b295afcd0309d77c8ecd408e0937d56136af53cf4ac5df5c09d550a9859820f30df7bf71a8e16ffceba0c637e0c3b7effc7728516c6
+  data.tar.gz: 8d6632a93f2864c9ffe12a7e3ab3e0fa07e38004ac81baa376d7f2926cac032fdcfbaa08600713b31211f632d343031ee1c7809d5ef979502b70476f405fbead

data/README.md

@@ -34,6 +34,15 @@ Ruby gem to quickly get started with the various [IBM Watson][wdc] services.
 
 </details>
 
+## ANNOUNCEMENTS!
+### 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.
+
 ## Before you begin
 
 * You need an [IBM Cloud][ibm-cloud-onboarding] account.
@@ -129,7 +138,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
 
@@ -269,7 +278,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 +298,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.
@@ -390,12 +415,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
 
@@ -419,6 +450,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

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.19.0-be3b4618-20201113-200858
+#
 # 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.
@@ -33,37 +35,36 @@ 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"
+    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.
+    # @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
+      defaults[:version] = 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
 
     #########################
@@ -79,8 +80,6 @@ module IBMWatson
     #   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/assistant?topic=assistant-api-overview).
-    #
-    #   There is no rate limit for this operation.
     # @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
@@ -101,6 +100,8 @@ module IBMWatson
     def message(workspace_id:, input: nil, intents: nil, entities: nil, alternate_intents: nil, context: nil, output: 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")
@@ -137,20 +138,22 @@ module IBMWatson
     #########################
 
     ##
-    # @!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.
-    #
-    #   This operation is limited to 500 requests per 30 minutes. For more information,
-    #   see **Rate limiting**.
     # @param page_limit [Fixnum] The number of records to return in each page of results.
+    # @param include_count [Boolean] Whether to include information about the number of records 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")
@@ -159,6 +162,7 @@ module IBMWatson
       params = {
         "version" => @version,
         "page_limit" => page_limit,
+        "include_count" => include_count,
         "sort" => sort,
         "cursor" => cursor,
         "include_audit" => include_audit
@@ -177,33 +181,32 @@ 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.
-    #
-    #   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,
     #   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")
@@ -218,14 +221,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"
@@ -245,10 +248,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
@@ -262,6 +261,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")
@@ -287,30 +288,27 @@ 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.
-    #
-    #   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.
     # @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
@@ -324,9 +322,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")
@@ -342,14 +342,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)]
@@ -369,14 +369,13 @@ 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:)
       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")
@@ -402,27 +401,28 @@ 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.
-    #
-    #   With **export**=`false`, this operation is limited to 2000 requests per 30
-    #   minutes. With **export**=`true`, the limit is 400 requests per 30 minutes. For
-    #   more information, see **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
     # @param export [Boolean] Whether to include all element content in the returned data. If
     #   **export**=`false`, the returned data includes only information about the element
     #   itself. If **export**=`true`, all content, including subelements, is included.
     # @param page_limit [Fixnum] The number of records to return in each page of results.
+    # @param include_count [Boolean] Whether to include information about the number of records 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")
@@ -432,6 +432,7 @@ module IBMWatson
         "version" => @version,
         "export" => export,
         "page_limit" => page_limit,
+        "include_count" => include_count,
         "sort" => sort,
         "cursor" => cursor,
         "include_audit" => include_audit
@@ -456,9 +457,6 @@ module IBMWatson
     #
     #   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
@@ -473,6 +471,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 = {
@@ -508,10 +508,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
@@ -525,6 +521,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")
@@ -556,9 +554,6 @@ module IBMWatson
     #
     #   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:
@@ -585,6 +580,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")
@@ -619,9 +616,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]
@@ -630,6 +624,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")
@@ -655,27 +651,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.
-    #
-    #   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.
+    # @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")
@@ -684,6 +682,7 @@ module IBMWatson
       params = {
         "version" => @version,
         "page_limit" => page_limit,
+        "include_count" => include_count,
         "sort" => sort,
         "cursor" => cursor,
         "include_audit" => include_audit
@@ -706,11 +705,8 @@ module IBMWatson
     # 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
@@ -726,6 +722,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 = {
@@ -760,9 +758,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.
@@ -776,6 +771,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")
@@ -805,9 +802,6 @@ module IBMWatson
     #
     #   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.
@@ -826,6 +820,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")
@@ -858,9 +854,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,6 +865,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")
@@ -897,24 +892,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.
-    #
-    #   This operation is limited to 2500 requests per 30 minutes. For more information,
-    #   see **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
     # @param page_limit [Fixnum] The number of records to return in each page of results.
+    # @param include_count [Boolean] Whether to include information about the number of records 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")
@@ -923,6 +920,7 @@ module IBMWatson
       params = {
         "version" => @version,
         "page_limit" => page_limit,
+        "include_count" => include_count,
         "sort" => sort,
         "cursor" => cursor,
         "include_audit" => include_audit
@@ -948,9 +946,6 @@ module IBMWatson
     #
     #   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:
@@ -962,6 +957,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 = {
@@ -996,9 +993,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
@@ -1009,6 +1003,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")
@@ -1036,12 +1032,6 @@ module IBMWatson
     # 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
@@ -1056,6 +1046,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")
@@ -1088,9 +1080,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]
@@ -1099,6 +1088,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")
@@ -1124,27 +1115,28 @@ 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.
-    #
-    #   With **export**=`false`, this operation is limited to 1000 requests per 30
-    #   minutes. With **export**=`true`, the limit is 200 requests per 30 minutes. For
-    #   more information, see **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
     # @param export [Boolean] Whether to include all element content in the returned data. If
     #   **export**=`false`, the returned data includes only information about the element
     #   itself. If **export**=`true`, all content, including subelements, is included.
     # @param page_limit [Fixnum] The number of records to return in each page of results.
+    # @param include_count [Boolean] Whether to include information about the number of records 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")
@@ -1154,6 +1146,7 @@ module IBMWatson
         "version" => @version,
         "export" => export,
         "page_limit" => page_limit,
+        "include_count" => include_count,
         "sort" => sort,
         "cursor" => cursor,
         "include_audit" => include_audit
@@ -1178,9 +1171,6 @@ module IBMWatson
     #
     #   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.
@@ -1198,6 +1188,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 = {
@@ -1235,10 +1227,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
@@ -1252,6 +1240,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")
@@ -1283,9 +1273,6 @@ module IBMWatson
     #
     #   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:
@@ -1313,6 +1300,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")
@@ -1349,9 +1338,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]
@@ -1360,6 +1346,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")
@@ -1389,9 +1377,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
@@ -1405,6 +1390,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")
@@ -1432,29 +1419,31 @@ 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.
-    #
-    #   This operation is limited to 2500 requests per 30 minutes. For more information,
-    #   see **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
     # @param entity [String] The name of the entity.
     # @param export [Boolean] Whether to include all element content in the returned data. If
     #   **export**=`false`, the returned data includes only information about the element
     #   itself. If **export**=`true`, all content, including subelements, is included.
     # @param page_limit [Fixnum] The number of records to return in each page of results.
+    # @param include_count [Boolean] Whether to include information about the number of records 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")
@@ -1464,6 +1453,7 @@ module IBMWatson
         "version" => @version,
         "export" => export,
         "page_limit" => page_limit,
+        "include_count" => include_count,
         "sort" => sort,
         "cursor" => cursor,
         "include_audit" => include_audit
@@ -1488,9 +1478,6 @@ module IBMWatson
     #
     #   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
@@ -1516,6 +1503,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 = {
@@ -1553,9 +1542,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.
@@ -1572,6 +1558,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")
@@ -1603,9 +1591,6 @@ module IBMWatson
     #
     #   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.
@@ -1644,6 +1629,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")
@@ -1680,9 +1667,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.
@@ -1694,6 +1678,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")
@@ -1719,29 +1705,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.
-    #
-    #   This operation is limited to 2500 requests per 30 minutes. For more information,
-    #   see **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
     # @param entity [String] The name of the entity.
     # @param value [String] The text of the entity value.
     # @param 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")
@@ -1750,6 +1738,7 @@ module IBMWatson
       params = {
         "version" => @version,
         "page_limit" => page_limit,
+        "include_count" => include_count,
         "sort" => sort,
         "cursor" => cursor,
         "include_audit" => include_audit
@@ -1775,9 +1764,6 @@ module IBMWatson
     #   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.
@@ -1794,6 +1780,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 = {
@@ -1827,9 +1815,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.
@@ -1846,6 +1831,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")
@@ -1876,9 +1863,6 @@ module IBMWatson
     #   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.
@@ -1898,6 +1882,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")
@@ -1929,9 +1915,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.
@@ -1946,6 +1929,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")
@@ -1971,23 +1956,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.
-    #
-    #   This operation is limited to 2500 requests per 30 minutes. For more information,
-    #   see **Rate limiting**.
     # @param workspace_id [String] Unique identifier of the workspace.
     # @param page_limit [Fixnum] The number of records to return in each page of results.
+    # @param include_count [Boolean] Whether to include information about the number of records 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")
@@ -1996,6 +1983,7 @@ module IBMWatson
       params = {
         "version" => @version,
         "page_limit" => page_limit,
+        "include_count" => include_count,
         "sort" => sort,
         "cursor" => cursor,
         "include_audit" => include_audit
@@ -2020,9 +2008,6 @@ module IBMWatson
     #
     #   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
@@ -2038,7 +2023,7 @@ module IBMWatson
     # @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
@@ -2054,13 +2039,16 @@ 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, 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 = {
@@ -2112,9 +2100,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
@@ -2125,6 +2110,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")
@@ -2154,9 +2141,6 @@ module IBMWatson
     #
     #   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:
@@ -2173,7 +2157,7 @@ module IBMWatson
     # @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
@@ -2189,7 +2173,8 @@ 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.
@@ -2198,6 +2183,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")
@@ -2247,9 +2234,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]
@@ -2258,6 +2242,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", "delete_dialog_node")
@@ -2286,10 +2272,6 @@ 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 (`-`).
@@ -2302,6 +2284,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")
@@ -2331,10 +2315,6 @@ 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
@@ -2346,6 +2326,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 = {
@@ -2386,12 +2368,11 @@ 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).
-    #
-    #   This operation is limited to 4 requests per minute. For more information, see
-    #   **Rate limiting**.
     # @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 = {
@@ -2415,5 +2396,50 @@ module IBMWatson
       )
       nil
     end
+    #########################
+    # bulkClassify
+    #########################
+
+    ##
+    # @!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 Premium 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
   end
 end