ibm_watson 0.10.0 → 0.11.0

data/lib/ibm_watson/speech_to_text_v1.rb

@@ -30,8 +30,12 @@
 # The service also offers two customization interfaces. Use language model customization
 # to expand the vocabulary of a base model with domain-specific terminology. Use acoustic
 # model customization to adapt a base model for the acoustic characteristics of your
-# audio. Language model customization is generally available for production use with most
-# supported languages; acoustic model customization is beta functionality that is
+# audio. For language model customization, the service also supports grammars. A grammar
+# is a formal language specification that lets you restrict the phrases that the service
+# can recognize.
+#
+# Language model customization is generally available for production use with most
+# supported languages. Acoustic model customization is beta functionality that is
 # available for all supported languages.
 
 require "concurrent"
@@ -100,7 +104,7 @@ module IBMWatson
     #   among other things.
     #
     #   **See also:** [Languages and
-    #   models](https://console.bluemix.net/docs/services/speech-to-text/input.html#models).
+    #   models](https://cloud.ibm.com/docs/services/speech-to-text/models.html).
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def list_models
       headers = {
@@ -125,7 +129,7 @@ module IBMWatson
     #   sampling rate in Hertz, among other things.
     #
     #   **See also:** [Languages and
-    #   models](https://console.bluemix.net/docs/services/speech-to-text/input.html#models).
+    #   models](https://cloud.ibm.com/docs/services/speech-to-text/models.html).
     # @param model_id [String] The identifier of the model in the form of its name from the output of the **Get a
     #   model** method.
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
@@ -150,7 +154,7 @@ module IBMWatson
     #########################
 
     ##
-    # @!method recognize(audio:, content_type: nil, model: nil, language_customization_id: nil, acoustic_customization_id: nil, base_model_version: nil, customization_weight: nil, inactivity_timeout: nil, keywords: nil, keywords_threshold: nil, max_alternatives: nil, word_alternatives_threshold: nil, word_confidence: nil, timestamps: nil, profanity_filter: nil, smart_formatting: nil, speaker_labels: nil, customization_id: nil)
+    # @!method recognize(audio:, content_type: nil, model: nil, language_customization_id: nil, acoustic_customization_id: nil, base_model_version: nil, customization_weight: nil, inactivity_timeout: nil, keywords: nil, keywords_threshold: nil, max_alternatives: nil, word_alternatives_threshold: nil, word_confidence: nil, timestamps: nil, profanity_filter: nil, smart_formatting: nil, speaker_labels: nil, customization_id: nil, grammar_name: nil, redaction: nil)
     # Recognize audio.
     # Sends audio and returns transcription results for a recognition request. You can
     #   pass a maximum of 100 MB and a minimum of 100 bytes of audio with a request. The
@@ -160,7 +164,8 @@ module IBMWatson
     #   the WebSocket API.
     #
     #   **See also:** [Making a basic HTTP
-    #   request](https://console.bluemix.net/docs/services/speech-to-text/http.html#HTTP-basic).
+    #   request](https://cloud.ibm.com/docs/services/speech-to-text/http.html#HTTP-basic).
+    #
     #
     #   ### Streaming mode
     #
@@ -173,8 +178,11 @@ module IBMWatson
     #   `inactivity_timeout` parameter to change the default of 30 seconds.
     #
     #   **See also:**
-    #   * [Audio transmission](https://console.bluemix.net/docs/services/speech-to-text/input.html#transmission)
-    #   * [Timeouts](https://console.bluemix.net/docs/services/speech-to-text/input.html#timeouts)
+    #   * [Audio
+    #   transmission](https://cloud.ibm.com/docs/services/speech-to-text/input.html#transmission)
+    #   *
+    #   [Timeouts](https://cloud.ibm.com/docs/services/speech-to-text/input.html#timeouts)
+    #
     #
     #   ### Audio formats (content types)
     #
@@ -190,6 +198,7 @@ module IBMWatson
     #   can optionally include the number of channels and the endianness of the audio.
     #   * `audio/basic` (**Required.** Use only with narrowband models.)
     #   * `audio/flac`
+    #   * `audio/g729` (Use only with narrowband models.)
     #   * `audio/l16` (**Required.** Specify the sampling rate (`rate`) and optionally the
     #   number of channels (`channels`) and endianness (`endianness`) of the audio.)
     #   * `audio/mp3`
@@ -203,7 +212,15 @@ module IBMWatson
     #   * `audio/webm;codecs=opus`
     #   * `audio/webm;codecs=vorbis`
     #
-    #   **See also:** [Audio formats](https://console.bluemix.net/docs/services/speech-to-text/audio-formats.html).
+    #   The sampling rate of the audio must match the sampling rate of the model for the
+    #   recognition request: for broadband models, at least 16 kHz; for narrowband models,
+    #   at least 8 kHz. If the sampling rate of the audio is higher than the minimum
+    #   required rate, the service down-samples the audio to the appropriate rate. If the
+    #   sampling rate of the audio is lower than the minimum required rate, the request
+    #   fails.
+    #
+    #    **See also:** [Audio
+    #   formats](https://cloud.ibm.com/docs/services/speech-to-text/audio-formats.html).
     #
     #   ### Multipart speech recognition
     #
@@ -220,32 +237,34 @@ module IBMWatson
     #   example, if you want to spot a very large number of keywords.
     #
     #   **See also:** [Making a multipart HTTP
-    #   request](https://console.bluemix.net/docs/services/speech-to-text/http.html#HTTP-multi).
+    #   request](https://cloud.ibm.com/docs/services/speech-to-text/http.html#HTTP-multi).
     # @param audio [String] The audio to transcribe.
     # @param content_type [String] The format (MIME type) of the audio. For more information about specifying an
     #   audio format, see **Audio formats (content types)** in the method description.
-    # @param model [String] The identifier of the model that is to be used for the recognition request.
+    # @param model [String] The identifier of the model that is to be used for the recognition request. See
+    #   [Languages and
+    #   models](https://cloud.ibm.com/docs/services/speech-to-text/models.html).
     # @param language_customization_id [String] The customization ID (GUID) of a custom language model that is to be used with the
     #   recognition request. The base model of the specified custom language model must
     #   match the model specified with the `model` parameter. You must make the request
-    #   with service credentials created for the instance of the service that owns the
-    #   custom model. By default, no custom language model is used. See [Custom
-    #   models](https://console.bluemix.net/docs/services/speech-to-text/input.html#custom).
+    #   with credentials for the instance of the service that owns the custom model. By
+    #   default, no custom language model is used. See [Custom
+    #   models](https://cloud.ibm.com/docs/services/speech-to-text/input.html#custom).
     #
     #   **Note:** Use this parameter instead of the deprecated `customization_id`
     #   parameter.
     # @param acoustic_customization_id [String] The customization ID (GUID) of a custom acoustic model that is to be used with the
     #   recognition request. The base model of the specified custom acoustic model must
     #   match the model specified with the `model` parameter. You must make the request
-    #   with service credentials created for the instance of the service that owns the
-    #   custom model. By default, no custom acoustic model is used. See [Custom
-    #   models](https://console.bluemix.net/docs/services/speech-to-text/input.html#custom).
+    #   with credentials for the instance of the service that owns the custom model. By
+    #   default, no custom acoustic model is used. See [Custom
+    #   models](https://cloud.ibm.com/docs/services/speech-to-text/input.html#custom).
     # @param base_model_version [String] The version of the specified base model that is to be used with recognition
     #   request. Multiple versions of a base model can exist when a model is updated for
     #   internal improvements. The parameter is intended primarily for use with custom
     #   models that have been upgraded for a new base model. The default value depends on
     #   whether the parameter is used with or without a custom model. See [Base model
-    #   version](https://console.bluemix.net/docs/services/speech-to-text/input.html#version).
+    #   version](https://cloud.ibm.com/docs/services/speech-to-text/input.html#version).
     # @param customization_weight [Float] If you specify the customization ID (GUID) of a custom language model with the
     #   recognition request, the customization weight tells the service how much weight to
     #   give to words from the custom language model compared to those from the base model
@@ -262,64 +281,94 @@ module IBMWatson
     #   custom model's domain, but it can negatively affect performance on non-domain
     #   phrases.
     #
-    #   See [Custom models](https://console.bluemix.net/docs/services/speech-to-text/input.html#custom).
+    #   See [Custom
+    #   models](https://cloud.ibm.com/docs/services/speech-to-text/input.html#custom).
     # @param inactivity_timeout [Fixnum] The time in seconds after which, if only silence (no speech) is detected in
     #   submitted audio, the connection is closed with a 400 error. The parameter is
     #   useful for stopping audio submission from a live microphone when a user simply
     #   walks away. Use `-1` for infinity. See
-    #   [Timeouts](https://console.bluemix.net/docs/services/speech-to-text/input.html#timeouts).
+    #   [Timeouts](https://cloud.ibm.com/docs/services/speech-to-text/input.html#timeouts).
     # @param keywords [Array[String]] An array of keyword strings to spot in the audio. Each keyword string can include
     #   one or more string tokens. Keywords are spotted only in the final results, not in
     #   interim hypotheses. If you specify any keywords, you must also specify a keywords
     #   threshold. You can spot a maximum of 1000 keywords. Omit the parameter or specify
     #   an empty array if you do not need to spot keywords. See [Keyword
-    #   spotting](https://console.bluemix.net/docs/services/speech-to-text/output.html#keyword_spotting).
+    #   spotting](https://cloud.ibm.com/docs/services/speech-to-text/output.html#keyword_spotting).
     # @param keywords_threshold [Float] A confidence value that is the lower bound for spotting a keyword. A word is
     #   considered to match a keyword if its confidence is greater than or equal to the
-    #   threshold. Specify a probability between 0.0 and 1.0. No keyword spotting is
-    #   performed if you omit the parameter. If you specify a threshold, you must also
-    #   specify one or more keywords. See [Keyword
-    #   spotting](https://console.bluemix.net/docs/services/speech-to-text/output.html#keyword_spotting).
+    #   threshold. Specify a probability between 0.0 and 1.0. If you specify a threshold,
+    #   you must also specify one or more keywords. The service performs no keyword
+    #   spotting if you omit either parameter. See [Keyword
+    #   spotting](https://cloud.ibm.com/docs/services/speech-to-text/output.html#keyword_spotting).
     # @param max_alternatives [Fixnum] The maximum number of alternative transcripts that the service is to return. By
-    #   default, a single transcription is returned. See [Maximum
-    #   alternatives](https://console.bluemix.net/docs/services/speech-to-text/output.html#max_alternatives).
+    #   default, the service returns a single transcript. See [Maximum
+    #   alternatives](https://cloud.ibm.com/docs/services/speech-to-text/output.html#max_alternatives).
     # @param word_alternatives_threshold [Float] A confidence value that is the lower bound for identifying a hypothesis as a
     #   possible word alternative (also known as \"Confusion Networks\"). An alternative
     #   word is considered if its confidence is greater than or equal to the threshold.
-    #   Specify a probability between 0.0 and 1.0. No alternative words are computed if
-    #   you omit the parameter. See [Word
-    #   alternatives](https://console.bluemix.net/docs/services/speech-to-text/output.html#word_alternatives).
+    #   Specify a probability between 0.0 and 1.0. By default, the service computes no
+    #   alternative words. See [Word
+    #   alternatives](https://cloud.ibm.com/docs/services/speech-to-text/output.html#word_alternatives).
     # @param word_confidence [Boolean] If `true`, the service returns a confidence measure in the range of 0.0 to 1.0 for
-    #   each word. By default, no word confidence measures are returned. See [Word
-    #   confidence](https://console.bluemix.net/docs/services/speech-to-text/output.html#word_confidence).
+    #   each word. By default, the service returns no word confidence scores. See [Word
+    #   confidence](https://cloud.ibm.com/docs/services/speech-to-text/output.html#word_confidence).
     # @param timestamps [Boolean] If `true`, the service returns time alignment for each word. By default, no
     #   timestamps are returned. See [Word
-    #   timestamps](https://console.bluemix.net/docs/services/speech-to-text/output.html#word_timestamps).
+    #   timestamps](https://cloud.ibm.com/docs/services/speech-to-text/output.html#word_timestamps).
     # @param profanity_filter [Boolean] If `true`, the service filters profanity from all output except for keyword
     #   results by replacing inappropriate words with a series of asterisks. Set the
     #   parameter to `false` to return results with no censoring. Applies to US English
     #   transcription only. See [Profanity
-    #   filtering](https://console.bluemix.net/docs/services/speech-to-text/output.html#profanity_filter).
+    #   filtering](https://cloud.ibm.com/docs/services/speech-to-text/output.html#profanity_filter).
     # @param smart_formatting [Boolean] If `true`, the service converts dates, times, series of digits and numbers, phone
     #   numbers, currency values, and internet addresses into more readable, conventional
     #   representations in the final transcript of a recognition request. For US English,
     #   the service also converts certain keyword strings to punctuation symbols. By
-    #   default, no smart formatting is performed. Applies to US English, Japanese, and
-    #   Spanish transcription only. See [Smart
-    #   formatting](https://console.bluemix.net/docs/services/speech-to-text/output.html#smart_formatting).
+    #   default, the service performs no smart formatting.
+    #
+    #   **Note:** Applies to US English, Japanese, and Spanish transcription only.
+    #
+    #   See [Smart
+    #   formatting](https://cloud.ibm.com/docs/services/speech-to-text/output.html#smart_formatting).
     # @param speaker_labels [Boolean] If `true`, the response includes labels that identify which words were spoken by
-    #   which participants in a multi-person exchange. By default, no speaker labels are
-    #   returned. Setting `speaker_labels` to `true` forces the `timestamps` parameter to
-    #   be `true`, regardless of whether you specify `false` for the parameter.
+    #   which participants in a multi-person exchange. By default, the service returns no
+    #   speaker labels. Setting `speaker_labels` to `true` forces the `timestamps`
+    #   parameter to be `true`, regardless of whether you specify `false` for the
+    #   parameter.
     #
-    #   To determine whether a language model supports speaker labels, use the **Get a
-    #   model** method and check that the attribute `speaker_labels` is set to `true`. See
-    #   [Speaker labels](https://console.bluemix.net/docs/services/speech-to-text/output.html#speaker_labels).
+    #   **Note:** Applies to US English, Japanese, and Spanish transcription only. To
+    #   determine whether a language model supports speaker labels, you can also use the
+    #   **Get a model** method and check that the attribute `speaker_labels` is set to
+    #   `true`.
+    #
+    #   See [Speaker
+    #   labels](https://cloud.ibm.com/docs/services/speech-to-text/output.html#speaker_labels).
     # @param customization_id [String] **Deprecated.** Use the `language_customization_id` parameter to specify the
     #   customization ID (GUID) of a custom language model that is to be used with the
     #   recognition request. Do not specify both parameters with a request.
+    # @param grammar_name [String] The name of a grammar that is to be used with the recognition request. If you
+    #   specify a grammar, you must also use the `language_customization_id` parameter to
+    #   specify the name of the custom language model for which the grammar is defined.
+    #   The service recognizes only strings that are recognized by the specified grammar;
+    #   it does not recognize other custom words from the model's words resource. See
+    #   [Grammars](https://cloud.ibm.com/docs/services/speech-to-text/output.html).
+    # @param redaction [Boolean] If `true`, the service redacts, or masks, numeric data from final transcripts. The
+    #   feature redacts any number that has three or more consecutive digits by replacing
+    #   each digit with an `X` character. It is intended to redact sensitive numeric data,
+    #   such as credit card numbers. By default, the service performs no redaction.
+    #
+    #   When you enable redaction, the service automatically enables smart formatting,
+    #   regardless of whether you explicitly disable that feature. To ensure maximum
+    #   security, the service also disables keyword spotting (ignores the `keywords` and
+    #   `keywords_threshold` parameters) and returns only a single final transcript
+    #   (forces the `max_alternatives` parameter to be `1`).
+    #
+    #   **Note:** Applies to US English, Japanese, and Korean transcription only.
+    #
+    #   See [Numeric
+    #   redaction](https://cloud.ibm.com/docs/services/speech-to-text/output.html#redaction).
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
-    def recognize(audio:, content_type: nil, model: nil, language_customization_id: nil, acoustic_customization_id: nil, base_model_version: nil, customization_weight: nil, inactivity_timeout: nil, keywords: nil, keywords_threshold: nil, max_alternatives: nil, word_alternatives_threshold: nil, word_confidence: nil, timestamps: nil, profanity_filter: nil, smart_formatting: nil, speaker_labels: nil, customization_id: nil)
+    def recognize(audio:, content_type: nil, model: nil, language_customization_id: nil, acoustic_customization_id: nil, base_model_version: nil, customization_weight: nil, inactivity_timeout: nil, keywords: nil, keywords_threshold: nil, max_alternatives: nil, word_alternatives_threshold: nil, word_confidence: nil, timestamps: nil, profanity_filter: nil, smart_formatting: nil, speaker_labels: nil, customization_id: nil, grammar_name: nil, redaction: nil)
       raise ArgumentError.new("audio must be provided") if audio.nil?
 
       headers = {
@@ -342,7 +391,9 @@ module IBMWatson
         "profanity_filter" => profanity_filter,
         "smart_formatting" => smart_formatting,
         "speaker_labels" => speaker_labels,
-        "customization_id" => customization_id
+        "customization_id" => customization_id,
+        "grammar_name" => grammar_name,
+        "redaction" => redaction
       }
 
       data = audio
@@ -368,9 +419,9 @@ module IBMWatson
     # @param audio [IO] Audio to transcribe in the format specified by the `Content-Type` header.
     # @param chunk_data [Boolean] If true, then the WebSocketClient will expect to receive data in chunks rather than as a single audio file
     # @param model [String] The identifier of the model to be used for the recognition request.
-    # @param language_customization_id [String] The GUID of a custom language model that is to be used with the request. The base model of the specified custom language model must match the model specified with the `model` parameter. You must make the request with service credentials created for the instance of the service that owns the custom model. By default, no custom language model is used.
     # @param customization_id [String] The GUID of a custom language model that is to be used with the request. The base model of the specified custom language model must match the model specified with the `model` parameter. You must make the request with service credentials created for the instance of the service that owns the custom model. By default, no custom language model is used.
     # @param acoustic_customization_id [String] The GUID of a custom acoustic model that is to be used with the request. The base model of the specified custom acoustic model must match the model specified with the `model` parameter. You must make the request with service credentials created for the instance of the service that owns the custom model. By default, no custom acoustic model is used.
+    # @param language_customization_id [String] The GUID of a custom language model that is to be used with the request. The base model of the specified custom language model must match the model specified with the `model` parameter. You must make the request with service credentials created for the instance of the service that owns the custom model. By default, no custom language model is used.
     # @param customization_weight [Float] If you specify a `customization_id` with the request, you can use the `customization_weight` parameter to tell the service how much weight to give to words from the custom language model compared to those from the base model for speech recognition.   Specify a value between 0.0 and 1.0. Unless a different customization weight was specified for the custom model when it was trained, the default value is 0.3. A customization weight that you specify overrides a weight that was specified when the custom model was trained.   The default value yields the best performance in general. Assign a higher value if your audio makes frequent use of OOV words from the custom model. Use caution when setting the weight: a higher value can improve the accuracy of phrases from the custom model's domain, but it can negatively affect performance on non-domain phrases.
     # @param base_model_version [String] The version of the specified base `model` that is to be used for speech recognition. Multiple versions of a base model can exist when a model is updated for internal improvements. The parameter is intended primarily for use with custom models that have been upgraded for a new base model. The default value depends on whether the parameter is used with or without a custom model. For more information, see [Base model version](https://console.bluemix.net/docs/services/speech-to-text/input.html#version).
     # @param inactivity_timeout [Integer] The time in seconds after which, if only silence (no speech) is detected in submitted audio, the connection is closed with a 400 error. Useful for stopping audio submission from a live microphone when a user simply walks away. Use `-1` for infinity.
@@ -384,6 +435,27 @@ module IBMWatson
     # @param profanity_filter [Boolean] If `true` (the default), filters profanity from all output except for keyword results by replacing inappropriate words with a series of asterisks. Set the parameter to `false` to return results with no censoring. Applies to US English transcription only.
     # @param smart_formatting [Boolean] If `true`, converts dates, times, series of digits and numbers, phone numbers, currency values, and Internet addresses into more readable, conventional representations in the final transcript of a recognition request. If `false` (the default), no formatting is performed. Applies to US English transcription only.
     # @param speaker_labels [Boolean] Indicates whether labels that identify which words were spoken by which participants in a multi-person exchange are to be included in the response. The default is `false`; no speaker labels are returned. Setting `speaker_labels` to `true` forces the `timestamps` parameter to be `true`, regardless of whether you specify `false` for the parameter.   To determine whether a language model supports speaker labels, use the `GET /v1/models` method and check that the attribute `speaker_labels` is set to `true`. You can also refer to [Speaker labels](https://console.bluemix.net/docs/services/speech-to-text/output.html#speaker_labels).
+    # @param grammar_name [String] The name of a grammar that is to be used with the recognition request. If you
+    #   specify a grammar, you must also use the `language_customization_id` parameter to
+    #   specify the name of the custom language model for which the grammar is defined.
+    #   The service recognizes only strings that are recognized by the specified grammar;
+    #   it does not recognize other custom words from the model's words resource. See
+    #   [Grammars](https://cloud.ibm.com/docs/services/speech-to-text/output.html).
+    # @param redaction [Boolean] If `true`, the service redacts, or masks, numeric data from final transcripts. The
+    #   feature redacts any number that has three or more consecutive digits by replacing
+    #   each digit with an `X` character. It is intended to redact sensitive numeric data,
+    #   such as credit card numbers. By default, the service performs no redaction.
+    #
+    #   When you enable redaction, the service automatically enables smart formatting,
+    #   regardless of whether you explicitly disable that feature. To ensure maximum
+    #   security, the service also disables keyword spotting (ignores the `keywords` and
+    #   `keywords_threshold` parameters) and returns only a single final transcript
+    #   (forces the `max_alternatives` parameter to be `1`).
+    #
+    #   **Note:** Applies to US English, Japanese, and Korean transcription only.
+    #
+    #   See [Numeric
+    #   redaction](https://cloud.ibm.com/docs/services/speech-to-text/output.html#redaction).
     # @return [WebSocketClient] Returns a new WebSocketClient object
     def recognize_using_websocket(
       content_type: nil,
@@ -406,7 +478,9 @@ module IBMWatson
       timestamps: nil,
       profanity_filter: nil,
       smart_formatting: nil,
-      speaker_labels: nil
+      speaker_labels: nil,
+      grammar_name: nil,
+      redaction: nil
     )
       raise ArgumentError("Audio must be provided") if audio.nil? && !chunk_data
       raise ArgumentError("Recognize callback must be provided") if recognize_callback.nil?
@@ -428,7 +502,9 @@ module IBMWatson
         "langauge_customization_id" => language_customization_id,
         "acoustic_customization_id" => acoustic_customization_id,
         "customization_weight" => customization_weight,
-        "base_model_version" => base_model_version
+        "base_model_version" => base_model_version,
+        "grammar_name" => grammar_name,
+        "redaction" => redaction
       }
       params.delete_if { |_, v| v.nil? }
       url += "/v1/recognize?" + HTTP::URI.form_encode(params)
@@ -539,7 +615,7 @@ module IBMWatson
     #   a one-hour span of time.
     #
     #   **See also:** [Registering a callback
-    #   URL](https://console.bluemix.net/docs/services/speech-to-text/async.html#register).
+    #   URL](https://cloud.ibm.com/docs/services/speech-to-text/async.html#register).
     # @param callback_url [String] An HTTP or HTTPS URL to which callback notifications are to be sent. To be
     #   white-listed, the URL must successfully echo the challenge string during URL
     #   verification. During verification, the client can also check the signature that
@@ -582,7 +658,7 @@ module IBMWatson
     #   URL can no longer be used with asynchronous recognition requests.
     #
     #   **See also:** [Unregistering a callback
-    #   URL](https://console.bluemix.net/docs/services/speech-to-text/async.html#unregister).
+    #   URL](https://cloud.ibm.com/docs/services/speech-to-text/async.html#unregister).
     # @param callback_url [String] The callback URL that is to be unregistered.
     # @return [nil]
     def unregister_callback(callback_url:)
@@ -608,12 +684,12 @@ module IBMWatson
     end
 
     ##
-    # @!method create_job(audio:, content_type: nil, model: nil, callback_url: nil, events: nil, user_token: nil, results_ttl: nil, language_customization_id: nil, acoustic_customization_id: nil, base_model_version: nil, customization_weight: nil, inactivity_timeout: nil, keywords: nil, keywords_threshold: nil, max_alternatives: nil, word_alternatives_threshold: nil, word_confidence: nil, timestamps: nil, profanity_filter: nil, smart_formatting: nil, speaker_labels: nil, customization_id: nil)
+    # @!method create_job(audio:, content_type: nil, model: nil, callback_url: nil, events: nil, user_token: nil, results_ttl: nil, language_customization_id: nil, acoustic_customization_id: nil, base_model_version: nil, customization_weight: nil, inactivity_timeout: nil, keywords: nil, keywords_threshold: nil, max_alternatives: nil, word_alternatives_threshold: nil, word_confidence: nil, timestamps: nil, profanity_filter: nil, smart_formatting: nil, speaker_labels: nil, customization_id: nil, grammar_name: nil, redaction: nil)
     # Create a job.
     # Creates a job for a new asynchronous recognition request. The job is owned by the
-    #   user whose service credentials are used to create it. How you learn the status and
-    #   results of a job depends on the parameters you include with the job creation
-    #   request:
+    #   instance of the service whose credentials are used to create it. How you learn the
+    #   status and results of a job depends on the parameters you include with the job
+    #   creation request:
     #   * By callback notification: Include the `callback_url` parameter to specify a URL
     #   to which the service is to send callback notifications when the status of the job
     #   changes. Optionally, you can also include the `events` and `user_token` parameters
@@ -646,7 +722,8 @@ module IBMWatson
     #   mono during transcoding. The method returns only final results; to enable interim
     #   results, use the WebSocket API.
     #
-    #   **See also:** [Creating a job](https://console.bluemix.net/docs/services/speech-to-text/async.html#create).
+    #   **See also:** [Creating a
+    #   job](https://cloud.ibm.com/docs/services/speech-to-text/async.html#create).
     #
     #   ### Streaming mode
     #
@@ -659,8 +736,11 @@ module IBMWatson
     #   `inactivity_timeout` parameter to change the default of 30 seconds.
     #
     #   **See also:**
-    #   * [Audio transmission](https://console.bluemix.net/docs/services/speech-to-text/input.html#transmission)
-    #   * [Timeouts](https://console.bluemix.net/docs/services/speech-to-text/input.html#timeouts)
+    #   * [Audio
+    #   transmission](https://cloud.ibm.com/docs/services/speech-to-text/input.html#transmission)
+    #   *
+    #   [Timeouts](https://cloud.ibm.com/docs/services/speech-to-text/input.html#timeouts)
+    #
     #
     #   ### Audio formats (content types)
     #
@@ -676,6 +756,7 @@ module IBMWatson
     #   can optionally include the number of channels and the endianness of the audio.
     #   * `audio/basic` (**Required.** Use only with narrowband models.)
     #   * `audio/flac`
+    #   * `audio/g729` (Use only with narrowband models.)
     #   * `audio/l16` (**Required.** Specify the sampling rate (`rate`) and optionally the
     #   number of channels (`channels`) and endianness (`endianness`) of the audio.)
     #   * `audio/mp3`
@@ -689,11 +770,21 @@ module IBMWatson
     #   * `audio/webm;codecs=opus`
     #   * `audio/webm;codecs=vorbis`
     #
-    #   **See also:** [Audio formats](https://console.bluemix.net/docs/services/speech-to-text/audio-formats.html).
+    #   The sampling rate of the audio must match the sampling rate of the model for the
+    #   recognition request: for broadband models, at least 16 kHz; for narrowband models,
+    #   at least 8 kHz. If the sampling rate of the audio is higher than the minimum
+    #   required rate, the service down-samples the audio to the appropriate rate. If the
+    #   sampling rate of the audio is lower than the minimum required rate, the request
+    #   fails.
+    #
+    #    **See also:** [Audio
+    #   formats](https://cloud.ibm.com/docs/services/speech-to-text/audio-formats.html).
     # @param audio [String] The audio to transcribe.
     # @param content_type [String] The format (MIME type) of the audio. For more information about specifying an
     #   audio format, see **Audio formats (content types)** in the method description.
-    # @param model [String] The identifier of the model that is to be used for the recognition request.
+    # @param model [String] The identifier of the model that is to be used for the recognition request. See
+    #   [Languages and
+    #   models](https://cloud.ibm.com/docs/services/speech-to-text/models.html).
     # @param callback_url [String] A URL to which callback notifications are to be sent. The URL must already be
     #   successfully white-listed by using the **Register a callback** method. You can
     #   include the same callback URL with any number of job creation requests. Omit the
@@ -731,24 +822,24 @@ module IBMWatson
     # @param language_customization_id [String] The customization ID (GUID) of a custom language model that is to be used with the
     #   recognition request. The base model of the specified custom language model must
     #   match the model specified with the `model` parameter. You must make the request
-    #   with service credentials created for the instance of the service that owns the
-    #   custom model. By default, no custom language model is used. See [Custom
-    #   models](https://console.bluemix.net/docs/services/speech-to-text/input.html#custom).
+    #   with credentials for the instance of the service that owns the custom model. By
+    #   default, no custom language model is used. See [Custom
+    #   models](https://cloud.ibm.com/docs/services/speech-to-text/input.html#custom).
     #
     #   **Note:** Use this parameter instead of the deprecated `customization_id`
     #   parameter.
     # @param acoustic_customization_id [String] The customization ID (GUID) of a custom acoustic model that is to be used with the
     #   recognition request. The base model of the specified custom acoustic model must
     #   match the model specified with the `model` parameter. You must make the request
-    #   with service credentials created for the instance of the service that owns the
-    #   custom model. By default, no custom acoustic model is used. See [Custom
-    #   models](https://console.bluemix.net/docs/services/speech-to-text/input.html#custom).
+    #   with credentials for the instance of the service that owns the custom model. By
+    #   default, no custom acoustic model is used. See [Custom
+    #   models](https://cloud.ibm.com/docs/services/speech-to-text/input.html#custom).
     # @param base_model_version [String] The version of the specified base model that is to be used with recognition
     #   request. Multiple versions of a base model can exist when a model is updated for
     #   internal improvements. The parameter is intended primarily for use with custom
     #   models that have been upgraded for a new base model. The default value depends on
     #   whether the parameter is used with or without a custom model. See [Base model
-    #   version](https://console.bluemix.net/docs/services/speech-to-text/input.html#version).
+    #   version](https://cloud.ibm.com/docs/services/speech-to-text/input.html#version).
     # @param customization_weight [Float] If you specify the customization ID (GUID) of a custom language model with the
     #   recognition request, the customization weight tells the service how much weight to
     #   give to words from the custom language model compared to those from the base model
@@ -765,64 +856,94 @@ module IBMWatson
     #   custom model's domain, but it can negatively affect performance on non-domain
     #   phrases.
     #
-    #   See [Custom models](https://console.bluemix.net/docs/services/speech-to-text/input.html#custom).
+    #   See [Custom
+    #   models](https://cloud.ibm.com/docs/services/speech-to-text/input.html#custom).
     # @param inactivity_timeout [Fixnum] The time in seconds after which, if only silence (no speech) is detected in
     #   submitted audio, the connection is closed with a 400 error. The parameter is
     #   useful for stopping audio submission from a live microphone when a user simply
     #   walks away. Use `-1` for infinity. See
-    #   [Timeouts](https://console.bluemix.net/docs/services/speech-to-text/input.html#timeouts).
+    #   [Timeouts](https://cloud.ibm.com/docs/services/speech-to-text/input.html#timeouts).
     # @param keywords [Array[String]] An array of keyword strings to spot in the audio. Each keyword string can include
     #   one or more string tokens. Keywords are spotted only in the final results, not in
     #   interim hypotheses. If you specify any keywords, you must also specify a keywords
     #   threshold. You can spot a maximum of 1000 keywords. Omit the parameter or specify
     #   an empty array if you do not need to spot keywords. See [Keyword
-    #   spotting](https://console.bluemix.net/docs/services/speech-to-text/output.html#keyword_spotting).
+    #   spotting](https://cloud.ibm.com/docs/services/speech-to-text/output.html#keyword_spotting).
     # @param keywords_threshold [Float] A confidence value that is the lower bound for spotting a keyword. A word is
     #   considered to match a keyword if its confidence is greater than or equal to the
-    #   threshold. Specify a probability between 0.0 and 1.0. No keyword spotting is
-    #   performed if you omit the parameter. If you specify a threshold, you must also
-    #   specify one or more keywords. See [Keyword
-    #   spotting](https://console.bluemix.net/docs/services/speech-to-text/output.html#keyword_spotting).
+    #   threshold. Specify a probability between 0.0 and 1.0. If you specify a threshold,
+    #   you must also specify one or more keywords. The service performs no keyword
+    #   spotting if you omit either parameter. See [Keyword
+    #   spotting](https://cloud.ibm.com/docs/services/speech-to-text/output.html#keyword_spotting).
     # @param max_alternatives [Fixnum] The maximum number of alternative transcripts that the service is to return. By
-    #   default, a single transcription is returned. See [Maximum
-    #   alternatives](https://console.bluemix.net/docs/services/speech-to-text/output.html#max_alternatives).
+    #   default, the service returns a single transcript. See [Maximum
+    #   alternatives](https://cloud.ibm.com/docs/services/speech-to-text/output.html#max_alternatives).
     # @param word_alternatives_threshold [Float] A confidence value that is the lower bound for identifying a hypothesis as a
     #   possible word alternative (also known as \"Confusion Networks\"). An alternative
     #   word is considered if its confidence is greater than or equal to the threshold.
-    #   Specify a probability between 0.0 and 1.0. No alternative words are computed if
-    #   you omit the parameter. See [Word
-    #   alternatives](https://console.bluemix.net/docs/services/speech-to-text/output.html#word_alternatives).
+    #   Specify a probability between 0.0 and 1.0. By default, the service computes no
+    #   alternative words. See [Word
+    #   alternatives](https://cloud.ibm.com/docs/services/speech-to-text/output.html#word_alternatives).
     # @param word_confidence [Boolean] If `true`, the service returns a confidence measure in the range of 0.0 to 1.0 for
-    #   each word. By default, no word confidence measures are returned. See [Word
-    #   confidence](https://console.bluemix.net/docs/services/speech-to-text/output.html#word_confidence).
+    #   each word. By default, the service returns no word confidence scores. See [Word
+    #   confidence](https://cloud.ibm.com/docs/services/speech-to-text/output.html#word_confidence).
     # @param timestamps [Boolean] If `true`, the service returns time alignment for each word. By default, no
     #   timestamps are returned. See [Word
-    #   timestamps](https://console.bluemix.net/docs/services/speech-to-text/output.html#word_timestamps).
+    #   timestamps](https://cloud.ibm.com/docs/services/speech-to-text/output.html#word_timestamps).
     # @param profanity_filter [Boolean] If `true`, the service filters profanity from all output except for keyword
     #   results by replacing inappropriate words with a series of asterisks. Set the
     #   parameter to `false` to return results with no censoring. Applies to US English
     #   transcription only. See [Profanity
-    #   filtering](https://console.bluemix.net/docs/services/speech-to-text/output.html#profanity_filter).
+    #   filtering](https://cloud.ibm.com/docs/services/speech-to-text/output.html#profanity_filter).
     # @param smart_formatting [Boolean] If `true`, the service converts dates, times, series of digits and numbers, phone
     #   numbers, currency values, and internet addresses into more readable, conventional
     #   representations in the final transcript of a recognition request. For US English,
     #   the service also converts certain keyword strings to punctuation symbols. By
-    #   default, no smart formatting is performed. Applies to US English, Japanese, and
-    #   Spanish transcription only. See [Smart
-    #   formatting](https://console.bluemix.net/docs/services/speech-to-text/output.html#smart_formatting).
+    #   default, the service performs no smart formatting.
+    #
+    #   **Note:** Applies to US English, Japanese, and Spanish transcription only.
+    #
+    #   See [Smart
+    #   formatting](https://cloud.ibm.com/docs/services/speech-to-text/output.html#smart_formatting).
     # @param speaker_labels [Boolean] If `true`, the response includes labels that identify which words were spoken by
-    #   which participants in a multi-person exchange. By default, no speaker labels are
-    #   returned. Setting `speaker_labels` to `true` forces the `timestamps` parameter to
-    #   be `true`, regardless of whether you specify `false` for the parameter.
+    #   which participants in a multi-person exchange. By default, the service returns no
+    #   speaker labels. Setting `speaker_labels` to `true` forces the `timestamps`
+    #   parameter to be `true`, regardless of whether you specify `false` for the
+    #   parameter.
+    #
+    #   **Note:** Applies to US English, Japanese, and Spanish transcription only. To
+    #   determine whether a language model supports speaker labels, you can also use the
+    #   **Get a model** method and check that the attribute `speaker_labels` is set to
+    #   `true`.
     #
-    #   To determine whether a language model supports speaker labels, use the **Get a
-    #   model** method and check that the attribute `speaker_labels` is set to `true`. See
-    #   [Speaker labels](https://console.bluemix.net/docs/services/speech-to-text/output.html#speaker_labels).
+    #   See [Speaker
+    #   labels](https://cloud.ibm.com/docs/services/speech-to-text/output.html#speaker_labels).
     # @param customization_id [String] **Deprecated.** Use the `language_customization_id` parameter to specify the
     #   customization ID (GUID) of a custom language model that is to be used with the
     #   recognition request. Do not specify both parameters with a request.
+    # @param grammar_name [String] The name of a grammar that is to be used with the recognition request. If you
+    #   specify a grammar, you must also use the `language_customization_id` parameter to
+    #   specify the name of the custom language model for which the grammar is defined.
+    #   The service recognizes only strings that are recognized by the specified grammar;
+    #   it does not recognize other custom words from the model's words resource. See
+    #   [Grammars](https://cloud.ibm.com/docs/services/speech-to-text/output.html).
+    # @param redaction [Boolean] If `true`, the service redacts, or masks, numeric data from final transcripts. The
+    #   feature redacts any number that has three or more consecutive digits by replacing
+    #   each digit with an `X` character. It is intended to redact sensitive numeric data,
+    #   such as credit card numbers. By default, the service performs no redaction.
+    #
+    #   When you enable redaction, the service automatically enables smart formatting,
+    #   regardless of whether you explicitly disable that feature. To ensure maximum
+    #   security, the service also disables keyword spotting (ignores the `keywords` and
+    #   `keywords_threshold` parameters) and returns only a single final transcript
+    #   (forces the `max_alternatives` parameter to be `1`).
+    #
+    #   **Note:** Applies to US English, Japanese, and Korean transcription only.
+    #
+    #   See [Numeric
+    #   redaction](https://cloud.ibm.com/docs/services/speech-to-text/output.html#redaction).
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
-    def create_job(audio:, content_type: nil, model: nil, callback_url: nil, events: nil, user_token: nil, results_ttl: nil, language_customization_id: nil, acoustic_customization_id: nil, base_model_version: nil, customization_weight: nil, inactivity_timeout: nil, keywords: nil, keywords_threshold: nil, max_alternatives: nil, word_alternatives_threshold: nil, word_confidence: nil, timestamps: nil, profanity_filter: nil, smart_formatting: nil, speaker_labels: nil, customization_id: nil)
+    def create_job(audio:, content_type: nil, model: nil, callback_url: nil, events: nil, user_token: nil, results_ttl: nil, language_customization_id: nil, acoustic_customization_id: nil, base_model_version: nil, customization_weight: nil, inactivity_timeout: nil, keywords: nil, keywords_threshold: nil, max_alternatives: nil, word_alternatives_threshold: nil, word_confidence: nil, timestamps: nil, profanity_filter: nil, smart_formatting: nil, speaker_labels: nil, customization_id: nil, grammar_name: nil, redaction: nil)
       raise ArgumentError.new("audio must be provided") if audio.nil?
 
       headers = {
@@ -849,7 +970,9 @@ module IBMWatson
         "profanity_filter" => profanity_filter,
         "smart_formatting" => smart_formatting,
         "speaker_labels" => speaker_labels,
-        "customization_id" => customization_id
+        "customization_id" => customization_id,
+        "grammar_name" => grammar_name,
+        "redaction" => redaction
       }
 
       data = audio
@@ -871,16 +994,16 @@ module IBMWatson
     # @!method check_jobs
     # Check jobs.
     # Returns the ID and status of the latest 100 outstanding jobs associated with the
-    #   service credentials with which it is called. The method also returns the creation
-    #   and update times of each job, and, if a job was created with a callback URL and a
-    #   user token, the user token for the job. To obtain the results for a job whose
-    #   status is `completed` or not one of the latest 100 outstanding jobs, use the
-    #   **Check a job** method. A job and its results remain available until you delete
-    #   them with the **Delete a job** method or until the job's time to live expires,
-    #   whichever comes first.
+    #   credentials with which it is called. The method also returns the creation and
+    #   update times of each job, and, if a job was created with a callback URL and a user
+    #   token, the user token for the job. To obtain the results for a job whose status is
+    #   `completed` or not one of the latest 100 outstanding jobs, use the **Check a job**
+    #   method. A job and its results remain available until you delete them with the
+    #   **Delete a job** method or until the job's time to live expires, whichever comes
+    #   first.
     #
     #   **See also:** [Checking the status of the latest
-    #   jobs](https://console.bluemix.net/docs/services/speech-to-text/async.html#jobs).
+    #   jobs](https://cloud.ibm.com/docs/services/speech-to-text/async.html#jobs).
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def check_jobs
       headers = {
@@ -902,18 +1025,21 @@ module IBMWatson
     # Check a job.
     # Returns information about the specified job. The response always includes the
     #   status of the job and its creation and update times. If the status is `completed`,
-    #   the response includes the results of the recognition request. You must submit the
-    #   request with the service credentials of the user who created the job.
+    #   the response includes the results of the recognition request. You must use
+    #   credentials for the instance of the service that owns a job to list information
+    #   about it.
     #
     #   You can use the method to retrieve the results of any job, regardless of whether
     #   it was submitted with a callback URL and the `recognitions.completed_with_results`
     #   event, and you can retrieve the results multiple times for as long as they remain
     #   available. Use the **Check jobs** method to request information about the most
-    #   recent jobs associated with the caller.
+    #   recent jobs associated with the calling credentials.
     #
     #   **See also:** [Checking the status and retrieving the results of a
-    #   job](https://console.bluemix.net/docs/services/speech-to-text/async.html#job).
-    # @param id [String] The identifier of the asynchronous job that is to be used for the request.
+    #   job](https://cloud.ibm.com/docs/services/speech-to-text/async.html#job).
+    # @param id [String] The identifier of the asynchronous job that is to be used for the request. You
+    #   must make the request with credentials for the instance of the service that owns
+    #   the job.
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def check_job(id:)
       raise ArgumentError.new("id must be provided") if id.nil?
@@ -938,11 +1064,14 @@ module IBMWatson
     # Deletes the specified job. You cannot delete a job that the service is actively
     #   processing. Once you delete a job, its results are no longer available. The
     #   service automatically deletes a job and its results when the time to live for the
-    #   results expires. You must submit the request with the service credentials of the
-    #   user who created the job.
-    #
-    #   **See also:** [Deleting a job](https://console.bluemix.net/docs/services/speech-to-text/async.html#delete).
-    # @param id [String] The identifier of the asynchronous job that is to be used for the request.
+    #   results expires. You must use credentials for the instance of the service that
+    #   owns a job to delete it.
+    #
+    #   **See also:** [Deleting a
+    #   job](https://cloud.ibm.com/docs/services/speech-to-text/async.html#delete).
+    # @param id [String] The identifier of the asynchronous job that is to be used for the request. You
+    #   must make the request with credentials for the instance of the service that owns
+    #   the job.
     # @return [nil]
     def delete_job(id:)
       raise ArgumentError.new("id must be provided") if id.nil?
@@ -973,7 +1102,7 @@ module IBMWatson
     #   it.
     #
     #   **See also:** [Create a custom language
-    #   model](https://console.bluemix.net/docs/services/speech-to-text/language-create.html#createModel).
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text/language-create.html#createModel).
     # @param name [String] A user-defined name for the new custom language model. Use a name that is unique
     #   among all custom language models that you own. Use a localized name that matches
     #   the language of the custom model. Use a name that describes the domain of the
@@ -985,7 +1114,7 @@ module IBMWatson
     #   To determine whether a base model supports language model customization, use the
     #   **Get a model** method and check that the attribute `custom_language_model` is set
     #   to `true`. You can also refer to [Language support for
-    #   customization](https://console.bluemix.net/docs/services/speech-to-text/custom.html#languageSupport).
+    #   customization](https://cloud.ibm.com/docs/services/speech-to-text/custom.html#languageSupport).
     # @param dialect [String] The dialect of the specified language that is to be used with the custom language
     #   model. The parameter is meaningful only for Spanish models, for which the service
     #   creates a custom language model that is suited for speech in one of the following
@@ -1037,10 +1166,10 @@ module IBMWatson
     #   a model to list information about it.
     #
     #   **See also:** [Listing custom language
-    #   models](https://console.bluemix.net/docs/services/speech-to-text/language-models.html#listModels).
+    #   models](https://cloud.ibm.com/docs/services/speech-to-text/language-models.html#listModels).
     # @param language [String] The identifier of the language for which custom language or custom acoustic models
     #   are to be returned (for example, `en-US`). Omit the parameter to see all custom
-    #   language or custom acoustic models owned by the requesting service credentials.
+    #   language or custom acoustic models that are owned by the requesting credentials.
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def list_language_models(language: nil)
       headers = {
@@ -1069,10 +1198,10 @@ module IBMWatson
     #   for the instance of the service that owns a model to list information about it.
     #
     #   **See also:** [Listing custom language
-    #   models](https://console.bluemix.net/docs/services/speech-to-text/language-models.html#listModels).
+    #   models](https://cloud.ibm.com/docs/services/speech-to-text/language-models.html#listModels).
     # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
-    #   the request. You must make the request with service credentials created for the
-    #   instance of the service that owns the custom model.
+    #   the request. You must make the request with credentials for the instance of the
+    #   service that owns the custom model.
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def get_language_model(customization_id:)
       raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
@@ -1095,15 +1224,15 @@ module IBMWatson
     # @!method delete_language_model(customization_id:)
     # Delete a custom language model.
     # Deletes an existing custom language model. The custom model cannot be deleted if
-    #   another request, such as adding a corpus to the model, is currently being
-    #   processed. You must use credentials for the instance of the service that owns a
-    #   model to delete it.
+    #   another request, such as adding a corpus or grammar to the model, is currently
+    #   being processed. You must use credentials for the instance of the service that
+    #   owns a model to delete it.
     #
     #   **See also:** [Deleting a custom language
-    #   model](https://console.bluemix.net/docs/services/speech-to-text/language-models.html#deleteModel).
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text/language-models.html#deleteModel).
     # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
-    #   the request. You must make the request with service credentials created for the
-    #   instance of the service that owns the custom model.
+    #   the request. You must make the request with credentials for the instance of the
+    #   service that owns the custom model.
     # @return [nil]
     def delete_language_model(customization_id:)
       raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
@@ -1125,13 +1254,13 @@ module IBMWatson
     ##
     # @!method train_language_model(customization_id:, word_type_to_add: nil, customization_weight: nil)
     # Train a custom language model.
-    # Initiates the training of a custom language model with new corpora, custom words,
-    #   or both. After adding, modifying, or deleting corpora or words for a custom
-    #   language model, use this method to begin the actual training of the model on the
-    #   latest data. You can specify whether the custom language model is to be trained
-    #   with all words from its words resource or only with words that were added or
-    #   modified by the user. You must use credentials for the instance of the service
-    #   that owns a model to train it.
+    # Initiates the training of a custom language model with new resources such as
+    #   corpora, grammars, and custom words. After adding, modifying, or deleting
+    #   resources for a custom language model, use this method to begin the actual
+    #   training of the model on the latest data. You can specify whether the custom
+    #   language model is to be trained with all words from its words resource or only
+    #   with words that were added or modified by the user directly. You must use
+    #   credentials for the instance of the service that owns a model to train it.
     #
     #   The training method is asynchronous. It can take on the order of minutes to
     #   complete depending on the amount of data on which the service is being trained and
@@ -1142,27 +1271,29 @@ module IBMWatson
     #   model** method to poll the model's status. Use a loop to check the status every 10
     #   seconds. The method returns a `LanguageModel` object that includes `status` and
     #   `progress` fields. A status of `available` means that the custom model is trained
-    #   and ready to use. The service cannot accept subsequent training requests, or
-    #   requests to add new corpora or words, until the existing request completes.
+    #   and ready to use. The service cannot accept subsequent training requests or
+    #   requests to add new resources until the existing request completes.
     #
     #   Training can fail to start for the following reasons:
     #   * The service is currently handling another request for the custom model, such as
-    #   another training request or a request to add a corpus or words to the model.
-    #   * No training data (corpora or words) have been added to the custom model.
+    #   another training request or a request to add a corpus or grammar to the model.
+    #   * No training data have been added to the custom model.
     #   * One or more words that were added to the custom model have invalid sounds-like
     #   pronunciations that you must fix.
     #
     #   **See also:** [Train the custom language
-    #   model](https://console.bluemix.net/docs/services/speech-to-text/language-create.html#trainModel).
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text/language-create.html#trainModel).
     # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
-    #   the request. You must make the request with service credentials created for the
-    #   instance of the service that owns the custom model.
+    #   the request. You must make the request with credentials for the instance of the
+    #   service that owns the custom model.
     # @param word_type_to_add [String] The type of words from the custom language model's words resource on which to
     #   train the model:
     #   * `all` (the default) trains the model on all new words, regardless of whether
-    #   they were extracted from corpora or were added or modified by the user.
+    #   they were extracted from corpora or grammars or were added or modified by the
+    #   user.
     #   * `user` trains the model only on new words that were added or modified by the
-    #   user; the model is not trained on new words extracted from corpora.
+    #   user directly. The model is not trained on new words extracted from corpora or
+    #   grammars.
     # @param customization_weight [Float] Specifies a customization weight for the custom language model. The customization
     #   weight tells the service how much weight to give to words from the custom language
     #   model compared to those from the base model for speech recognition. Specify a
@@ -1204,17 +1335,18 @@ module IBMWatson
     ##
     # @!method reset_language_model(customization_id:)
     # Reset a custom language model.
-    # Resets a custom language model by removing all corpora and words from the model.
-    #   Resetting a custom language model initializes the model to its state when it was
-    #   first created. Metadata such as the name and language of the model are preserved,
-    #   but the model's words resource is removed and must be re-created. You must use
-    #   credentials for the instance of the service that owns a model to reset it.
+    # Resets a custom language model by removing all corpora, grammars, and words from
+    #   the model. Resetting a custom language model initializes the model to its state
+    #   when it was first created. Metadata such as the name and language of the model are
+    #   preserved, but the model's words resource is removed and must be re-created. You
+    #   must use credentials for the instance of the service that owns a model to reset
+    #   it.
     #
     #   **See also:** [Resetting a custom language
-    #   model](https://console.bluemix.net/docs/services/speech-to-text/language-models.html#resetModel).
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text/language-models.html#resetModel).
     # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
-    #   the request. You must make the request with service credentials created for the
-    #   instance of the service that owns the custom model.
+    #   the request. You must make the request with credentials for the instance of the
+    #   service that owns the custom model.
     # @return [nil]
     def reset_language_model(customization_id:)
       raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
@@ -1253,10 +1385,10 @@ module IBMWatson
     #   subsequent requests for the model until the upgrade completes.
     #
     #   **See also:** [Upgrading a custom language
-    #   model](https://console.bluemix.net/docs/services/speech-to-text/custom-upgrade.html#upgradeLanguage).
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text/custom-upgrade.html#upgradeLanguage).
     # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
-    #   the request. You must make the request with service credentials created for the
-    #   instance of the service that owns the custom model.
+    #   the request. You must make the request with credentials for the instance of the
+    #   service that owns the custom model.
     # @return [nil]
     def upgrade_language_model(customization_id:)
       raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
@@ -1287,10 +1419,10 @@ module IBMWatson
     #   that owns a model to list its corpora.
     #
     #   **See also:** [Listing corpora for a custom language
-    #   model](https://console.bluemix.net/docs/services/speech-to-text/language-corpora.html#listCorpora).
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text/language-corpora.html#listCorpora).
     # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
-    #   the request. You must make the request with service credentials created for the
-    #   instance of the service that owns the custom model.
+    #   the request. You must make the request with credentials for the instance of the
+    #   service that owns the custom model.
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def list_corpora(customization_id:)
       raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
@@ -1328,43 +1460,45 @@ module IBMWatson
     #   extracts new words that it finds. This can take on the order of a minute or two to
     #   complete depending on the total number of words and the number of new words in the
     #   corpus, as well as the current load on the service. You cannot submit requests to
-    #   add additional corpora or words to the custom model, or to train the model, until
-    #   the service's analysis of the corpus for the current request completes. Use the
-    #   **List a corpus** method to check the status of the analysis.
+    #   add additional resources to the custom model or to train the model until the
+    #   service's analysis of the corpus for the current request completes. Use the **List
+    #   a corpus** method to check the status of the analysis.
     #
-    #   The service auto-populates the model's words resource with any word that is not
-    #   found in its base vocabulary; these are referred to as out-of-vocabulary (OOV)
-    #   words. You can use the **List custom words** method to examine the words resource,
-    #   using other words method to eliminate typos and modify how words are pronounced as
-    #   needed.
+    #   The service auto-populates the model's words resource with words from the corpus
+    #   that are not found in its base vocabulary. These are referred to as
+    #   out-of-vocabulary (OOV) words. You can use the **List custom words** method to
+    #   examine the words resource. You can use other words method to eliminate typos and
+    #   modify how words are pronounced as needed.
     #
     #   To add a corpus file that has the same name as an existing corpus, set the
     #   `allow_overwrite` parameter to `true`; otherwise, the request fails. Overwriting
     #   an existing corpus causes the service to process the corpus text file and extract
     #   OOV words anew. Before doing so, it removes any OOV words associated with the
     #   existing corpus from the model's words resource unless they were also added by
-    #   another corpus or they have been modified in some way with the **Add custom
-    #   words** or **Add a custom word** method.
+    #   another corpus or grammar, or they have been modified in some way with the **Add
+    #   custom words** or **Add a custom word** method.
     #
     #   The service limits the overall amount of data that you can add to a custom model
-    #   to a maximum of 10 million total words from all corpora combined. Also, you can
-    #   add no more than 30 thousand custom (OOV) words to a model; this includes words
-    #   that the service extracts from corpora and words that you add directly.
+    #   to a maximum of 10 million total words from all sources combined. Also, you can
+    #   add no more than 30 thousand custom (OOV) words to a model. This includes words
+    #   that the service extracts from corpora and grammars, and words that you add
+    #   directly.
     #
     #   **See also:**
     #   * [Working with
-    #   corpora](https://console.bluemix.net/docs/services/speech-to-text/language-resource.html#workingCorpora)
+    #   corpora](https://cloud.ibm.com/docs/services/speech-to-text/language-resource.html#workingCorpora)
     #   * [Add corpora to the custom language
-    #   model](https://console.bluemix.net/docs/services/speech-to-text/language-create.html#addCorpora).
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text/language-create.html#addCorpora).
     # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
-    #   the request. You must make the request with service credentials created for the
-    #   instance of the service that owns the custom model.
+    #   the request. You must make the request with credentials for the instance of the
+    #   service that owns the custom model.
     # @param corpus_name [String] The name of the new corpus for the custom language model. Use a localized name
     #   that matches the language of the custom model and reflects the contents of the
     #   corpus.
     #   * Include a maximum of 128 characters in the name.
     #   * Do not include spaces, slashes, or backslashes in the name.
-    #   * Do not use the name of a corpus that has already been added to the custom model.
+    #   * Do not use the name of an existing corpus or grammar that is already defined for
+    #   the custom model.
     #   * Do not use the name `user`, which is reserved by the service to denote custom
     #   words that are added or modified by the user.
     # @param corpus_file [File] A plain text file that contains the training data for the corpus. Encode the file
@@ -1374,7 +1508,8 @@ module IBMWatson
     #   Make sure that you know the character encoding of the file. You must use that
     #   encoding when working with the words in the custom language model. For more
     #   information, see [Character
-    #   encoding](https://console.bluemix.net/docs/services/speech-to-text/language-resource.html#charEncoding).
+    #   encoding](https://cloud.ibm.com/docs/services/speech-to-text/language-resource.html#charEncoding).
+    #
     #
     #   With the `curl` command, use the `--data-binary` option to upload the file for the
     #   request.
@@ -1427,10 +1562,10 @@ module IBMWatson
     #   that owns a model to list its corpora.
     #
     #   **See also:** [Listing corpora for a custom language
-    #   model](https://console.bluemix.net/docs/services/speech-to-text/language-corpora.html#listCorpora).
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text/language-corpora.html#listCorpora).
     # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
-    #   the request. You must make the request with service credentials created for the
-    #   instance of the service that owns the custom model.
+    #   the request. You must make the request with credentials for the instance of the
+    #   service that owns the custom model.
     # @param corpus_name [String] The name of the corpus for the custom language model.
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def get_corpus(customization_id:, corpus_name:)
@@ -1456,18 +1591,19 @@ module IBMWatson
     # @!method delete_corpus(customization_id:, corpus_name:)
     # Delete a corpus.
     # Deletes an existing corpus from a custom language model. The service removes any
-    #   out-of-vocabulary (OOV) words associated with the corpus from the custom model's
-    #   words resource unless they were also added by another corpus or they have been
-    #   modified in some way with the **Add custom words** or **Add a custom word**
-    #   method. Removing a corpus does not affect the custom model until you train the
-    #   model with the **Train a custom language model** method. You must use credentials
-    #   for the instance of the service that owns a model to delete its corpora.
+    #   out-of-vocabulary (OOV) words that are associated with the corpus from the custom
+    #   model's words resource unless they were also added by another corpus or grammar,
+    #   or they were modified in some way with the **Add custom words** or **Add a custom
+    #   word** method. Removing a corpus does not affect the custom model until you train
+    #   the model with the **Train a custom language model** method. You must use
+    #   credentials for the instance of the service that owns a model to delete its
+    #   corpora.
     #
     #   **See also:** [Deleting a corpus from a custom language
-    #   model](https://console.bluemix.net/docs/services/speech-to-text/language-corpora.html#deleteCorpus).
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text/language-corpora.html#deleteCorpus).
     # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
-    #   the request. You must make the request with service credentials created for the
-    #   instance of the service that owns the custom model.
+    #   the request. You must make the request with credentials for the instance of the
+    #   service that owns the custom model.
     # @param corpus_name [String] The name of the corpus for the custom language model.
     # @return [nil]
     def delete_corpus(customization_id:, corpus_name:)
@@ -1498,20 +1634,21 @@ module IBMWatson
     # Lists information about custom words from a custom language model. You can list
     #   all words from the custom model's words resource, only custom words that were
     #   added or modified by the user, or only out-of-vocabulary (OOV) words that were
-    #   extracted from corpora. You can also indicate the order in which the service is to
-    #   return words; by default, words are listed in ascending alphabetical order. You
-    #   must use credentials for the instance of the service that owns a model to query
-    #   information about its words.
+    #   extracted from corpora or are recognized by grammars. You can also indicate the
+    #   order in which the service is to return words; by default, the service lists words
+    #   in ascending alphabetical order. You must use credentials for the instance of the
+    #   service that owns a model to list information about its words.
     #
     #   **See also:** [Listing words from a custom language
-    #   model](https://console.bluemix.net/docs/services/speech-to-text/language-words.html#listWords).
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text/language-words.html#listWords).
     # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
-    #   the request. You must make the request with service credentials created for the
-    #   instance of the service that owns the custom model.
+    #   the request. You must make the request with credentials for the instance of the
+    #   service that owns the custom model.
     # @param word_type [String] The type of words to be listed from the custom language model's words resource:
     #   * `all` (the default) shows all words.
-    #   * `user` shows only custom words that were added or modified by the user.
+    #   * `user` shows only custom words that were added or modified by the user directly.
     #   * `corpora` shows only OOV that were extracted from corpora.
+    #   * `grammars` shows only OOV words that are recognized by grammars.
     # @param sort [String] Indicates the order in which the words are to be listed, `alphabetical` or by
     #   `count`. You can prepend an optional `+` or `-` to an argument to indicate whether
     #   the results are to be sorted in ascending or descending order. By default, words
@@ -1547,11 +1684,12 @@ module IBMWatson
     # @!method add_words(customization_id:, words:)
     # Add custom words.
     # Adds one or more custom words to a custom language model. The service populates
-    #   the words resource for a custom model with out-of-vocabulary (OOV) words found in
-    #   each corpus added to the model. You can use this method to add additional words or
-    #   to modify existing words in the words resource. The words resource for a model can
-    #   contain a maximum of 30 thousand custom (OOV) words, including words that the
-    #   service extracts from corpora and words that you add directly.
+    #   the words resource for a custom model with out-of-vocabulary (OOV) words from each
+    #   corpus or grammar that is added to the model. You can use this method to add
+    #   additional words or to modify existing words in the words resource. The words
+    #   resource for a model can contain a maximum of 30 thousand custom (OOV) words. This
+    #   includes words that the service extracts from corpora and grammars and words that
+    #   you add directly.
     #
     #   You must use credentials for the instance of the service that owns a model to add
     #   or modify custom words for the model. Adding or modifying custom words does not
@@ -1570,10 +1708,8 @@ module IBMWatson
     #   word.
     #   * The `display_as` field provides a different way of spelling the word in a
     #   transcript. Use the parameter when you want the word to appear different from its
-    #   usual representation or from its spelling in corpora training data. For example,
-    #   you might indicate that the word `IBM(trademark)` is to be displayed as
-    #   `IBM™`.
-    #
+    #   usual representation or from its spelling in training data. For example, you might
+    #   indicate that the word `IBM(trademark)` is to be displayed as `IBM™`.
     #
     #   If you add a custom word that already exists in the words resource for the custom
     #   model, the new definition overwrites the existing data for the word. If the
@@ -1583,14 +1719,14 @@ module IBMWatson
     #   The call returns an HTTP 201 response code if the input data is valid. It then
     #   asynchronously processes the words to add them to the model's words resource. The
     #   time that it takes for the analysis to complete depends on the number of new words
-    #   that you add but is generally faster than adding a corpus or training a model.
+    #   that you add but is generally faster than adding a corpus or grammar.
     #
     #   You can monitor the status of the request by using the **List a custom language
     #   model** method to poll the model's status. Use a loop to check the status every 10
     #   seconds. The method returns a `Customization` object that includes a `status`
     #   field. A status of `ready` means that the words have been added to the custom
-    #   model. The service cannot accept requests to add new corpora or words or to train
-    #   the model until the existing request completes.
+    #   model. The service cannot accept requests to add new data or to train the model
+    #   until the existing request completes.
     #
     #   You can use the **List custom words** or **List a custom word** method to review
     #   the words that you add. Words with an invalid `sounds_like` field include an
@@ -1600,14 +1736,14 @@ module IBMWatson
     #
     #   **See also:**
     #   * [Working with custom
-    #   words](https://console.bluemix.net/docs/services/speech-to-text/language-resource.html#workingWords)
+    #   words](https://cloud.ibm.com/docs/services/speech-to-text/language-resource.html#workingWords)
     #   * [Add words to the custom language
-    #   model](https://console.bluemix.net/docs/services/speech-to-text/language-create.html#addWords).
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text/language-create.html#addWords).
     # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
-    #   the request. You must make the request with service credentials created for the
-    #   instance of the service that owns the custom model.
-    # @param words [Array[CustomWord]] An array of objects that provides information about each custom word that is to be
-    #   added to or updated in the custom language model.
+    #   the request. You must make the request with credentials for the instance of the
+    #   service that owns the custom model.
+    # @param words [Array[CustomWord]] An array of `CustomWord` objects that provides information about each custom word
+    #   that is to be added to or updated in the custom language model.
     # @return [nil]
     def add_words(customization_id:, words:)
       raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
@@ -1637,11 +1773,11 @@ module IBMWatson
     # @!method add_word(customization_id:, word_name:, word: nil, sounds_like: nil, display_as: nil)
     # Add a custom word.
     # Adds a custom word to a custom language model. The service populates the words
-    #   resource for a custom model with out-of-vocabulary (OOV) words found in each
-    #   corpus added to the model. You can use this method to add a word or to modify an
-    #   existing word in the words resource. The words resource for a model can contain a
-    #   maximum of 30 thousand custom (OOV) words, including words that the service
-    #   extracts from corpora and words that you add directly.
+    #   resource for a custom model with out-of-vocabulary (OOV) words from each corpus or
+    #   grammar that is added to the model. You can use this method to add a word or to
+    #   modify an existing word in the words resource. The words resource for a model can
+    #   contain a maximum of 30 thousand custom (OOV) words. This includes words that the
+    #   service extracts from corpora and grammars and words that you add directly.
     #
     #   You must use credentials for the instance of the service that owns a model to add
     #   or modify a custom word for the model. Adding or modifying a custom word does not
@@ -1659,10 +1795,8 @@ module IBMWatson
     #   word.
     #   * The `display_as` field provides a different way of spelling the word in a
     #   transcript. Use the parameter when you want the word to appear different from its
-    #   usual representation or from its spelling in corpora training data. For example,
-    #   you might indicate that the word `IBM(trademark)` is to be displayed as
-    #   `IBM™`.
-    #
+    #   usual representation or from its spelling in training data. For example, you might
+    #   indicate that the word `IBM(trademark)` is to be displayed as `IBM™`.
     #
     #   If you add a custom word that already exists in the words resource for the custom
     #   model, the new definition overwrites the existing data for the word. If the
@@ -1671,17 +1805,17 @@ module IBMWatson
     #
     #   **See also:**
     #   * [Working with custom
-    #   words](https://console.bluemix.net/docs/services/speech-to-text/language-resource.html#workingWords)
+    #   words](https://cloud.ibm.com/docs/services/speech-to-text/language-resource.html#workingWords)
     #   * [Add words to the custom language
-    #   model](https://console.bluemix.net/docs/services/speech-to-text/language-create.html#addWords).
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text/language-create.html#addWords).
     # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
-    #   the request. You must make the request with service credentials created for the
-    #   instance of the service that owns the custom model.
+    #   the request. You must make the request with credentials for the instance of the
+    #   service that owns the custom model.
     # @param word_name [String] The custom word that is to be added to or updated in the custom language model. Do
     #   not include spaces in the word. Use a `-` (dash) or `_` (underscore) to connect
     #   the tokens of compound words. URL-encode the word if it includes non-ASCII
     #   characters. For more information, see [Character
-    #   encoding](https://console.bluemix.net/docs/services/speech-to-text/language-resource.html#charEncoding).
+    #   encoding](https://cloud.ibm.com/docs/services/speech-to-text/language-resource.html#charEncoding).
     # @param word [String] For the **Add custom words** method, you must specify the custom word that is to
     #   be added to or updated in the custom model. Do not include spaces in the word. Use
     #   a `-` (dash) or `_` (underscore) to connect the tokens of compound words.
@@ -1733,17 +1867,17 @@ module IBMWatson
     # @!method get_word(customization_id:, word_name:)
     # Get a custom word.
     # Gets information about a custom word from a custom language model. You must use
-    #   credentials for the instance of the service that owns a model to query information
+    #   credentials for the instance of the service that owns a model to list information
     #   about its words.
     #
     #   **See also:** [Listing words from a custom language
-    #   model](https://console.bluemix.net/docs/services/speech-to-text/language-words.html#listWords).
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text/language-words.html#listWords).
     # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
-    #   the request. You must make the request with service credentials created for the
-    #   instance of the service that owns the custom model.
+    #   the request. You must make the request with credentials for the instance of the
+    #   service that owns the custom model.
     # @param word_name [String] The custom word that is to be read from the custom language model. URL-encode the
     #   word if it includes non-ASCII characters. For more information, see [Character
-    #   encoding](https://console.bluemix.net/docs/services/speech-to-text/language-resource.html#charEncoding).
+    #   encoding](https://cloud.ibm.com/docs/services/speech-to-text/language-resource.html#charEncoding).
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def get_word(customization_id:, word_name:)
       raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
@@ -1776,13 +1910,13 @@ module IBMWatson
     #   instance of the service that owns a model to delete its words.
     #
     #   **See also:** [Deleting a word from a custom language
-    #   model](https://console.bluemix.net/docs/services/speech-to-text/language-words.html#deleteWord).
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text/language-words.html#deleteWord).
     # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
-    #   the request. You must make the request with service credentials created for the
-    #   instance of the service that owns the custom model.
+    #   the request. You must make the request with credentials for the instance of the
+    #   service that owns the custom model.
     # @param word_name [String] The custom word that is to be deleted from the custom language model. URL-encode
     #   the word if it includes non-ASCII characters. For more information, see [Character
-    #   encoding](https://console.bluemix.net/docs/services/speech-to-text/language-resource.html#charEncoding).
+    #   encoding](https://cloud.ibm.com/docs/services/speech-to-text/language-resource.html#charEncoding).
     # @return [nil]
     def delete_word(customization_id:, word_name:)
       raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
@@ -1803,6 +1937,212 @@ module IBMWatson
       nil
     end
     #########################
+    # Custom grammars
+    #########################
+
+    ##
+    # @!method list_grammars(customization_id:)
+    # List grammars.
+    # Lists information about all grammars from a custom language model. The information
+    #   includes the total number of out-of-vocabulary (OOV) words, name, and status of
+    #   each grammar. You must use credentials for the instance of the service that owns a
+    #   model to list its grammars.
+    #
+    #   **See also:** [Listing grammars from a custom language
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text/).
+    # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
+    #   the request. You must make the request with credentials for the instance of the
+    #   service that owns the custom model.
+    # @return [DetailedResponse] A `DetailedResponse` object representing the response.
+    def list_grammars(customization_id:)
+      raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
+
+      headers = {
+      }
+
+      method_url = "/v1/customizations/%s/grammars" % [ERB::Util.url_encode(customization_id)]
+
+      response = request(
+        method: "GET",
+        url: method_url,
+        headers: headers,
+        accept_json: true
+      )
+      response
+    end
+
+    ##
+    # @!method add_grammar(customization_id:, grammar_name:, grammar_file:, content_type:, allow_overwrite: nil)
+    # Add a grammar.
+    # Adds a single grammar file to a custom language model. Submit a plain text file in
+    #   UTF-8 format that defines the grammar. Use multiple requests to submit multiple
+    #   grammar files. You must use credentials for the instance of the service that owns
+    #   a model to add a grammar to it. Adding a grammar does not affect the custom
+    #   language model until you train the model for the new data by using the **Train a
+    #   custom language model** method.
+    #
+    #   The call returns an HTTP 201 response code if the grammar is valid. The service
+    #   then asynchronously processes the contents of the grammar and automatically
+    #   extracts new words that it finds. This can take a few seconds to complete
+    #   depending on the size and complexity of the grammar, as well as the current load
+    #   on the service. You cannot submit requests to add additional resources to the
+    #   custom model or to train the model until the service's analysis of the grammar for
+    #   the current request completes. Use the **Get a grammar** method to check the
+    #   status of the analysis.
+    #
+    #   The service populates the model's words resource with any word that is recognized
+    #   by the grammar that is not found in the model's base vocabulary. These are
+    #   referred to as out-of-vocabulary (OOV) words. You can use the **List custom
+    #   words** method to examine the words resource and use other words-related methods
+    #   to eliminate typos and modify how words are pronounced as needed.
+    #
+    #   To add a grammar that has the same name as an existing grammar, set the
+    #   `allow_overwrite` parameter to `true`; otherwise, the request fails. Overwriting
+    #   an existing grammar causes the service to process the grammar file and extract OOV
+    #   words anew. Before doing so, it removes any OOV words associated with the existing
+    #   grammar from the model's words resource unless they were also added by another
+    #   resource or they have been modified in some way with the **Add custom words** or
+    #   **Add a custom word** method.
+    #
+    #   The service limits the overall amount of data that you can add to a custom model
+    #   to a maximum of 10 million total words from all sources combined. Also, you can
+    #   add no more than 30 thousand OOV words to a model. This includes words that the
+    #   service extracts from corpora and grammars and words that you add directly.
+    #
+    #   **See also:**
+    #   * [Working with grammars](https://cloud.ibm.com/docs/services/speech-to-text/)
+    #   * [Add grammars to the custom language
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text/).
+    # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
+    #   the request. You must make the request with credentials for the instance of the
+    #   service that owns the custom model.
+    # @param grammar_name [String] The name of the new grammar for the custom language model. Use a localized name
+    #   that matches the language of the custom model and reflects the contents of the
+    #   grammar.
+    #   * Include a maximum of 128 characters in the name.
+    #   * Do not include spaces, slashes, or backslashes in the name.
+    #   * Do not use the name of an existing grammar or corpus that is already defined for
+    #   the custom model.
+    #   * Do not use the name `user`, which is reserved by the service to denote custom
+    #   words that are added or modified by the user.
+    # @param grammar_file [String] A plain text file that contains the grammar in the format specified by the
+    #   `Content-Type` header. Encode the file in UTF-8 (ASCII is a subset of UTF-8).
+    #   Using any other encoding can lead to issues when compiling the grammar or to
+    #   unexpected results in decoding. The service ignores an encoding that is specified
+    #   in the header of the grammar.
+    # @param content_type [String] The format (MIME type) of the grammar file:
+    #   * `application/srgs` for Augmented Backus-Naur Form (ABNF), which uses a
+    #   plain-text representation that is similar to traditional BNF grammars.
+    #   * `application/srgs+xml` for XML Form, which uses XML elements to represent the
+    #   grammar.
+    # @param allow_overwrite [Boolean] If `true`, the specified grammar overwrites an existing grammar with the same
+    #   name. If `false`, the request fails if a grammar with the same name already
+    #   exists. The parameter has no effect if a grammar with the same name does not
+    #   already exist.
+    # @return [nil]
+    def add_grammar(customization_id:, grammar_name:, grammar_file:, content_type:, allow_overwrite: nil)
+      raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
+
+      raise ArgumentError.new("grammar_name must be provided") if grammar_name.nil?
+
+      raise ArgumentError.new("grammar_file must be provided") if grammar_file.nil?
+
+      raise ArgumentError.new("content_type must be provided") if content_type.nil?
+
+      headers = {
+        "Content-Type" => content_type
+      }
+
+      params = {
+        "allow_overwrite" => allow_overwrite
+      }
+
+      data = grammar_file
+
+      method_url = "/v1/customizations/%s/grammars/%s" % [ERB::Util.url_encode(customization_id), ERB::Util.url_encode(grammar_name)]
+
+      request(
+        method: "POST",
+        url: method_url,
+        headers: headers,
+        params: params,
+        data: data,
+        accept_json: true
+      )
+      nil
+    end
+
+    ##
+    # @!method get_grammar(customization_id:, grammar_name:)
+    # Get a grammar.
+    # Gets information about a grammar from a custom language model. The information
+    #   includes the total number of out-of-vocabulary (OOV) words, name, and status of
+    #   the grammar. You must use credentials for the instance of the service that owns a
+    #   model to list its grammars.
+    #
+    #   **See also:** [Listing grammars from a custom language
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text/).
+    # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
+    #   the request. You must make the request with credentials for the instance of the
+    #   service that owns the custom model.
+    # @param grammar_name [String] The name of the grammar for the custom language model.
+    # @return [DetailedResponse] A `DetailedResponse` object representing the response.
+    def get_grammar(customization_id:, grammar_name:)
+      raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
+
+      raise ArgumentError.new("grammar_name must be provided") if grammar_name.nil?
+
+      headers = {
+      }
+
+      method_url = "/v1/customizations/%s/grammars/%s" % [ERB::Util.url_encode(customization_id), ERB::Util.url_encode(grammar_name)]
+
+      response = request(
+        method: "GET",
+        url: method_url,
+        headers: headers,
+        accept_json: true
+      )
+      response
+    end
+
+    ##
+    # @!method delete_grammar(customization_id:, grammar_name:)
+    # Delete a grammar.
+    # Deletes an existing grammar from a custom language model. The service removes any
+    #   out-of-vocabulary (OOV) words associated with the grammar from the custom model's
+    #   words resource unless they were also added by another resource or they were
+    #   modified in some way with the **Add custom words** or **Add a custom word**
+    #   method. Removing a grammar does not affect the custom model until you train the
+    #   model with the **Train a custom language model** method. You must use credentials
+    #   for the instance of the service that owns a model to delete its grammar.
+    #
+    #   **See also:** [Deleting a grammar from a custom language
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text/).
+    # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
+    #   the request. You must make the request with credentials for the instance of the
+    #   service that owns the custom model.
+    # @param grammar_name [String] The name of the grammar for the custom language model.
+    # @return [nil]
+    def delete_grammar(customization_id:, grammar_name:)
+      raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
+
+      raise ArgumentError.new("grammar_name must be provided") if grammar_name.nil?
+
+      headers = {
+      }
+
+      method_url = "/v1/customizations/%s/grammars/%s" % [ERB::Util.url_encode(customization_id), ERB::Util.url_encode(grammar_name)]
+
+      request(
+        method: "DELETE",
+        url: method_url,
+        headers: headers,
+        accept_json: true
+      )
+      nil
+    end
+    #########################
     # Custom acoustic models
     #########################
 
@@ -1815,7 +2155,7 @@ module IBMWatson
     #   it.
     #
     #   **See also:** [Create a custom acoustic
-    #   model](https://console.bluemix.net/docs/services/speech-to-text/acoustic-create.html#createModel).
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text/acoustic-create.html#createModel).
     # @param name [String] A user-defined name for the new custom acoustic model. Use a name that is unique
     #   among all custom acoustic models that you own. Use a localized name that matches
     #   the language of the custom model. Use a name that describes the acoustic
@@ -1827,7 +2167,7 @@ module IBMWatson
     #
     #   To determine whether a base model supports acoustic model customization, refer to
     #   [Language support for
-    #   customization](https://console.bluemix.net/docs/services/speech-to-text/custom.html#languageSupport).
+    #   customization](https://cloud.ibm.com/docs/services/speech-to-text/custom.html#languageSupport).
     # @param description [String] A description of the new custom acoustic model. Use a localized description that
     #   matches the language of the custom model.
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
@@ -1867,10 +2207,10 @@ module IBMWatson
     #   a model to list information about it.
     #
     #   **See also:** [Listing custom acoustic
-    #   models](https://console.bluemix.net/docs/services/speech-to-text/acoustic-models.html#listModels).
+    #   models](https://cloud.ibm.com/docs/services/speech-to-text/acoustic-models.html#listModels).
     # @param language [String] The identifier of the language for which custom language or custom acoustic models
     #   are to be returned (for example, `en-US`). Omit the parameter to see all custom
-    #   language or custom acoustic models owned by the requesting service credentials.
+    #   language or custom acoustic models that are owned by the requesting credentials.
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def list_acoustic_models(language: nil)
       headers = {
@@ -1899,10 +2239,10 @@ module IBMWatson
     #   for the instance of the service that owns a model to list information about it.
     #
     #   **See also:** [Listing custom acoustic
-    #   models](https://console.bluemix.net/docs/services/speech-to-text/acoustic-models.html#listModels).
+    #   models](https://cloud.ibm.com/docs/services/speech-to-text/acoustic-models.html#listModels).
     # @param customization_id [String] The customization ID (GUID) of the custom acoustic model that is to be used for
-    #   the request. You must make the request with service credentials created for the
-    #   instance of the service that owns the custom model.
+    #   the request. You must make the request with credentials for the instance of the
+    #   service that owns the custom model.
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def get_acoustic_model(customization_id:)
       raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
@@ -1930,10 +2270,10 @@ module IBMWatson
     #   model to delete it.
     #
     #   **See also:** [Deleting a custom acoustic
-    #   model](https://console.bluemix.net/docs/services/speech-to-text/acoustic-models.html#deleteModel).
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text/acoustic-models.html#deleteModel).
     # @param customization_id [String] The customization ID (GUID) of the custom acoustic model that is to be used for
-    #   the request. You must make the request with service credentials created for the
-    #   instance of the service that owns the custom model.
+    #   the request. You must make the request with credentials for the instance of the
+    #   service that owns the custom model.
     # @return [nil]
     def delete_acoustic_model(customization_id:)
       raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
@@ -1988,15 +2328,15 @@ module IBMWatson
     #   Training can fail to start for the following reasons:
     #   * The service is currently handling another request for the custom model, such as
     #   another training request or a request to add audio resources to the model.
-    #   * The custom model contains less than 10 minutes or more than 50 hours of audio
+    #   * The custom model contains less than 10 minutes or more than 100 hours of audio
     #   data.
     #   * One or more of the custom model's audio resources is invalid.
     #
     #   **See also:** [Train the custom acoustic
-    #   model](https://console.bluemix.net/docs/services/speech-to-text/acoustic-create.html#trainModel).
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text/acoustic-create.html#trainModel).
     # @param customization_id [String] The customization ID (GUID) of the custom acoustic model that is to be used for
-    #   the request. You must make the request with service credentials created for the
-    #   instance of the service that owns the custom model.
+    #   the request. You must make the request with credentials for the instance of the
+    #   service that owns the custom model.
     # @param custom_language_model_id [String] The customization ID (GUID) of a custom language model that is to be used during
     #   training of the custom acoustic model. Specify a custom language model that has
     #   been trained with verbatim transcriptions of the audio resources or that contains
@@ -2034,10 +2374,10 @@ module IBMWatson
     #   credentials for the instance of the service that owns a model to reset it.
     #
     #   **See also:** [Resetting a custom acoustic
-    #   model](https://console.bluemix.net/docs/services/speech-to-text/acoustic-models.html#resetModel).
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text/acoustic-models.html#resetModel).
     # @param customization_id [String] The customization ID (GUID) of the custom acoustic model that is to be used for
-    #   the request. You must make the request with service credentials created for the
-    #   instance of the service that owns the custom model.
+    #   the request. You must make the request with credentials for the instance of the
+    #   service that owns the custom model.
     # @return [nil]
     def reset_acoustic_model(customization_id:)
       raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
@@ -2083,10 +2423,10 @@ module IBMWatson
     #   acoustic model was not trained with a custom language model.
     #
     #   **See also:** [Upgrading a custom acoustic
-    #   model](https://console.bluemix.net/docs/services/speech-to-text/custom-upgrade.html#upgradeAcoustic).
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text/custom-upgrade.html#upgradeAcoustic).
     # @param customization_id [String] The customization ID (GUID) of the custom acoustic model that is to be used for
-    #   the request. You must make the request with service credentials created for the
-    #   instance of the service that owns the custom model.
+    #   the request. You must make the request with credentials for the instance of the
+    #   service that owns the custom model.
     # @param custom_language_model_id [String] If the custom acoustic model was trained with a custom language model, the
     #   customization ID (GUID) of that custom language model. The custom language model
     #   must be upgraded before the custom acoustic model can be upgraded.
@@ -2127,10 +2467,10 @@ module IBMWatson
     #   the instance of the service that owns a model to list its audio resources.
     #
     #   **See also:** [Listing audio resources for a custom acoustic
-    #   model](https://console.bluemix.net/docs/services/speech-to-text/acoustic-audio.html#listAudio).
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text/acoustic-audio.html#listAudio).
     # @param customization_id [String] The customization ID (GUID) of the custom acoustic model that is to be used for
-    #   the request. You must make the request with service credentials created for the
-    #   instance of the service that owns the custom model.
+    #   the request. You must make the request with credentials for the instance of the
+    #   service that owns the custom model.
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def list_audio(customization_id:)
       raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
@@ -2167,8 +2507,8 @@ module IBMWatson
     #   You can use this method to add any number of audio resources to a custom model by
     #   calling the method once for each audio or archive file. But the addition of one
     #   audio resource must be fully complete before you can add another. You must add a
-    #   minimum of 10 minutes and a maximum of 50 hours of audio that includes speech, not
-    #   just silence, to a custom acoustic model before you can train it. No audio
+    #   minimum of 10 minutes and a maximum of 100 hours of audio that includes speech,
+    #   not just silence, to a custom acoustic model before you can train it. No audio
     #   resource, audio- or archive-type, can be larger than 100 MB. To add an audio
     #   resource that has the same name as an existing audio resource, set the
     #   `allow_overwrite` parameter to `true`; otherwise, the request fails.
@@ -2189,7 +2529,8 @@ module IBMWatson
     #   every few seconds until it becomes `ok`.
     #
     #   **See also:** [Add audio to the custom acoustic
-    #   model](https://console.bluemix.net/docs/services/speech-to-text/acoustic-create.html#addAudio).
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text/acoustic-create.html#addAudio).
+    #
     #
     #   ### Content types for audio-type resources
     #
@@ -2199,6 +2540,7 @@ module IBMWatson
     #   the sampling rate, channels, and endianness where indicated.
     #   * `audio/basic` (Use only with narrowband models.)
     #   * `audio/flac`
+    #   * `audio/g729` (Use only with narrowband models.)
     #   * `audio/l16` (Specify the sampling rate (`rate`) and optionally the number of
     #   channels (`channels`) and endianness (`endianness`) of the audio.)
     #   * `audio/mp3`
@@ -2212,14 +2554,15 @@ module IBMWatson
     #   * `audio/webm;codecs=opus`
     #   * `audio/webm;codecs=vorbis`
     #
-    #   **See also:** [Audio formats](https://console.bluemix.net/docs/services/speech-to-text/audio-formats.html).
+    #   The sampling rate of an audio file must match the sampling rate of the base model
+    #   for the custom model: for broadband models, at least 16 kHz; for narrowband
+    #   models, at least 8 kHz. If the sampling rate of the audio is higher than the
+    #   minimum required rate, the service down-samples the audio to the appropriate rate.
+    #   If the sampling rate of the audio is lower than the minimum required rate, the
+    #   service labels the audio file as `invalid`.
     #
-    #   **Note:** The sampling rate of an audio file must match the sampling rate of the
-    #   base model for the custom model: for broadband models, at least 16 kHz; for
-    #   narrowband models, at least 8 kHz. If the sampling rate of the audio is higher
-    #   than the minimum required rate, the service down-samples the audio to the
-    #   appropriate rate. If the sampling rate of the audio is lower than the minimum
-    #   required rate, the service labels the audio file as `invalid`.
+    #    **See also:** [Audio
+    #   formats](https://cloud.ibm.com/docs/services/speech-to-text/audio-formats.html).
     #
     #   ### Content types for archive-type resources
     #
@@ -2247,8 +2590,8 @@ module IBMWatson
     #   * Do not use the name of an audio file that has already been added to the custom
     #   model as part of an archive-type resource.
     # @param customization_id [String] The customization ID (GUID) of the custom acoustic model that is to be used for
-    #   the request. You must make the request with service credentials created for the
-    #   instance of the service that owns the custom model.
+    #   the request. You must make the request with credentials for the instance of the
+    #   service that owns the custom model.
     # @param audio_name [String] The name of the new audio resource for the custom acoustic model. Use a localized
     #   name that matches the language of the custom model and reflects the contents of
     #   the resource.
@@ -2331,10 +2674,10 @@ module IBMWatson
     #   its audio resources.
     #
     #   **See also:** [Listing audio resources for a custom acoustic
-    #   model](https://console.bluemix.net/docs/services/speech-to-text/acoustic-audio.html#listAudio).
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text/acoustic-audio.html#listAudio).
     # @param customization_id [String] The customization ID (GUID) of the custom acoustic model that is to be used for
-    #   the request. You must make the request with service credentials created for the
-    #   instance of the service that owns the custom model.
+    #   the request. You must make the request with credentials for the instance of the
+    #   service that owns the custom model.
     # @param audio_name [String] The name of the audio resource for the custom acoustic model.
     # @return [DetailedResponse] A `DetailedResponse` object representing the response.
     def get_audio(customization_id:, audio_name:)
@@ -2368,10 +2711,10 @@ module IBMWatson
     #   delete its audio resources.
     #
     #   **See also:** [Deleting an audio resource from a custom acoustic
-    #   model](https://console.bluemix.net/docs/services/speech-to-text/acoustic-audio.html#deleteAudio).
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text/acoustic-audio.html#deleteAudio).
     # @param customization_id [String] The customization ID (GUID) of the custom acoustic model that is to be used for
-    #   the request. You must make the request with service credentials created for the
-    #   instance of the service that owns the custom model.
+    #   the request. You must make the request with credentials for the instance of the
+    #   service that owns the custom model.
     # @param audio_name [String] The name of the audio resource for the custom acoustic model.
     # @return [nil]
     def delete_audio(customization_id:, audio_name:)
@@ -2409,7 +2752,7 @@ module IBMWatson
     #   with a request that passes the data.
     #
     #   **See also:** [Information
-    #   security](https://console.bluemix.net/docs/services/speech-to-text/information-security.html).
+    #   security](https://cloud.ibm.com/docs/services/speech-to-text/information-security.html).
     # @param customer_id [String] The customer ID for which all data is to be deleted.
     # @return [nil]
     def delete_user_data(customer_id:)