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

# PUT /bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/

`PUT /bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/`

Updates the settings that a bot has for a specific locale.

## Path parameters

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

## Request body

- object
  - `description` string — The new description of the locale.
  - `nluIntentConfidenceThreshold` number, double, required — The new confidence threshold where Amazon Lex inserts the <code>AMAZON.FallbackIntent</code> and <code>AMAZON.KendraSearchIntent</code> intents in the list of possible intents for an utterance.
  - `voiceSettings` object — Defines settings for using an Amazon Polly voice to communicate with a user.
    - `voiceId` string — The identifier of the Amazon Polly voice to use.
    - `engine` 'standard' | 'neural' — <p>Indicates the type of Amazon Polly voice that Amazon Lex should use for voice interaction with the user. For more information, see the <a href="https://docs.aws.amazon.com/polly/latest/dg/API_SynthesizeSpeech.html#polly-SynthesizeSpeech-request-Engine"> <code>engine</code> parameter of the <code>SynthesizeSpeech</code> operation</a> in the <i>Amazon Polly developer guide</i>.</p> <p>If you do not specify a value, the default is <code>standard</code>.</p>

## Response `202`

Success

- UpdateBotLocaleResponse
  - `botId` string — The identifier of the bot that contains the updated locale.
  - `botVersion` string — The version of the bot that contains the updated locale.
  - `localeId` string — The language and locale of the updated bot locale.
  - `localeName` string — The updated locale name for the locale.
  - `description` string — The updated description of the locale.
  - `nluIntentConfidenceThreshold` number, double — The updated confidence threshold for inserting the <code>AMAZON.FallbackIntent</code> and <code>AMAZON.KendraSearchIntent</code> intents in the list of possible intents for an utterance.
  - `voiceSettings` object — The updated Amazon Polly voice to use for voice interaction with the user.
    - `voiceId` string, required — The identifier of the Amazon Polly voice to use.
    - `engine` 'standard' | 'neural' — <p>Indicates the type of Amazon Polly voice that Amazon Lex should use for voice interaction with the user. For more information, see the <a href="https://docs.aws.amazon.com/polly/latest/dg/API_SynthesizeSpeech.html#polly-SynthesizeSpeech-request-Engine"> <code>engine</code> parameter of the <code>SynthesizeSpeech</code> operation</a> in the <i>Amazon Polly developer guide</i>.</p> <p>If you do not specify a value, the default is <code>standard</code>.</p>
  - `botLocaleStatus` 'Creating' | 'Building' | 'Built' | 'ReadyExpressTesting' | 'Failed' | 'Deleting' | 'NotBuilt' | 'Importing' | 'Processing' — The current status of the locale. When the bot status is <code>Built</code> the locale is ready for use.
  - `failureReasons` FailureReason[] — If the <code>botLocaleStatus</code> is <code>Failed</code>, the <code>failureReasons</code> field lists the errors that occurred while building the bot.
  - `creationDateTime` string, date-time — A timestamp of the date and time that the locale was created.
  - `lastUpdatedDateTime` string, date-time — A timestamp of the date and time that the locale was last updated.
  - `recommendedActions` RecommendedAction[] — Recommended actions to take to resolve an error in the <code>failureReasons</code> field.

## Other responses

- `480` — ThrottlingException
- `481` — ServiceQuotaExceededException
- `482` — ValidationException
- `483` — PreconditionFailedException
- `484` — ConflictException
- `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)