DeleteUtterances - Amazon Lex API Reference


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.


The unique identifier of the bot that contains the utterances.

Length Constraints: Fixed length of 10.

Pattern: ^[0-9a-zA-Z]+$

Required: Yes


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.


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.


For information about the errors that are common to all actions, see Common Errors.


The service encountered an unexpected condition. Try your request again.

HTTP Status Code: 500


Your request rate is too high. Reduce the frequency of requests.

HTTP Status Code: 429


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: