---
title: "DELETE /bots/{botId}/botaliases/{botAliasId}/"
method: DELETE
path: "/bots/{botId}/botaliases/{botAliasId}/"
---

# DELETE /bots/{botId}/botaliases/{botAliasId}/

`DELETE /bots/{botId}/botaliases/{botAliasId}/`

Deletes the specified bot alias.

## Path parameters

- `botAliasId` string, required
- `botId` string, required

## Query parameters

- `skipResourceInUseCheck` boolean

## Response `202`

Success

- DeleteBotAliasResponse
  - `botAliasId` string — The unique identifier of the bot alias to delete.
  - `botId` string — The unique identifier of the bot that contains the alias to delete.
  - `botAliasStatus` 'Creating' | 'Available' | 'Deleting' | 'Failed' — The current status of the alias. The status is <code>Deleting</code> while the alias is in the process of being deleted. Once the alias is deleted, it will no longer appear in the list of aliases returned by the <code>ListBotAliases</code> operation.

## Other responses

- `480` — ThrottlingException
- `481` — ServiceQuotaExceededException
- `482` — ValidationException
- `483` — ConflictException
- `484` — PreconditionFailedException
- `485` — InternalServerException

---

[API](https://skmtc.net/aws/apis/models-lex-v2.md) · [All operations](https://skmtc.net/aws/apis/models-lex-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/models-lex-v2/versions/4ee1a1257ae7/schema)