ibm_watson 2.0.2 → 2.1.3

data/lib/ibm_watson/compare_comply_v1.rb

@@ -14,10 +14,18 @@
 # 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
+# IBM OpenAPI SDK Code Generator Version: 3.38.0-07189efd-20210827-205025
 #
-# IBM Watson™ Compare and Comply analyzes governing documents to provide details
-# about critical aspects of the documents.
+# 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](https://ibm.biz/contact-wdc-premium).
+# {: deprecated}
+#
+# Compare and Comply analyzes governing documents to provide details about critical
+# aspects of the documents.
 
 require "concurrent"
 require "erb"
@@ -25,7 +33,6 @@ require "json"
 require "ibm_cloud_sdk_core"
 require_relative "./common.rb"
 
-# Module for the Watson APIs
 module IBMWatson
   ##
   # The Compare Comply V1 service.

data/lib/ibm_watson/discovery_v1.rb

@@ -14,7 +14,7 @@
 # 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
+# IBM OpenAPI SDK Code Generator Version: 3.38.0-07189efd-20210827-205025
 #
 # IBM Watson™ Discovery is a cognitive search and content analytics engine that
 # you can add to applications to identify patterns, trends and actionable insights to
@@ -28,7 +28,6 @@ require "json"
 require "ibm_cloud_sdk_core"
 require_relative "./common.rb"
 
-# Module for the Watson APIs
 module IBMWatson
   ##
   # The Discovery V1 service.
@@ -1430,7 +1429,7 @@ module IBMWatson
     #   parameter.
     # @param spelling_suggestions [Boolean] When `true` and the **natural_language_query** parameter is used, the
     #   **natural_languge_query** parameter is spell checked. The most likely correction
-    #   is retunred in the **suggested_query** field of the response (if one exists).
+    #   is returned in the **suggested_query** field of the response (if one exists).
     #
     #   **Important:** this parameter is only valid when using the Cloud Pak version of
     #   Discovery.
@@ -1810,7 +1809,7 @@ module IBMWatson
     # @param environment_id [String] The ID of the environment.
     # @param collection_id [String] The ID of the collection.
     # @param prefix [String] The prefix to use for autocompletion. For example, the prefix `Ho` could
-    #   autocomplete to `Hot`, `Housing`, or `How do I upgrade`. Possible completions are.
+    #   autocomplete to `hot`, `housing`, or `how`.
     # @param field [String] The field in the result documents that autocompletion suggestions are identified
     #   from.
     # @param count [Fixnum] The number of autocompletion suggestions to return.
@@ -2650,10 +2649,7 @@ module IBMWatson
     # @param credential_details [CredentialDetails] Object containing details of the stored credentials.
     #
     #   Obtain credentials for your source from the administrator of the source.
-    # @param status [String] The current status of this set of credentials. `connected` indicates that the
-    #   credentials are available to use with the source configuration of a collection.
-    #   `invalid` refers to the credentials (for example, the password provided has
-    #   expired) and must be corrected before they can be used with a collection.
+    # @param status [StatusDetails] Object that contains details about the status of the authentication process.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def create_credentials(environment_id:, source_type: nil, credential_details: nil, status: nil)
       raise ArgumentError.new("version must be provided") if version.nil?
@@ -2747,10 +2743,7 @@ module IBMWatson
     # @param credential_details [CredentialDetails] Object containing details of the stored credentials.
     #
     #   Obtain credentials for your source from the administrator of the source.
-    # @param status [String] The current status of this set of credentials. `connected` indicates that the
-    #   credentials are available to use with the source configuration of a collection.
-    #   `invalid` refers to the credentials (for example, the password provided has
-    #   expired) and must be corrected before they can be used with a collection.
+    # @param status [StatusDetails] Object that contains details about the status of the authentication process.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def update_credentials(environment_id:, credential_id:, source_type: nil, credential_details: nil, status: nil)
       raise ArgumentError.new("version must be provided") if version.nil?

data/lib/ibm_watson/discovery_v2.rb

@@ -14,7 +14,7 @@
 # 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
+# IBM OpenAPI SDK Code Generator Version: 3.38.0-07189efd-20210827-205025
 #
 # IBM Watson™ Discovery is a cognitive search and content analytics engine that
 # you can add to applications to identify patterns, trends and actionable insights to
@@ -28,7 +28,6 @@ require "json"
 require "ibm_cloud_sdk_core"
 require_relative "./common.rb"
 
-# Module for the Watson APIs
 module IBMWatson
   ##
   # The Discovery V2 service.
@@ -43,7 +42,7 @@ module IBMWatson
     #
     # @param args [Hash] The args to initialize with
     # @option args version [String] Release date of the version of the API you want to use. Specify dates in
-    #   YYYY-MM-DD format. The current version is `2019-11-22`.
+    #   YYYY-MM-DD format. The current version is `2020-08-30`.
     # @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.
@@ -74,8 +73,8 @@ module IBMWatson
     # @!method list_collections(project_id:)
     # List collections.
     # Lists existing collections for the specified project.
-    # @param project_id [String] The ID of the project. This information can be found from the deploy page of the
-    #   Discovery administrative tooling.
+    # @param project_id [String] The ID of the project. This information can be found from the *Integrate and
+    #   Deploy* page in Discovery.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def list_collections(project_id:)
       raise ArgumentError.new("project_id must be provided") if project_id.nil?
@@ -107,8 +106,8 @@ module IBMWatson
     # @!method create_collection(project_id:, name:, description: nil, language: nil, enrichments: nil)
     # Create a collection.
     # Create a new collection in the specified project.
-    # @param project_id [String] The ID of the project. This information can be found from the deploy page of the
-    #   Discovery administrative tooling.
+    # @param project_id [String] The ID of the project. This information can be found from the *Integrate and
+    #   Deploy* page in Discovery.
     # @param name [String] The name of the collection.
     # @param description [String] A description of the collection.
     # @param language [String] The language of the collection.
@@ -154,8 +153,8 @@ module IBMWatson
     # @!method get_collection(project_id:, collection_id:)
     # Get collection.
     # Get details about the specified collection.
-    # @param project_id [String] The ID of the project. This information can be found from the deploy page of the
-    #   Discovery administrative tooling.
+    # @param project_id [String] The ID of the project. This information can be found from the *Integrate and
+    #   Deploy* page in Discovery.
     # @param collection_id [String] The ID of the collection.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def get_collection(project_id:, collection_id:)
@@ -190,8 +189,8 @@ module IBMWatson
     # @!method update_collection(project_id:, collection_id:, name: nil, description: nil, enrichments: nil)
     # Update a collection.
     # Updates the specified collection's name, description, and enrichments.
-    # @param project_id [String] The ID of the project. This information can be found from the deploy page of the
-    #   Discovery administrative tooling.
+    # @param project_id [String] The ID of the project. This information can be found from the *Integrate and
+    #   Deploy* page in Discovery.
     # @param collection_id [String] The ID of the collection.
     # @param name [String] The name of the collection.
     # @param description [String] A description of the collection.
@@ -237,8 +236,8 @@ module IBMWatson
     # Delete a collection.
     # Deletes the specified collection from the project. All documents stored in the
     #   specified collection and not shared is also deleted.
-    # @param project_id [String] The ID of the project. This information can be found from the deploy page of the
-    #   Discovery administrative tooling.
+    # @param project_id [String] The ID of the project. This information can be found from the *Integrate and
+    #   Deploy* page in Discovery.
     # @param collection_id [String] The ID of the collection.
     # @return [nil]
     def delete_collection(project_id:, collection_id:)
@@ -283,8 +282,8 @@ module IBMWatson
     #   for an overview of the standard default settings, and see [the Projects API
     #   documentation](#create-project) for details about how to set custom default query
     #   settings.
-    # @param project_id [String] The ID of the project. This information can be found from the deploy page of the
-    #   Discovery administrative tooling.
+    # @param project_id [String] The ID of the project. This information can be found from the *Integrate and
+    #   Deploy* page in Discovery.
     # @param collection_ids [Array[String]] A comma-separated list of collection IDs to be queried against.
     # @param filter [String] A cacheable query that excludes documents that don't mention the query content.
     #   Filter searches are better for metadata-type searches and for assessing the
@@ -298,15 +297,14 @@ module IBMWatson
     #   filters. Useful for applications to build lists, tables, and time series. For a
     #   full list of possible aggregations, see the Query reference.
     # @param count [Fixnum] Number of results to return.
-    # @param _return [Array[String]] A list of the fields in the document hierarchy to return. If this parameter not
-    #   specified, then all top-level fields are returned.
+    # @param _return [Array[String]] A list of the fields in the document hierarchy to return. If this parameter is an
+    #   empty list, then all fields are returned.
     # @param offset [Fixnum] The number of query results to skip at the beginning. For example, if the total
     #   number of results that are returned is 10 and the offset is 8, it returns the last
     #   two results.
     # @param sort [String] A comma-separated list of fields in the document to sort on. You can optionally
     #   specify a sort direction by prefixing the field with `-` for descending or `+` for
-    #   ascending. Ascending is the default sort direction if no prefix is specified. This
-    #   parameter cannot be used in the same query as the **bias** parameter.
+    #   ascending. Ascending is the default sort direction if no prefix is specified.
     # @param highlight [Boolean] When `true`, a highlight field is returned for each result which contains the
     #   fields which match the query with `<em></em>` tags around the matching query
     #   terms.
@@ -314,7 +312,7 @@ module IBMWatson
     #   **natural_language_query** parameter is spell checked. The most likely correction
     #   is returned in the **suggested_query** field of the response (if one exists).
     # @param table_results [QueryLargeTableResults] Configuration for table retrieval.
-    # @param suggested_refinements [QueryLargeSuggestedRefinements] Configuration for suggested refinements.
+    # @param suggested_refinements [QueryLargeSuggestedRefinements] Configuration for suggested refinements. Available with Premium plans only.
     # @param passages [QueryLargePassages] Configuration for passage retrieval.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def query(project_id:, collection_ids: nil, filter: nil, query: nil, natural_language_query: nil, aggregation: nil, count: nil, _return: nil, offset: nil, sort: nil, highlight: nil, spelling_suggestions: nil, table_results: nil, suggested_refinements: nil, passages: nil)
@@ -365,10 +363,10 @@ module IBMWatson
     # @!method get_autocompletion(project_id:, prefix:, collection_ids: nil, field: nil, count: nil)
     # Get Autocomplete Suggestions.
     # Returns completion query suggestions for the specified prefix.
-    # @param project_id [String] The ID of the project. This information can be found from the deploy page of the
-    #   Discovery administrative tooling.
+    # @param project_id [String] The ID of the project. This information can be found from the *Integrate and
+    #   Deploy* page in Discovery.
     # @param prefix [String] The prefix to use for autocompletion. For example, the prefix `Ho` could
-    #   autocomplete to `Hot`, `Housing`, or `How do I upgrade`. Possible completions are.
+    #   autocomplete to `hot`, `housing`, or `how`.
     # @param collection_ids [Array[String]] Comma separated list of the collection IDs. If this parameter is not specified,
     #   all collections in the project are used.
     # @param field [String] The field in the result documents that autocompletion suggestions are identified
@@ -408,14 +406,68 @@ module IBMWatson
       response
     end
 
+    ##
+    # @!method query_collection_notices(project_id:, collection_id:, filter: nil, query: nil, natural_language_query: nil, count: nil, offset: nil)
+    # Query collection notices.
+    # Finds collection-level notices (errors and warnings) that are generated when
+    #   documents are ingested.
+    # @param project_id [String] The ID of the project. This information can be found from the *Integrate and
+    #   Deploy* page in Discovery.
+    # @param collection_id [String] The ID of the collection.
+    # @param filter [String] A cacheable query that excludes documents that don't mention the query content.
+    #   Filter searches are better for metadata-type searches and for assessing the
+    #   concepts in the data set.
+    # @param query [String] A query search returns all documents in your data set with full enrichments and
+    #   full text, but with the most relevant documents listed first.
+    # @param natural_language_query [String] A natural language query that returns relevant documents by utilizing training
+    #   data and natural language understanding.
+    # @param count [Fixnum] Number of results to return. The maximum for the **count** and **offset** values
+    #   together in any one query is **10000**.
+    # @param offset [Fixnum] The number of query results to skip at the beginning. For example, if the total
+    #   number of results that are returned is 10 and the offset is 8, it returns the last
+    #   two results. The maximum for the **count** and **offset** values together in any
+    #   one query is **10000**.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def query_collection_notices(project_id:, collection_id:, filter: nil, query: nil, natural_language_query: nil, count: nil, offset: nil)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
+      raise ArgumentError.new("project_id must be provided") if project_id.nil?
+
+      raise ArgumentError.new("collection_id must be provided") if collection_id.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("discovery", "V2", "query_collection_notices")
+      headers.merge!(sdk_headers)
+
+      params = {
+        "version" => @version,
+        "filter" => filter,
+        "query" => query,
+        "natural_language_query" => natural_language_query,
+        "count" => count,
+        "offset" => offset
+      }
+
+      method_url = "/v2/projects/%s/collections/%s/notices" % [ERB::Util.url_encode(project_id), ERB::Util.url_encode(collection_id)]
+
+      response = request(
+        method: "GET",
+        url: method_url,
+        headers: headers,
+        params: params,
+        accept_json: true
+      )
+      response
+    end
+
     ##
     # @!method query_notices(project_id:, filter: nil, query: nil, natural_language_query: nil, count: nil, offset: nil)
-    # Query system notices.
-    # Queries for notices (errors or warnings) that might have been generated by the
-    #   system. Notices are generated when ingesting documents and performing relevance
-    #   training.
-    # @param project_id [String] The ID of the project. This information can be found from the deploy page of the
-    #   Discovery administrative tooling.
+    # Query project notices.
+    # Finds project-level notices (errors and warnings). Currently, project-level
+    #   notices are generated by relevancy training.
+    # @param project_id [String] The ID of the project. This information can be found from the *Integrate and
+    #   Deploy* page in Discovery.
     # @param filter [String] A cacheable query that excludes documents that don't mention the query content.
     #   Filter searches are better for metadata-type searches and for assessing the
     #   concepts in the data set.
@@ -466,8 +518,8 @@ module IBMWatson
     # List fields.
     # Gets a list of the unique fields (and their types) stored in the the specified
     #   collections.
-    # @param project_id [String] The ID of the project. This information can be found from the deploy page of the
-    #   Discovery administrative tooling.
+    # @param project_id [String] The ID of the project. This information can be found from the *Integrate and
+    #   Deploy* page in Discovery.
     # @param collection_ids [Array[String]] Comma separated list of the collection IDs. If this parameter is not specified,
     #   all collections in the project are used.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
@@ -506,8 +558,8 @@ module IBMWatson
     # @!method get_component_settings(project_id:)
     # List component settings.
     # Returns default configuration settings for components.
-    # @param project_id [String] The ID of the project. This information can be found from the deploy page of the
-    #   Discovery administrative tooling.
+    # @param project_id [String] The ID of the project. This information can be found from the *Integrate and
+    #   Deploy* page in Discovery.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def get_component_settings(project_id:)
       raise ArgumentError.new("project_id must be provided") if project_id.nil?
@@ -543,44 +595,42 @@ module IBMWatson
     # Add a document.
     # Add a document to a collection with optional metadata.
     #
-    #    Returns immediately after the system has accepted the document for processing.
+    #   Returns immediately after the system has accepted the document for processing.
     #
     #     * The user must provide document content, metadata, or both. If the request is
     #   missing both document content and metadata, it is rejected.
     #
-    #     * The user can set the **Content-Type** parameter on the **file** part to
-    #   indicate the media type of the document. If the **Content-Type** parameter is
-    #   missing or is one of the generic media types (for example,
-    #   `application/octet-stream`), then the service attempts to automatically detect the
-    #   document's media type.
+    #     * You can set the **Content-Type** parameter on the **file** part to indicate
+    #   the media type of the document. If the **Content-Type** parameter is missing or is
+    #   one of the generic media types (for example, `application/octet-stream`), then the
+    #   service attempts to automatically detect the document's media type.
     #
-    #     * The following field names are reserved and will be filtered out if present
-    #   after normalization: `id`, `score`, `highlight`, and any field with the prefix of:
-    #   `_`, `+`, or `-`
+    #     * The following field names are reserved and are filtered out if present after
+    #   normalization: `id`, `score`, `highlight`, and any field with the prefix of: `_`,
+    #   `+`, or `-`
     #
     #     * Fields with empty name values after normalization are filtered out before
     #   indexing.
     #
-    #     * Fields containing the following characters after normalization are filtered
+    #     * Fields that contain the following characters after normalization are filtered
     #   out before indexing: `#` and `,`
     #
-    #     If the document is uploaded to a collection that has it's data shared with
-    #   another collection, the **X-Watson-Discovery-Force** header must be set to `true`.
-    #
+    #     If the document is uploaded to a collection that shares its data with another
+    #   collection, the **X-Watson-Discovery-Force** header must be set to `true`.
     #
-    #    **Note:** Documents can be added with a specific **document_id** by using the
-    #   **_/v2/projects/{project_id}/collections/{collection_id}/documents** method.
+    #   **Note:** You can assign an ID to a document that you add by appending the ID to
+    #   the endpoint
+    #   (`/v2/projects/{project_id}/collections/{collection_id}/documents/{document_id}`).
+    #   If a document already exists with the specified ID, it is replaced.
     #
-    #   **Note:** This operation only works on collections created to accept direct file
-    #   uploads. It cannot be used to modify a collection that connects to an external
-    #   source such as Microsoft SharePoint.
-    # @param project_id [String] The ID of the project. This information can be found from the deploy page of the
-    #   Discovery administrative tooling.
+    #   **Note:** This operation works with a file upload collection. It cannot be used to
+    #   modify a collection that crawls an external data source.
+    # @param project_id [String] The ID of the project. This information can be found from the *Integrate and
+    #   Deploy* page in Discovery.
     # @param collection_id [String] The ID of the collection.
-    # @param file [File] The content of the document to ingest. The maximum supported file size when adding
-    #   a file to a collection is 50 megabytes, the maximum supported file size when
-    #   testing a configuration is 1 megabyte. Files larger than the supported size are
-    #   rejected.
+    # @param file [File] The content of the document to ingest. For maximum supported file size limits, see
+    #   [the
+    #   documentation](https://cloud.ibm.com/docs/discovery-data?topic=discovery-data-collections#collections-doc-limits).
     # @param filename [String] The filename for file.
     # @param file_content_type [String] The content type of file.
     # @param metadata [String] The maximum supported metadata file size is 1 MB. Metadata parts larger than 1 MB
@@ -642,7 +692,7 @@ module IBMWatson
     # Replace an existing document or add a document with a specified **document_id**.
     #   Starts ingesting a document with optional metadata.
     #
-    #   If the document is uploaded to a collection that has it's data shared with another
+    #   If the document is uploaded to a collection that shares its data with another
     #   collection, the **X-Watson-Discovery-Force** header must be set to `true`.
     #
     #   **Note:** When uploading a new document with this method it automatically replaces
@@ -652,16 +702,15 @@ module IBMWatson
     #   uploads. It cannot be used to modify a collection that connects to an external
     #   source such as Microsoft SharePoint.
     #
-    #   **Note:** If an uploaded document is segmented, all segments will be overwritten,
-    #   even if the updated version of the document has fewer segments.
-    # @param project_id [String] The ID of the project. This information can be found from the deploy page of the
-    #   Discovery administrative tooling.
+    #   **Note:** If an uploaded document is segmented, all segments are overwritten, even
+    #   if the updated version of the document has fewer segments.
+    # @param project_id [String] The ID of the project. This information can be found from the *Integrate and
+    #   Deploy* page in Discovery.
     # @param collection_id [String] The ID of the collection.
     # @param document_id [String] The ID of the document.
-    # @param file [File] The content of the document to ingest. The maximum supported file size when adding
-    #   a file to a collection is 50 megabytes, the maximum supported file size when
-    #   testing a configuration is 1 megabyte. Files larger than the supported size are
-    #   rejected.
+    # @param file [File] The content of the document to ingest. For maximum supported file size limits, see
+    #   [the
+    #   documentation](https://cloud.ibm.com/docs/discovery-data?topic=discovery-data-collections#collections-doc-limits).
     # @param filename [String] The filename for file.
     # @param file_content_type [String] The content type of file.
     # @param metadata [String] The maximum supported metadata file size is 1 MB. Metadata parts larger than 1 MB
@@ -732,8 +781,8 @@ module IBMWatson
     #
     #   **Note:** Segments of an uploaded document cannot be deleted individually. Delete
     #   all segments by deleting using the `parent_document_id` of a segment result.
-    # @param project_id [String] The ID of the project. This information can be found from the deploy page of the
-    #   Discovery administrative tooling.
+    # @param project_id [String] The ID of the project. This information can be found from the *Integrate and
+    #   Deploy* page in Discovery.
     # @param collection_id [String] The ID of the collection.
     # @param document_id [String] The ID of the document.
     # @param x_watson_discovery_force [Boolean] When `true`, the uploaded document is added to the collection even if the data for
@@ -777,8 +826,8 @@ module IBMWatson
     # @!method list_training_queries(project_id:)
     # List training queries.
     # List the training queries for the specified project.
-    # @param project_id [String] The ID of the project. This information can be found from the deploy page of the
-    #   Discovery administrative tooling.
+    # @param project_id [String] The ID of the project. This information can be found from the *Integrate and
+    #   Deploy* page in Discovery.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def list_training_queries(project_id:)
       raise ArgumentError.new("version must be provided") if version.nil?
@@ -810,8 +859,8 @@ module IBMWatson
     # @!method delete_training_queries(project_id:)
     # Delete training queries.
     # Removes all training queries for the specified project.
-    # @param project_id [String] The ID of the project. This information can be found from the deploy page of the
-    #   Discovery administrative tooling.
+    # @param project_id [String] The ID of the project. This information can be found from the *Integrate and
+    #   Deploy* page in Discovery.
     # @return [nil]
     def delete_training_queries(project_id:)
       raise ArgumentError.new("version must be provided") if version.nil?
@@ -844,8 +893,8 @@ module IBMWatson
     # Create training query.
     # Add a query to the training data for this project. The query can contain a filter
     #   and natural language query.
-    # @param project_id [String] The ID of the project. This information can be found from the deploy page of the
-    #   Discovery administrative tooling.
+    # @param project_id [String] The ID of the project. This information can be found from the *Integrate and
+    #   Deploy* page in Discovery.
     # @param natural_language_query [String] The natural text query for the training query.
     # @param examples [Array[TrainingExample]] Array of training examples.
     # @param filter [String] The filter used on the collection before the **natural_language_query** is
@@ -893,8 +942,8 @@ module IBMWatson
     # Get a training data query.
     # Get details for a specific training data query, including the query string and all
     #   examples.
-    # @param project_id [String] The ID of the project. This information can be found from the deploy page of the
-    #   Discovery administrative tooling.
+    # @param project_id [String] The ID of the project. This information can be found from the *Integrate and
+    #   Deploy* page in Discovery.
     # @param query_id [String] The ID of the query used for training.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def get_training_query(project_id:, query_id:)
@@ -929,8 +978,8 @@ module IBMWatson
     # @!method update_training_query(project_id:, query_id:, natural_language_query:, examples:, filter: nil)
     # Update a training query.
     # Updates an existing training query and it's examples.
-    # @param project_id [String] The ID of the project. This information can be found from the deploy page of the
-    #   Discovery administrative tooling.
+    # @param project_id [String] The ID of the project. This information can be found from the *Integrate and
+    #   Deploy* page in Discovery.
     # @param query_id [String] The ID of the query used for training.
     # @param natural_language_query [String] The natural text query for the training query.
     # @param examples [Array[TrainingExample]] Array of training examples.
@@ -975,6 +1024,43 @@ module IBMWatson
       )
       response
     end
+
+    ##
+    # @!method delete_training_query(project_id:, query_id:)
+    # Delete a training data query.
+    # Removes details from a training data query, including the query string and all
+    #   examples.
+    # @param project_id [String] The ID of the project. This information can be found from the *Integrate and
+    #   Deploy* page in Discovery.
+    # @param query_id [String] The ID of the query used for training.
+    # @return [nil]
+    def delete_training_query(project_id:, query_id:)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
+      raise ArgumentError.new("project_id must be provided") if project_id.nil?
+
+      raise ArgumentError.new("query_id must be provided") if query_id.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("discovery", "V2", "delete_training_query")
+      headers.merge!(sdk_headers)
+
+      params = {
+        "version" => @version
+      }
+
+      method_url = "/v2/projects/%s/training_data/queries/%s" % [ERB::Util.url_encode(project_id), ERB::Util.url_encode(query_id)]
+
+      request(
+        method: "DELETE",
+        url: method_url,
+        headers: headers,
+        params: params,
+        accept_json: false
+      )
+      nil
+    end
     #########################
     # analyze
     #########################
@@ -982,21 +1068,18 @@ module IBMWatson
     ##
     # @!method analyze_document(project_id:, collection_id:, file: nil, filename: nil, file_content_type: nil, metadata: nil)
     # Analyze a Document.
-    # Process a document using the specified collection's settings and return it for
-    #   realtime use.
+    # Process a document and return it for realtime use. Supports JSON files only.
     #
-    #   **Note:** Documents processed using this method are not added to the specified
-    #   collection.
+    #   The document is processed according to the collection's configuration settings but
+    #   is not stored in the collection.
     #
-    #   **Note:** This method is only supported on IBM Cloud Pak for Data instances of
-    #   Discovery.
-    # @param project_id [String] The ID of the project. This information can be found from the deploy page of the
-    #   Discovery administrative tooling.
+    #   **Note:** This method is supported on installed instances of Discovery only.
+    # @param project_id [String] The ID of the project. This information can be found from the *Integrate and
+    #   Deploy* page in Discovery.
     # @param collection_id [String] The ID of the collection.
-    # @param file [File] The content of the document to ingest. The maximum supported file size when adding
-    #   a file to a collection is 50 megabytes, the maximum supported file size when
-    #   testing a configuration is 1 megabyte. Files larger than the supported size are
-    #   rejected.
+    # @param file [File] The content of the document to ingest. For maximum supported file size limits, see
+    #   [the
+    #   documentation](https://cloud.ibm.com/docs/discovery-data?topic=discovery-data-collections#collections-doc-limits).
     # @param filename [String] The filename for file.
     # @param file_content_type [String] The content type of file.
     # @param metadata [String] The maximum supported metadata file size is 1 MB. Metadata parts larger than 1 MB
@@ -1055,9 +1138,11 @@ module IBMWatson
     ##
     # @!method list_enrichments(project_id:)
     # List Enrichments.
-    # List the enrichments available to this project.
-    # @param project_id [String] The ID of the project. This information can be found from the deploy page of the
-    #   Discovery administrative tooling.
+    # Lists the enrichments available to this project. The *Part of Speech* and
+    #   *Sentiment of Phrases* enrichments might be listed, but are reserved for internal
+    #   use only.
+    # @param project_id [String] The ID of the project. This information can be found from the *Integrate and
+    #   Deploy* page in Discovery.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def list_enrichments(project_id:)
       raise ArgumentError.new("version must be provided") if version.nil?
@@ -1088,10 +1173,10 @@ module IBMWatson
     ##
     # @!method create_enrichment(project_id:, enrichment:, file: nil)
     # Create an enrichment.
-    # Create an enrichment for use with the specified project/.
-    # @param project_id [String] The ID of the project. This information can be found from the deploy page of the
-    #   Discovery administrative tooling.
-    # @param enrichment [CreateEnrichment]
+    # Create an enrichment for use with the specified project.
+    # @param project_id [String] The ID of the project. This information can be found from the *Integrate and
+    #   Deploy* page in Discovery.
+    # @param enrichment [CreateEnrichment] Information about a specific enrichment.
     # @param file [File] The enrichment file to upload.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def create_enrichment(project_id:, enrichment:, file: nil)
@@ -1138,8 +1223,8 @@ module IBMWatson
     # @!method get_enrichment(project_id:, enrichment_id:)
     # Get enrichment.
     # Get details about a specific enrichment.
-    # @param project_id [String] The ID of the project. This information can be found from the deploy page of the
-    #   Discovery administrative tooling.
+    # @param project_id [String] The ID of the project. This information can be found from the *Integrate and
+    #   Deploy* page in Discovery.
     # @param enrichment_id [String] The ID of the enrichment.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def get_enrichment(project_id:, enrichment_id:)
@@ -1174,8 +1259,8 @@ module IBMWatson
     # @!method update_enrichment(project_id:, enrichment_id:, name:, description: nil)
     # Update an enrichment.
     # Updates an existing enrichment's name and description.
-    # @param project_id [String] The ID of the project. This information can be found from the deploy page of the
-    #   Discovery administrative tooling.
+    # @param project_id [String] The ID of the project. This information can be found from the *Integrate and
+    #   Deploy* page in Discovery.
     # @param enrichment_id [String] The ID of the enrichment.
     # @param name [String] A new name for the enrichment.
     # @param description [String] A new description for the enrichment.
@@ -1222,8 +1307,8 @@ module IBMWatson
     # Deletes an existing enrichment from the specified project.
     #
     #   **Note:** Only enrichments that have been manually created can be deleted.
-    # @param project_id [String] The ID of the project. This information can be found from the deploy page of the
-    #   Discovery administrative tooling.
+    # @param project_id [String] The ID of the project. This information can be found from the *Integrate and
+    #   Deploy* page in Discovery.
     # @param enrichment_id [String] The ID of the enrichment.
     # @return [nil]
     def delete_enrichment(project_id:, enrichment_id:)
@@ -1291,7 +1376,13 @@ module IBMWatson
     # Create a Project.
     # Create a new project for this instance.
     # @param name [String] The human readable name of this project.
-    # @param type [String] The project type of this project.
+    # @param type [String] The type of project.
+    #
+    #   The `content_intelligence` type is a *Document Retrieval for Contracts* project
+    #   and the `other` type is a *Custom* project.
+    #
+    #   The `content_mining` and `content_intelligence` types are available with Premium
+    #   plan managed deployments and installed deployments only.
     # @param default_query_parameters [DefaultQueryParams] Default query parameters for this project.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def create_project(name:, type:, default_query_parameters: nil)
@@ -1333,8 +1424,8 @@ module IBMWatson
     # @!method get_project(project_id:)
     # Get project.
     # Get details on the specified project.
-    # @param project_id [String] The ID of the project. This information can be found from the deploy page of the
-    #   Discovery administrative tooling.
+    # @param project_id [String] The ID of the project. This information can be found from the *Integrate and
+    #   Deploy* page in Discovery.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def get_project(project_id:)
       raise ArgumentError.new("version must be provided") if version.nil?
@@ -1366,8 +1457,8 @@ module IBMWatson
     # @!method update_project(project_id:, name: nil)
     # Update a project.
     # Update the specified project's name.
-    # @param project_id [String] The ID of the project. This information can be found from the deploy page of the
-    #   Discovery administrative tooling.
+    # @param project_id [String] The ID of the project. This information can be found from the *Integrate and
+    #   Deploy* page in Discovery.
     # @param name [String] The new name to give this project.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def update_project(project_id:, name: nil)
@@ -1408,8 +1499,8 @@ module IBMWatson
     #
     #   **Important:** Deleting a project deletes everything that is part of the specified
     #   project, including all collections.
-    # @param project_id [String] The ID of the project. This information can be found from the deploy page of the
-    #   Discovery administrative tooling.
+    # @param project_id [String] The ID of the project. This information can be found from the *Integrate and
+    #   Deploy* page in Discovery.
     # @return [nil]
     def delete_project(project_id:)
       raise ArgumentError.new("version must be provided") if version.nil?