Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1471501483.8 KB

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

put/bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/

Path parameters

botIdstring required

The unique identifier of the bot that contains the locale.

botVersionstring required

The version of the bot that contains the locale to be updated. The version can only be the <code>DRAFT</code> version.

localeIdstring required

The identifier of the language and locale to update. The string must match one of the supported locales. For more information, see <a href="https://docs.aws.amazon.com/lexv2/latest/dg/how-languages.html">Supported languages</a>.

Request body

descriptionstring

The new description of the locale.

nluIntentConfidenceThresholdnumber 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.

Response

Success

botIdstring

The identifier of the bot that contains the updated locale.

botVersionstring

The version of the bot that contains the updated locale.

localeIdstring

The language and locale of the updated bot locale.

localeNamestring

The updated locale name for the locale.

descriptionstring

The updated description of the locale.

nluIntentConfidenceThresholdnumber 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.

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.

failureReasonsFailureReason[]

If the <code>botLocaleStatus</code> is <code>Failed</code>, the <code>failureReasons</code> field lists the errors that occurred while building the bot.

creationDateTimestring date-time

A timestamp of the date and time that the locale was created.

lastUpdatedDateTimestring date-time

A timestamp of the date and time that the locale was last updated.

recommendedActionsRecommendedAction[]

Recommended actions to take to resolve an error in the <code>failureReasons</code> field.