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

# PUT /bots/{botId}/botversions/

`PUT /bots/{botId}/botversions/`

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.

## Path parameters

- `botId` string, required

## Request body

- object
  - `description` string — A description of the version. Use the description to help identify the version in lists.
  - `botVersionLocaleSpecification` object, 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 `202`

Success

- CreateBotVersionResponse
  - `botId` string — The bot identifier specified in the request.
  - `description` string — The description of the version specified in the request.
  - `botVersion` string — The version number assigned to the version.
  - `botVersionLocaleSpecification` object — 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>.
  - `creationDateTime` string, date-time — A timestamp of the date and time that the version was created.

## 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)