Authoring and publishing regions and the associated keys

Three authoring regions are supported by corresponding LUIS portals. To publish a LUIS app to more than one region, you need at least one key per region.

LUIS Authoring regions

There are three LUIS authoring portals, based on region. You must author and publish in the same region.

LUIS Authoring region Azure region name
www.luis.ai U.S.
not Europe
not Australia
westus
au.luis.ai Australia australiaeast
eu.luis.ai Europe westeurope

Authoring regions have paired fail-over regions.

Publishing regions and Azure resources

The app is published to all regions associated with the LUIS resources added in the LUIS portal. For example, for an app created on www.luis.ai, if you create a LUIS or Cognitive Service resource in westus and add it to the app as a resource, the app is published in that region.

Public apps

A public app is published in all regions so that a user with a region-based LUIS resource key can access the app in whichever region is associated with their resource key.

Publishing regions are tied to authoring regions

The authoring region app can only be published to a corresponding publish region. If your app is currently in the wrong authoring region, export the app, and import it into the correct authoring region for your publishing region.

LUIS apps created on https://www.luis.ai can be published to all endpoints except the European and Australian regions.

Publishing to Europe

To publish to the European regions, you create LUIS apps at https://eu.luis.ai only. If you attempt to publish anywhere else using a key in the Europe region, LUIS displays a warning message. Instead, use https://eu.luis.ai. LUIS apps created at https://eu.luis.ai don't automatically migrate to other regions. Export and then import the LUIS app in order to migrate it.

Europe publishing regions

Global region Authoring API region & authoring website Publishing & querying region
API region name
Endpoint URL format
Europe westeurope
eu.luis.ai
France Central
francecentral
https://francecentral.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
Europe westeurope
eu.luis.ai
North Europe
northeurope
https://northeurope.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
Europe westeurope
eu.luis.ai
West Europe
westeurope
https://westeurope.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
Europe westeurope
eu.luis.ai
UK South
uksouth
https://uksouth.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY

Publishing to Australia

To publish to the Australian regions, you create LUIS apps at https://au.luis.ai only. If you attempt to publish anywhere else using a key in the Australian region, LUIS displays a warning message. Instead, use https://au.luis.ai. LUIS apps created at https://au.luis.ai don't automatically migrate to other regions. Export and then import the LUIS app in order to migrate it.

Australia publishing regions

Global region Authoring API region & authoring website Publishing & querying region
API region name
Endpoint URL format
Australia australiaeast
au.luis.ai
Australia East
australiaeast
https://australiaeast.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY

Publishing to other regions

To publish to the other regions, you create LUIS apps at https://www.luis.ai only.

Other publishing regions

Global region Authoring API region & authoring website Publishing & querying region
API region name
Endpoint URL format
Africa westus
www.luis.ai
South Africa North
southafricanorth
https://southafricanorth.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
Asia westus
www.luis.ai
Central India
centralindia
https://centralindia.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
Asia westus
www.luis.ai
East Asia
eastasia
https://eastasia.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
Asia westus
www.luis.ai
Japan East
japaneast
https://japaneast.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
Asia westus
www.luis.ai
Japan West
japanwest
https://japanwest.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
Asia westus
www.luis.ai
Korea Central
koreacentral
https://koreacentral.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
Asia westus
www.luis.ai
Southeast Asia
southeastasia
https://southeastasia.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
North America westus
www.luis.ai
Canada Central
canadacentral
https://canadacentral.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
North America westus
www.luis.ai
Central US
centralus
https://centralus.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
North America westus
www.luis.ai
East US
eastus
https://eastus.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
North America westus
www.luis.ai
East US 2
eastus2
https://eastus2.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
North America westus
www.luis.ai
North Central US
northcentralus
https://northcentralus.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
North America westus
www.luis.ai
South Central US
southcentralus
https://southcentralus.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
North America westus
www.luis.ai
West Central US
westcentralus
https://westcentralus.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
North America westus
www.luis.ai
West US
westus
https://westus.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
North America westus
www.luis.ai
West US 2
westus2
https://westus2.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY
South America westus
www.luis.ai
Brazil South
brazilsouth
https://brazilsouth.api.cognitive.microsoft.com/luis/v2.0/apps/YOUR-APP-ID?subscription-key=YOUR-SUBSCRIPTION-KEY

Endpoints

LUIS currently has 2 endpoints: one for authoring and one for query prediction analysis.

Purpose URL
Authoring https://{region}.api.cognitive.microsoft.com/luis/api/v2.0/apps/{appID}/
Text analysis (query prediction) https://{region}.api.cognitive.microsoft.com/luis/v2.0/apps/{appId}?q={q}[&timezoneOffset][&verbose][&spellCheck][&staging][&bing-spell-check-subscription-key][&log]

The following table explains the parameters, denoted with curly braces {}, in the previous table.

Parameter Purpose
region Azure region - authoring and publishing have different regions
appID LUIS app ID used in URL route and found on app dashboard
q utterance text sent from client application such as chat bot

Failover regions

Each region has a secondary region to fail over to. Europe fails over inside Europe and Australia fails over inside Australia.

Authoring regions have paired fail-over regions.

Next steps