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