Versions - Get

Reference

Service:: Cognitive Services - LUIS

API Version:: 3.0-preview

Gets the version information such as date created, last modified date, endpoint URL, count of intents and entities, training and publishing status.

GET {Endpoint}/luis/authoring/v3.0-preview/apps/{appId}/versions/{versionId}/

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).
versionId	path	True	string	The version ID.

Request Header

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

Responses

Name	Type	Description
200 OK	VersionInfo	A model containing the version info.
Other Status Codes	ErrorResponse	Error Response.

Security

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Examples

Successful Get Application Version info request

Sample Request

HTTP

GET {Endpoint}/luis/authoring/v3.0-preview/apps/363187f1-c573-46b3-bc4c-ae01d686e68e/versions/0.1/

Sample Response

Status code:: 200

{
  "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"

Share via