---
title: "DELETE /bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/customvocabulary"
method: DELETE
path: "/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/customvocabulary"
---

# DELETE /bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/customvocabulary

`DELETE /bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/customvocabulary`

Removes a custom vocabulary from the specified locale in the specified bot.

## Path parameters

- `botId` string, required
- `botVersion` string, required
- `localeId` string, required

## Response `202`

Success

- DeleteCustomVocabularyResponse
  - `botId` string — The identifier of the bot that the custom vocabulary was removed from.
  - `botVersion` string — The version of the bot that the custom vocabulary was removed from.
  - `localeId` string — The locale identifier for the locale that the custom vocabulary was removed from.
  - `customVocabularyStatus` 'Ready' | 'Deleting' | 'Exporting' | 'Importing' | 'Creating' — The status of removing the custom vocabulary.

## Other responses

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

---

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