Apps - Add

Service:

Cognitive Services - LUIS

API Version:

3.0-preview

Creates a new LUIS app.

POST {Endpoint}/luis/authoring/v3.0-preview/apps/

URI Parameters

Name	In	Required	Type	Description
Endpoint	path	True	string	Supported Cognitive Services endpoints (protocol and hostname, for example: https://westus.api.cognitive.microsoft.com).

Request Header

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

Request Body

Name	Required	Type	Description
culture	True	string	The culture for the new application. It is the language that your app understands and speaks. E.g.: "en-us". Note: the culture cannot be changed after the app is created.
name	True	string	The name for the new application.
description		string	Description of the new application. Optional.
domain		string	The domain for the new application. Optional. E.g.: Comics.
initialVersionId		string	The initial version ID. Optional. Default value is: "0.1"
usageScenario		string	Defines the scenario for the new application. Optional. E.g.: IoT.

Responses

Name	Type	Description
201 Created	string	The ID of the created application.
Other Status Codes	ErrorResponse	Error Response.

Security

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Examples

Successful Application Creation

Sample Request

HTTP

POST {Endpoint}/luis/authoring/v3.0-preview/apps/


{
  "culture": "en-us",
  "domain": "Comics",
  "description": "New LUIS App",
  "usageScenario": "IoT",
  "name": "New LUIS App"
}

Sample Response

Status code:

201

location: https://westus.api.cognitive.microsoft.com/luis/api/v2.0/apps/9e6703ec-56fe-48ce-8a72-10d592f6056d

Response Body

"9e6703ec-56fe-48ce-8a72-10d592f6056d"

Definitions

Name	Description
ApplicationCreateObject	Properties for creating a new LUIS Application
ErrorResponse	Error response when invoking an operation on the API.

ApplicationCreateObject

Properties for creating a new LUIS Application

Name	Type	Description
culture	string	The culture for the new application. It is the language that your app understands and speaks. E.g.: "en-us". Note: the culture cannot be changed after the app is created.
description	string	Description of the new application. Optional.
domain	string	The domain for the new application. Optional. E.g.: Comics.
initialVersionId	string	The initial version ID. Optional. Default value is: "0.1"
name	string	The name for the new application.
usageScenario	string	Defines the scenario for the new application. Optional. E.g.: IoT.

ErrorResponse

Error response when invoking an operation on the API.

Name	Type	Description
errorType	string