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

# POST /bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/generations

`POST /bots/{botId}/botversions/{botVersion}/botlocales/{localeId}/generations`

Lists the generation requests made for a bot locale.

## Path parameters

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

## Request body

- object
  - `sortBy` object — Specifies the attribute and method by which to sort the generation request information.
    - `attribute` 'creationStartTime' | 'lastUpdatedTime' — <p>The attribute by which to sort the generation request information. You can sort by the following attributes.</p> <ul> <li> <p> <code>creationStartTime</code> – The time at which the generation request was created.</p> </li> <li> <p> <code>lastUpdatedTime</code> – The time at which the generation request was last updated.</p> </li> </ul>
    - `order` 'Ascending' | 'Descending' — The order by which to sort the generation request information.
  - `maxResults` integer — The maximum number of results to return in the response.
  - `nextToken` string — If the total number of results is greater than the number specified in the <code>maxResults</code>, the response returns a token in the <code>nextToken</code> field. Use this token when making a request to return the next batch of results.

## Response `200`

Success

- ListBotResourceGenerationsResponse
  - `botId` string — The unique identifier of the bot for which the generation requests were made.
  - `botVersion` string — The version of the bot for which the generation requests were made.
  - `localeId` string — The locale of the bot for which the generation requests were made.
  - `generationSummaries` GenerationSummary[] — A list of objects, each containing information about a generation request for the bot locale.
    - `generationId` string — The unique identifier of the generation request.
    - `generationStatus` 'Failed' | 'Complete' | 'InProgress' — The status of the generation request.
    - `creationDateTime` string, date-time — The date and time at which the generation request was made.
    - `lastUpdatedDateTime` string, date-time — The date and time at which the generation request was last updated.
  - `nextToken` string — If the total number of results is greater than the number specified in the <code>maxResults</code>, the response returns a token in the <code>nextToken</code> field. Use this token when making a request to return the next batch of results.

## Other responses

- `480` — ThrottlingException
- `481` — ValidationException
- `482` — InternalServerException
- `483` — ResourceNotFoundException

---

[API](https://skmtc.net/aws/apis/lexv2-models.md) · [All operations](https://skmtc.net/aws/apis/lexv2-models/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/lexv2-models/versions/6997ba482d72/schema)