ibm_watson 0.5.1 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cf8a43fdfbace0a7f6718700990e2fa10a0cc1f5b1914f0612cda793060dad12
-  data.tar.gz: e62aab095b1541fc2226ade4591fd3f6a47bfd67487c7721c33dcc2a740f7f7a
+  metadata.gz: a3aee888f8b5b95bd89cc0e4fcce469bb4cbf9547ca93d6c0d59b899031c5558
+  data.tar.gz: ab13ed414ee0c6a572cc86a48c6dc49c8f3c0305586778bd4f71a8d880183248
 SHA512:
-  metadata.gz: 7518225b4a7cad2ccfdc83f4ac5b8ed4c5a376c07b13fb3e7d636d3a79abd8e82a943413737a99e922150e6e2e4109e0da1c6bb52b353dd756513523eec066ea
-  data.tar.gz: d7af5413d872fff10b901a2fb38571b0c7b2d78c6fdb7d9f622f51619603c4c475959e1bdf6bb0d99092be41edc6812e9df7f293d6e8e22074a7a803187ee97b
+  metadata.gz: 67e25a43ec539edfb3c75fba544388238d1b155950386cb008930e77f1486a21c567ffc6574380275f0cb9302d3148365fe230367b4230400945300c456e3225
+  data.tar.gz: 2eba798a910e335ce5cdcc290243ad4fb7ceedfaa22710c9a5137689e3d81aec034c72159b6f051dc73e257cedd20786b275d3ca4ff663f8292a769937b7bc04

data/README.md

@@ -6,6 +6,7 @@
 [![codecov.io](https://codecov.io/github/watson-developer-cloud/ruby-sdk/coverage.svg)](https://codecov.io/github/watson-developer-cloud/ruby-sdk)
 [![Gem Version](https://badge.fury.io/rb/ibm_watson.svg)](https://badge.fury.io/rb/ibm_watson)
 [![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release)
+[![CLA assistant](https://cla-assistant.io/readme/badge/watson-developer-cloud/ruby-sdk)](https://cla-assistant.io/watson-developer-cloud/ruby-sdk)
 
 Ruby gem to quickly get started with the various [IBM Watson][wdc] services.
 
@@ -99,7 +100,7 @@ discovery = IBMWatson::DiscoveryV1.new(
 ```ruby
 # after instantiation, letting the SDK manage the IAM token
 discovery = IBMWatson::DiscoveryV1.new(version: "2017-10-16")
-discovery._iam_apikey(iam_apikey: "<iam_apikey>")
+discovery.iam_apikey(iam_apikey: "<iam_apikey>")
 ```
 
 #### Supplying the access token
@@ -114,7 +115,7 @@ discovery = IBMWatson::DiscoveryV1.new(
 ```ruby
 # after instantiation, assuming control of managing IAM token
 discovery = IBMWatson::DiscoveryV1.new(version: "2017-10-16")
-discovery._iam_access_token(iam_access_token: "<access_token>")
+discovery.iam_access_token(iam_access_token: "<access_token>")
 ```
 
 ### Username and password

data/lib/ibm_watson/assistant_v1.rb

@@ -29,7 +29,7 @@ require_relative "./watson_service"
 module IBMWatson
   ##
   # The Assistant V1 service.
-  class AssistantV1
+  class AssistantV1 < WatsonService
     include Concurrent::Async
     ##
     # @!method initialize(args)
@@ -70,7 +70,6 @@ module IBMWatson
     #   'https://iam.ng.bluemix.net/identity/token'.
     def initialize(args = {})
       @__async_initialized__ = false
-      super()
       defaults = {}
       defaults[:version] = nil
       defaults[:url] = "https://gateway.watsonplatform.net/assistant/api"
@@ -80,84 +79,11 @@ module IBMWatson
       defaults[:iam_access_token] = nil
       defaults[:iam_url] = nil
       args = defaults.merge(args)
-      @watson_service = WatsonService.new(
-        vcap_services_name: "conversation",
-        url: args[:url],
-        username: args[:username],
-        password: args[:password],
-        iam_apikey: args[:iam_apikey],
-        iam_access_token: args[:iam_access_token],
-        iam_url: args[:iam_url],
-        use_vcap_services: true
-      )
+      args[:vcap_services_name] = "conversation"
+      super
       @version = args[:version]
     end
 
-    # :nocov:
-    def add_default_headers(headers: {})
-      @watson_service.add_default_headers(headers: headers)
-    end
-
-    def _iam_access_token(iam_access_token:)
-      @watson_service._iam_access_token(iam_access_token: iam_access_token)
-    end
-
-    def _iam_apikey(iam_apikey:)
-      @watson_service._iam_apikey(iam_apikey: iam_apikey)
-    end
-
-    # @return [DetailedResponse]
-    def request(args)
-      @watson_service.request(args)
-    end
-
-    # @note Chainable
-    # @param headers [Hash] Custom headers to be sent with the request
-    # @return [self]
-    def headers(headers)
-      @watson_service.headers(headers)
-      self
-    end
-
-    def password=(password)
-      @watson_service.password = password
-    end
-
-    def password
-      @watson_service.password
-    end
-
-    def username=(username)
-      @watson_service.username = username
-    end
-
-    def username
-      @watson_service.username
-    end
-
-    def url=(url)
-      @watson_service.url = url
-    end
-
-    def url
-      @watson_service.url
-    end
-
-    # @!method configure_http_client(proxy: {}, timeout: {})
-    # Sets the http client config, currently works with timeout and proxies
-    # @param proxy [Hash] The hash of proxy configurations
-    # @option proxy address [String] The address of the proxy
-    # @option proxy port [Integer] The port of the proxy
-    # @option proxy username [String] The username of the proxy, if authentication is needed
-    # @option proxy password [String] The password of the proxy, if authentication is needed
-    # @option proxy headers [Hash] The headers to be used with the proxy
-    # @param timeout [Hash] The hash for configuring timeouts. `per_operation` has priority over `global`
-    # @option timeout per_operation [Hash] Timeouts per operation. Requires `read`, `write`, `connect`
-    # @option timeout global [Integer] Upper bound on total request time
-    def configure_http_client(proxy: {}, timeout: {})
-      @watson_service.configure_http_client(proxy: proxy, timeout: timeout)
-    end
-    # :nocov:
     #########################
     # Message
     #########################
@@ -187,6 +113,7 @@ module IBMWatson
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def message(workspace_id:, input: nil, alternate_intents: nil, context: nil, entities: nil, intents: nil, output: nil, nodes_visited_details: nil)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       headers = {
       }
       params = {
@@ -226,8 +153,7 @@ module IBMWatson
     # @param page_limit [Fixnum] The number of records to return in each page of results.
     # @param include_count [Boolean] Whether to include information about the number of records returned.
     # @param sort [String] The attribute by which returned results will be sorted. To reverse the sort order,
-    #   prefix the value with a minus sign (`-`). Supported values are `name`, `updated`,
-    #   and `workspace_id`.
+    #   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.
@@ -324,6 +250,7 @@ module IBMWatson
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def get_workspace(workspace_id:, export: nil, include_audit: nil)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       headers = {
       }
       params = {
@@ -377,6 +304,7 @@ module IBMWatson
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def update_workspace(workspace_id:, name: nil, description: nil, language: nil, intents: nil, entities: nil, dialog_nodes: nil, counterexamples: nil, metadata: nil, learning_opt_out: nil, system_settings: nil, append: nil)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       headers = {
       }
       params = {
@@ -418,6 +346,7 @@ module IBMWatson
     # @return [nil]
     def delete_workspace(workspace_id:)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       headers = {
       }
       params = {
@@ -452,14 +381,14 @@ module IBMWatson
     # @param page_limit [Fixnum] The number of records to return in each page of results.
     # @param include_count [Boolean] Whether to include information about the number of records returned.
     # @param sort [String] The attribute by which returned results will be sorted. To reverse the sort order,
-    #   prefix the value with a minus sign (`-`). Supported values are `name`, `updated`,
-    #   and `workspace_id`.
+    #   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 [DetailedResponse] A `DetailedResponse` object representing the response.
     def list_intents(workspace_id:, export: nil, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       headers = {
       }
       params = {
@@ -501,7 +430,9 @@ module IBMWatson
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def create_intent(workspace_id:, intent:, description: nil, examples: nil)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       raise ArgumentError("intent must be provided") if intent.nil?
+
       headers = {
       }
       params = {
@@ -542,7 +473,9 @@ module IBMWatson
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def get_intent(workspace_id:, intent:, export: nil, include_audit: nil)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       raise ArgumentError("intent must be provided") if intent.nil?
+
       headers = {
       }
       params = {
@@ -581,7 +514,9 @@ module IBMWatson
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def update_intent(workspace_id:, intent:, new_intent: nil, new_description: nil, new_examples: nil)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       raise ArgumentError("intent must be provided") if intent.nil?
+
       headers = {
       }
       params = {
@@ -616,7 +551,9 @@ module IBMWatson
     # @return [nil]
     def delete_intent(workspace_id:, intent:)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       raise ArgumentError("intent must be provided") if intent.nil?
+
       headers = {
       }
       params = {
@@ -649,15 +586,16 @@ module IBMWatson
     # @param page_limit [Fixnum] The number of records to return in each page of results.
     # @param include_count [Boolean] Whether to include information about the number of records returned.
     # @param sort [String] The attribute by which returned results will be sorted. To reverse the sort order,
-    #   prefix the value with a minus sign (`-`). Supported values are `name`, `updated`,
-    #   and `workspace_id`.
+    #   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 [DetailedResponse] A `DetailedResponse` object representing the response.
     def list_examples(workspace_id:, intent:, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       raise ArgumentError("intent must be provided") if intent.nil?
+
       headers = {
       }
       params = {
@@ -697,8 +635,11 @@ module IBMWatson
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def create_example(workspace_id:, intent:, text:, mentions: nil)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       raise ArgumentError("intent must be provided") if intent.nil?
+
       raise ArgumentError("text must be provided") if text.nil?
+
       headers = {
       }
       params = {
@@ -735,8 +676,11 @@ module IBMWatson
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def get_example(workspace_id:, intent:, text:, include_audit: nil)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       raise ArgumentError("intent must be provided") if intent.nil?
+
       raise ArgumentError("text must be provided") if text.nil?
+
       headers = {
       }
       params = {
@@ -773,8 +717,11 @@ module IBMWatson
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def update_example(workspace_id:, intent:, text:, new_text: nil, new_mentions: nil)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       raise ArgumentError("intent must be provided") if intent.nil?
+
       raise ArgumentError("text must be provided") if text.nil?
+
       headers = {
       }
       params = {
@@ -809,8 +756,11 @@ module IBMWatson
     # @return [nil]
     def delete_example(workspace_id:, intent:, text:)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       raise ArgumentError("intent must be provided") if intent.nil?
+
       raise ArgumentError("text must be provided") if text.nil?
+
       headers = {
       }
       params = {
@@ -842,14 +792,14 @@ module IBMWatson
     # @param page_limit [Fixnum] The number of records to return in each page of results.
     # @param include_count [Boolean] Whether to include information about the number of records returned.
     # @param sort [String] The attribute by which returned results will be sorted. To reverse the sort order,
-    #   prefix the value with a minus sign (`-`). Supported values are `name`, `updated`,
-    #   and `workspace_id`.
+    #   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 [DetailedResponse] A `DetailedResponse` object representing the response.
     def list_counterexamples(workspace_id:, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       headers = {
       }
       params = {
@@ -888,7 +838,9 @@ module IBMWatson
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def create_counterexample(workspace_id:, text:)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       raise ArgumentError("text must be provided") if text.nil?
+
       headers = {
       }
       params = {
@@ -924,7 +876,9 @@ module IBMWatson
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def get_counterexample(workspace_id:, text:, include_audit: nil)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       raise ArgumentError("text must be provided") if text.nil?
+
       headers = {
       }
       params = {
@@ -956,7 +910,9 @@ module IBMWatson
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def update_counterexample(workspace_id:, text:, new_text: nil)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       raise ArgumentError("text must be provided") if text.nil?
+
       headers = {
       }
       params = {
@@ -990,7 +946,9 @@ module IBMWatson
     # @return [nil]
     def delete_counterexample(workspace_id:, text:)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       raise ArgumentError("text must be provided") if text.nil?
+
       headers = {
       }
       params = {
@@ -1025,14 +983,14 @@ module IBMWatson
     # @param page_limit [Fixnum] The number of records to return in each page of results.
     # @param include_count [Boolean] Whether to include information about the number of records returned.
     # @param sort [String] The attribute by which returned results will be sorted. To reverse the sort order,
-    #   prefix the value with a minus sign (`-`). Supported values are `name`, `updated`,
-    #   and `workspace_id`.
+    #   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 [DetailedResponse] A `DetailedResponse` object representing the response.
     def list_entities(workspace_id:, export: nil, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       headers = {
       }
       params = {
@@ -1075,7 +1033,9 @@ module IBMWatson
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def create_entity(workspace_id:, entity:, description: nil, metadata: nil, values: nil, fuzzy_match: nil)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       raise ArgumentError("entity must be provided") if entity.nil?
+
       headers = {
       }
       params = {
@@ -1118,7 +1078,9 @@ module IBMWatson
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def get_entity(workspace_id:, entity:, export: nil, include_audit: nil)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       raise ArgumentError("entity must be provided") if entity.nil?
+
       headers = {
       }
       params = {
@@ -1159,7 +1121,9 @@ module IBMWatson
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def update_entity(workspace_id:, entity:, new_entity: nil, new_description: nil, new_metadata: nil, new_fuzzy_match: nil, new_values: nil)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       raise ArgumentError("entity must be provided") if entity.nil?
+
       headers = {
       }
       params = {
@@ -1196,7 +1160,9 @@ module IBMWatson
     # @return [nil]
     def delete_entity(workspace_id:, entity:)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       raise ArgumentError("entity must be provided") if entity.nil?
+
       headers = {
       }
       params = {
@@ -1234,7 +1200,9 @@ module IBMWatson
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def list_mentions(workspace_id:, entity:, export: nil, include_audit: nil)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       raise ArgumentError("entity must be provided") if entity.nil?
+
       headers = {
       }
       params = {
@@ -1271,15 +1239,16 @@ module IBMWatson
     # @param page_limit [Fixnum] The number of records to return in each page of results.
     # @param include_count [Boolean] Whether to include information about the number of records returned.
     # @param sort [String] The attribute by which returned results will be sorted. To reverse the sort order,
-    #   prefix the value with a minus sign (`-`). Supported values are `name`, `updated`,
-    #   and `workspace_id`.
+    #   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 [DetailedResponse] A `DetailedResponse` object representing the response.
     def list_values(workspace_id:, entity:, export: nil, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       raise ArgumentError("entity must be provided") if entity.nil?
+
       headers = {
       }
       params = {
@@ -1332,8 +1301,11 @@ module IBMWatson
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def create_value(workspace_id:, entity:, value:, metadata: nil, synonyms: nil, patterns: nil, value_type: nil)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       raise ArgumentError("entity must be provided") if entity.nil?
+
       raise ArgumentError("value must be provided") if value.nil?
+
       headers = {
       }
       params = {
@@ -1376,8 +1348,11 @@ module IBMWatson
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def get_value(workspace_id:, entity:, value:, export: nil, include_audit: nil)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       raise ArgumentError("entity must be provided") if entity.nil?
+
       raise ArgumentError("value must be provided") if value.nil?
+
       headers = {
       }
       params = {
@@ -1428,8 +1403,11 @@ module IBMWatson
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def update_value(workspace_id:, entity:, value:, new_value: nil, new_metadata: nil, new_type: nil, new_synonyms: nil, new_patterns: nil)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       raise ArgumentError("entity must be provided") if entity.nil?
+
       raise ArgumentError("value must be provided") if value.nil?
+
       headers = {
       }
       params = {
@@ -1467,8 +1445,11 @@ module IBMWatson
     # @return [nil]
     def delete_value(workspace_id:, entity:, value:)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       raise ArgumentError("entity must be provided") if entity.nil?
+
       raise ArgumentError("value must be provided") if value.nil?
+
       headers = {
       }
       params = {
@@ -1501,16 +1482,18 @@ module IBMWatson
     # @param page_limit [Fixnum] The number of records to return in each page of results.
     # @param include_count [Boolean] Whether to include information about the number of records returned.
     # @param sort [String] The attribute by which returned results will be sorted. To reverse the sort order,
-    #   prefix the value with a minus sign (`-`). Supported values are `name`, `updated`,
-    #   and `workspace_id`.
+    #   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 [DetailedResponse] A `DetailedResponse` object representing the response.
     def list_synonyms(workspace_id:, entity:, value:, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       raise ArgumentError("entity must be provided") if entity.nil?
+
       raise ArgumentError("value must be provided") if value.nil?
+
       headers = {
       }
       params = {
@@ -1549,9 +1532,13 @@ module IBMWatson
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def create_synonym(workspace_id:, entity:, value:, synonym:)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       raise ArgumentError("entity must be provided") if entity.nil?
+
       raise ArgumentError("value must be provided") if value.nil?
+
       raise ArgumentError("synonym must be provided") if synonym.nil?
+
       headers = {
       }
       params = {
@@ -1588,9 +1575,13 @@ module IBMWatson
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def get_synonym(workspace_id:, entity:, value:, synonym:, include_audit: nil)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       raise ArgumentError("entity must be provided") if entity.nil?
+
       raise ArgumentError("value must be provided") if value.nil?
+
       raise ArgumentError("synonym must be provided") if synonym.nil?
+
       headers = {
       }
       params = {
@@ -1626,9 +1617,13 @@ module IBMWatson
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def update_synonym(workspace_id:, entity:, value:, synonym:, new_synonym: nil)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       raise ArgumentError("entity must be provided") if entity.nil?
+
       raise ArgumentError("value must be provided") if value.nil?
+
       raise ArgumentError("synonym must be provided") if synonym.nil?
+
       headers = {
       }
       params = {
@@ -1663,9 +1658,13 @@ module IBMWatson
     # @return [nil]
     def delete_synonym(workspace_id:, entity:, value:, synonym:)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       raise ArgumentError("entity must be provided") if entity.nil?
+
       raise ArgumentError("value must be provided") if value.nil?
+
       raise ArgumentError("synonym must be provided") if synonym.nil?
+
       headers = {
       }
       params = {
@@ -1696,14 +1695,14 @@ module IBMWatson
     # @param page_limit [Fixnum] The number of records to return in each page of results.
     # @param include_count [Boolean] Whether to include information about the number of records returned.
     # @param sort [String] The attribute by which returned results will be sorted. To reverse the sort order,
-    #   prefix the value with a minus sign (`-`). Supported values are `name`, `updated`,
-    #   and `workspace_id`.
+    #   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 [DetailedResponse] A `DetailedResponse` object representing the response.
     def list_dialog_nodes(workspace_id:, page_limit: nil, include_count: nil, sort: nil, cursor: nil, include_audit: nil)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       headers = {
       }
       params = {
@@ -1763,11 +1762,13 @@ module IBMWatson
     # @param digress_out [String] Whether this dialog node can be returned to after a digression.
     # @param digress_out_slots [String] Whether the user can digress to top-level nodes while filling out slots.
     # @param user_label [String] A label that can be displayed externally to describe the purpose of the node to
-    #   users.
+    #   users. This string must be no longer than 512 characters.
     # @return [DetailedResponse] A `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, actions: nil, title: nil, node_type: nil, event_name: nil, variable: nil, digress_in: nil, digress_out: nil, digress_out_slots: nil, user_label: nil)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       raise ArgumentError("dialog_node must be provided") if dialog_node.nil?
+
       headers = {
       }
       params = {
@@ -1819,7 +1820,9 @@ module IBMWatson
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def get_dialog_node(workspace_id:, dialog_node:, include_audit: nil)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       raise ArgumentError("dialog_node must be provided") if dialog_node.nil?
+
       headers = {
       }
       params = {
@@ -1876,11 +1879,13 @@ module IBMWatson
     # @param new_digress_out [String] Whether this dialog node can be returned to after a digression.
     # @param new_digress_out_slots [String] Whether the user can digress to top-level nodes while filling out slots.
     # @param new_user_label [String] A label that can be displayed externally to describe the purpose of the node to
-    #   users.
+    #   users. This string must be no longer than 512 characters.
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def update_dialog_node(workspace_id:, dialog_node:, new_dialog_node: nil, new_description: nil, new_conditions: nil, new_parent: nil, new_previous_sibling: nil, new_output: nil, new_context: nil, new_metadata: nil, new_next_step: nil, new_title: nil, new_type: nil, new_event_name: nil, new_variable: nil, new_actions: nil, new_digress_in: nil, new_digress_out: nil, new_digress_out_slots: nil, new_user_label: nil)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       raise ArgumentError("dialog_node must be provided") if dialog_node.nil?
+
       headers = {
       }
       params = {
@@ -1930,7 +1935,9 @@ module IBMWatson
     # @return [nil]
     def delete_dialog_node(workspace_id:, dialog_node:)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       raise ArgumentError("dialog_node must be provided") if dialog_node.nil?
+
       headers = {
       }
       params = {
@@ -1959,9 +1966,8 @@ module IBMWatson
     #   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] The attribute by which returned results will be sorted. To reverse the sort order,
-    #   prefix the value with a minus sign (`-`). Supported values are `name`, `updated`,
-    #   and `workspace_id`.
+    # @param sort [String] How to sort the returned log events. You can sort by **request_timestamp**. To
+    #   reverse the sort order, prefix the parameter value with a minus sign (`-`).
     # @param filter [String] A cacheable parameter that limits the results to those matching the specified
     #   filter. For more information, see the
     #   [documentation](https://console.bluemix.net/docs/services/conversation/filter-reference.html#filter-query-syntax).
@@ -1970,6 +1976,7 @@ module IBMWatson
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def list_logs(workspace_id:, sort: nil, filter: nil, page_limit: nil, cursor: nil)
       raise ArgumentError("workspace_id must be provided") if workspace_id.nil?
+
       headers = {
       }
       params = {
@@ -2003,14 +2010,14 @@ module IBMWatson
     #   well as a value for `workspace_id` or `request.context.metadata.deployment`. For
     #   more information, see the
     #   [documentation](https://console.bluemix.net/docs/services/conversation/filter-reference.html#filter-query-syntax).
-    # @param sort [String] The attribute by which returned results will be sorted. To reverse the sort order,
-    #   prefix the value with a minus sign (`-`). Supported values are `name`, `updated`,
-    #   and `workspace_id`.
+    # @param sort [String] How to sort the returned log events. You can sort by **request_timestamp**. To
+    #   reverse the sort order, prefix the parameter value with a minus sign (`-`).
     # @param page_limit [Fixnum] The number of records to return in each page of results.
     # @param cursor [String] A token identifying the page of results to retrieve.
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def list_all_logs(filter:, sort: nil, page_limit: nil, cursor: nil)
       raise ArgumentError("filter must be provided") if filter.nil?
+
       headers = {
       }
       params = {
@@ -2048,6 +2055,7 @@ module IBMWatson
     # @return [nil]
     def delete_user_data(customer_id:)
       raise ArgumentError("customer_id must be provided") if customer_id.nil?
+
       headers = {
       }
       params = {