GET

/bots/{name}/versions/

http://models.lex.{region}.amazonaws.com/bots/{name}/versions/

Gets information about all of the versions of a bot. The <code>GetBotVersions</code> operation returns a <code>BotMetadata</code> object for each version of a bot. For example, if a bot has three numbered versions, the <code>GetBotVersions</code> operation returns four <code>BotMetadata</code> objects in the response, one for each numbered version and one for the <code>$LATEST</code> version. The <code>GetBotVersions</code> operation always returns at least one version, the <code>$LATEST</code> version. This operation requires permissions for the <code>lex:GetBotVersions</code> action.

Access Token Required: API Key

Path Parameters

namestringrequired

The name of the bot for which versions should be returned.

Query Params

nextTokenstring

A pagination token for fetching the next page of bot versions. If the response to this call is truncated, Amazon Lex returns a pagination token in the response. To fetch the next page of versions, specify the pagination token in the next request.

maxResultsinteger

The maximum number of bot versions to return in the response. The default is 10.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request GET \
2     --url 'http://models.lex.{region}.amazonaws.com/bots/{name}/versions/' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}

GET