DELETE

/bots/{botId}/botaliases/{botAliasId}/

http://models-v2-lex.{region}.amazonaws.com/bots/{botId}/botaliases/{botAliasId}/

Deletes the specified bot alias.

Access Token Required: API Key

Path Parameters

botAliasIdstringrequired

The unique identifier of the bot alias to delete.

botIdstringrequired

The unique identifier of the bot associated with the alias to delete.

Query Params

skipResourceInUseCheckboolean

By default, Amazon Lex checks if any other resource, such as a bot network, is using the bot alias before it is deleted and throws a <code>ResourceInUseException</code> exception if the alias is being used by another resource. Set this parameter to <code>true</code> to skip this check and remove the alias even if it is being used by another resource.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request DELETE \
2     --url 'http://models-v2-lex.{region}.amazonaws.com/bots/{botId}/botaliases/{botAliasId}/' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}