Share via

Apps - Add

Service:
Azure AI Services
API Version:
2.0

Creates a new LUIS app.

POST {Endpoint}/luis/api/v2.0/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

POST {Endpoint}/luis/api/v2.0/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
"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

Object

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

Object

Error response when invoking an operation on the API.

Name Type Description
errorType

string