DeleteBotVersion - Amazon Lex V1

If you are using Amazon Lex V2, refer to the Amazon Lex V2 guide instead.


If you are using Amazon Lex V1, we recommend upgrading your bots to Amazon Lex V2. We are no longer adding new features to V1 and strongly recommend using V2 for all new bots.


Deletes a specific version of a bot. To delete all versions of a bot, use the DeleteBot operation.

This operation requires permissions for the lex:DeleteBotVersion action.

Request Syntax

DELETE /bots/name/versions/version HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.


The name of the bot.

Length Constraints: Minimum length of 2. Maximum length of 50.

Pattern: ^([A-Za-z]_?)+$

Required: Yes


The version of the bot to delete. You cannot delete the $LATEST version of the bot. To delete the $LATEST version, use the DeleteBot operation.

Length Constraints: Minimum length of 1. Maximum length of 64.

Pattern: [0-9]+

Required: Yes

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.



The request is not well formed. For example, a value is invalid or a required field is missing. Check the field values, and try again.

HTTP Status Code: 400


There was a conflict processing the request. Try your request again.

HTTP Status Code: 409


An internal Amazon Lex error occurred. Try your request again.

HTTP Status Code: 500


The request exceeded a limit. Try your request again.

HTTP Status Code: 429


The resource specified in the request was not found. Check the resource and try again.

HTTP Status Code: 404


The resource that you are attempting to delete is referred to by another resource. Use this information to remove references to the resource that you are trying to delete.

The body of the exception contains a JSON object that describes the resource.


"resourceReference": {

"name": string, "version": string } }

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: