Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1471501483.8 KB

Creates a new version of the bot based on the DRAFT version. If the DRAFT version of this resource hasn't changed since you created the last version, Amazon Lex doesn't create a new version, it returns the last created version.

When you create the first version of a bot, Amazon Lex sets the version to 1. Subsequent versions increment by 1.

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.