Versions - List

Gets a list of versions for this application ID.

GET {Endpoint}/luis/api/v2.0/apps/{appId}/versions
GET {Endpoint}/luis/api/v2.0/apps/{appId}/versions?skip={skip}&take={take}

URI Parameters

Name In Required Type Description
appId
path True

string

uuid

The application ID.

Endpoint
path True

string

Supported Cognitive Services endpoints (protocol and hostname, for example: https://westus.api.cognitive.microsoft.com).

skip
query

integer

The number of entries to skip. Default value is 0.

take
query

integer

The number of entries to return. Maximum page size is 500. Default is 100.

Request Header

Name Required Type Description
Ocp-Apim-Subscription-Key True

string

Responses

Name Type Description
200 OK

VersionInfo[]

A list of all versions of the application.

Other Status Codes

ErrorResponse

Error Response.

Security

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Examples

Successful Get Application Versions info request

Sample request

GET {Endpoint}/luis/api/v2.0/apps/363187f1-c573-46b3-bc4c-ae01d686e68e/versions?skip=0&take=100

Sample response

[
  {
    "version": "0.1",
    "createdDateTime": "2017-08-01T14:34:15Z",
    "lastModifiedDateTime": "2017-11-28T20:12:09Z",
    "lastTrainedDateTime": "2017-11-28T20:12:12Z",
    "lastPublishedDateTime": "2017-11-28T20:12:35Z",
    "endpointUrl": "https://westus.api.cognitive.microsoft.com/luis/v2.0/apps/363187f1-c573-46b3-bc4c-ae01d686e68e",
    "assignedEndpointKey": {
      "SubscriptionKey": "",
      "SubscriptionRegion": "westus",
      "SubscriptionName": ""
    },
    "externalApiKeys": {},
    "intentsCount": 4,
    "entitiesCount": 0,
    "endpointHitsCount": 175,
    "trainingStatus": "Trained"
  }
]

Definitions

Name Description
ErrorResponse

Error response when invoking an operation on the API.

TrainingStatus

The Training status.

VersionInfo

Object model of an application version.

ErrorResponse

Error response when invoking an operation on the API.

Name Type Description
errorType

string

TrainingStatus

The Training status.

Name Type Description
Fail

string

InProgress

string

Queued

string

Success

string

UpToDate

string

VersionInfo

Object model of an application version.

Name Type Description
assignedEndpointKey

object

The endpoint key.

createdDateTime

string

The version's creation timestamp.

endpointHitsCount

integer

Number of calls made to this endpoint.

endpointUrl

string

The Runtime endpoint URL for this model version.

entitiesCount

integer

Number of entities in this model.

externalApiKeys

object

External keys.

intentsCount

integer

Number of intents in this model.

lastModifiedDateTime

string

Timestamp of the last update.

lastPublishedDateTime

string

Timestamp when was last published.

lastTrainedDateTime

string

Timestamp of the last time the model was trained.

trainingStatus

TrainingStatus

The current training status.

version

string

The version ID. E.g.: "0.1"