Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-14107861793.8 KB

Creates an immutable version of the bot. When you create the first version of a bot, Amazon Lex sets the version number to 1. Subsequent bot versions increase in an increment of 1. The version number will always represent the total number of versions created of the bot, not the current number of versions. If a bot version is deleted, that bot version number will not be reused.

put/bots/{botId}/botversions/

Path parameters

botIdstring required

The identifier of the bot to create the version for.

Request body

descriptionstring

A description of the version. Use the description to help identify the version in lists.

botVersionLocaleSpecificationobject required

Specifies the locales that Amazon Lex adds to this version. You can choose the <code>Draft</code> version or any other previously published version for each locale. When you specify a source version, the locale data is copied from the source version to the new version.

Response

Success

botIdstring

The bot identifier specified in the request.

descriptionstring

The description of the version specified in the request.

botVersionstring

The version number assigned to the version.

botVersionLocaleSpecificationobject

The source versions used for each locale in the new version.

botStatus'Creating' | 'Available' | 'Inactive' | 'Deleting' | 'Failed' | 'Versioning' | 'Importing' | 'Updating'

When you send a request to create or update a bot, Amazon Lex sets the status response element to <code>Creating</code>. After Amazon Lex builds the bot, it sets status to <code>Available</code>. If Amazon Lex can't build the bot, it sets status to <code>Failed</code>.

creationDateTimestring date-time

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