Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1471501483.8 KB

Gets information about all of the versions of a bot.

The ListBotVersions operation returns a summary of each version of a bot. For example, if a bot has three numbered versions, the ListBotVersions operation returns for summaries, one for each numbered version and one for the DRAFT version.

The ListBotVersions operation always returns at least one version, the DRAFT version.

post/bots/{botId}/botversions/

Path parameters

botIdstring required

The identifier of the bot to list versions for.

Query parameters

maxResultsstring

Pagination limit

nextTokenstring

Pagination token

Request body

maxResultsinteger

The maximum number of versions to return in each page of results. If there are fewer results than the max page size, only the actual number of results are returned.

nextTokenstring

If the response to the <code>ListBotVersion</code> operation contains more results than specified in the <code>maxResults</code> parameter, a token is returned in the response. Use that token in the <code>nextToken</code> parameter to return the next page of results.

Response

Success

botIdstring

The identifier of the bot to list versions for.

nextTokenstring

A token that indicates whether there are more results to return in a response to the <code>ListBotVersions</code> operation. If the <code>nextToken</code> field is present, you send the contents as the <code>nextToken</code> parameter of a <code>ListBotAliases</code> operation request to get the next page of results.