DeleteUtterances
Deletes stored utterances.
Amazon Lex stores the utterances that users send to your bot. Utterances are stored for 15 days for use with the ListAggregatedUtterances operation, and then stored indefinitely for use in improving the ability of your bot to respond to user input..
Use the DeleteUtterances operation to manually delete
utterances for a specific session. When you use the
DeleteUtterances operation, utterances stored for
improving your bot's ability to respond to user input are deleted
immediately. Utterances stored for use with the
ListAggregatedUtterances operation are deleted after 15
days.
Request Syntax
DELETE /bots/botId/utterances/?localeId=localeId&sessionId=sessionId HTTP/1.1
URI Request Parameters
The request uses the following URI parameters.
- botId
-
The unique identifier of the bot that contains the utterances.
Length Constraints: Fixed length of 10.
Pattern:
^[0-9a-zA-Z]+$Required: Yes
- localeId
-
The identifier of the language and locale where the utterances were collected. The string must match one of the supported locales. For more information, see Supported languages.
- sessionId
-
The unique identifier of the session with the user. The ID is returned in the response from the RecognizeText and RecognizeUtterance operations.
Length Constraints: Minimum length of 2. Maximum length of 100.
Pattern:
[0-9a-zA-Z._:-]+
Request Body
The request does not have a request body.
Response Syntax
HTTP/1.1 204
Response Elements
If the action is successful, the service sends back an HTTP 204 response with an empty HTTP body.
Errors
For information about the errors that are common to all actions, see Common Errors.
- InternalServerException
-
The service encountered an unexpected condition. Try your request again.
HTTP Status Code: 500
- ThrottlingException
-
Your request rate is too high. Reduce the frequency of requests.
HTTP Status Code: 429
- ValidationException
-
One of the input parameters in your request isn't valid. Check the parameters and try your request again.
HTTP Status Code: 400
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
