DeleteBotAlias - Amazon Lex


Deletes an alias for the specified bot.

You can't delete an alias that is used in the association between a bot and a messaging channel. If an alias is used in a channel association, the DeleteBot operation returns a ResourceInUseException exception that includes a reference to the channel association that refers to the bot. You can remove the reference to the alias by deleting the channel association. If you get the same exception again, delete the referring association until the DeleteBotAlias operation is successful.

Request Syntax

DELETE /bots/botName/aliases/name HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.


The name of the bot that the alias points to.

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

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

Required: Yes


The name of the alias to delete. The name is case sensitive.

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

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

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: