Versions - Get

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/api/v2.0/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

GET {Endpoint}/luis/api/v2.0/apps/363187f1-c573-46b3-bc4c-ae01d686e68e/versions/0.1/

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"