updating CLU rest api

Author: aahill

articles/cognitive-services/language-service/conversational-language-understanding/includes/quickstarts/rest-api.md

@@ -5,7 +5,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: language-service
 ms.topic: include
-ms.date: 06/07/2022
+ms.date: 03/14/2023
 ms.author: aahi
 ms.custom: ignite-fall-2021
 ---
@@ -32,7 +32,7 @@ ms.custom: ignite-fall-2021
 > [!div class="nextstepaction"]
 > <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=REST API&Pillar=Language&Product=Conversational-language-understanding&Page=quickstart&Section=Get-resource-keys-and-endpoint" target="_target">I ran into an issue</a>
 
-## Create a CLU project 
+## Import a new CLU sample project
 
 Once you have a Language resource created, create a conversational language understanding project. A project is a work area for building your custom ML models based on your data. Your project can only be accessed by you and others who have access to the Language resource being used.
 
@@ -41,36 +41,32 @@ For this quickstart, you can download [this sample project](https://go.microsoft
 > [!div class="nextstepaction"]
 > <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=RESTAPI&Pillar=Language&Product=Conversational-language-understanding&Page=quickstart&Section=Create-a-conversational-language-understanding-project" target="_target">I ran into an issue</a>
 
-### Trigger import project job 
+### Trigger the import project job 
 
 [!INCLUDE [create and import project](../rest-api/import-project.md)]
 
 > [!div class="nextstepaction"]
 > <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=REST API&Pillar=Language&Product=Conversational-language-understanding&Page=quickstart&Section=Trigger-import-project-job" target="_target">I ran into an issue</a>
 
-### Get import job Status
+### Get the import job status
 
 [!INCLUDE [get import project status](../rest-api/get-import-status.md)]
 
 > [!div class="nextstepaction"]
 > <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=REST API&Pillar=Language&Product=Conversational-language-understanding&Page=quickstart&Section=Get-import-job-status" target="_target">I ran into an issue</a>
 
-## Train your model
+## Start training your model
 
 Typically, after you create a project, you should [build schema](../../how-to/build-schema.md) and [tag utterances](../../how-to/tag-utterances.md). For this quickstart, we already imported a ready project with built schema and tagged utterances. 
 
-### Start training your model
-
-After your project has been imported, you can start training your model. 
-
 [!INCLUDE [train model](../rest-api/train-model.md)]
 
 > [!div class="nextstepaction"]
 > <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=REST API&Pillar=Language&Product=Conversational-language-understanding&Page=quickstart&Section=Train-model" target="_target">I ran into an issue</a>
 
-### Get Training Status
+### Get the training job status
 
-Training could take sometime between 10 and 30 minutes. You can use the following request to keep polling the status of the training job until it is successfully completed.
+Training may take time to complete - sometimes between 10 and 30 minutes. You can use the following request to keep polling the status of the training job until it is successfully completed.
 
  [!INCLUDE [get training model status](../rest-api/get-training-status.md)]
 

articles/cognitive-services/language-service/conversational-language-understanding/includes/rest-api/get-deployment-status.md

@@ -9,6 +9,9 @@ ms.date: 05/16/2022
 ms.author: aahi
 ---
 
+> [!NOTE]
+> When you send a successful deployment request, the full request URL for checking the job's status (including your endpoint, project name, and job ID) is contained in the response's `location-location` header. 
+
 Use the following **GET** request to get the status of your deployment job. Replace the placeholder values below with your own values. 
 
 ### Request URL
@@ -22,7 +25,7 @@ Use the following **GET** request to get the status of your deployment job. Repl
 |`{ENDPOINT}`     | The endpoint for authenticating your API request.   | `https://<your-custom-subdomain>.cognitiveservices.azure.com` |
 |`{PROJECT-NAME}`     | The name for your project. This value is case-sensitive.   | `myProject` |
 |`{DEPLOYMENT-NAME}`     | The name for your deployment. This value is case-sensitive.   | `staging` |
-|`{JOB-ID}`     | The ID for locating your model's training status. This is in the `location` header value you received from the API in response to your model deployment request.  | `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx` |
+|`{JOB-ID}`     | The ID for locating your model's training status.  | `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx` |
 |`{API-VERSION}`     | The version of the API you are calling. The value referenced here is for the latest released [model version](../../../concepts/model-lifecycle.md#choose-the-model-version-used-on-your-data).  | `2022-05-01` |
 
 ### Headers

articles/cognitive-services/language-service/conversational-language-understanding/includes/rest-api/get-import-status.md

@@ -11,6 +11,9 @@ ms.author: aahi
 ms.custom: language-service-clu 
 ---
 
+> [!NOTE]
+> When you send a successful project import request, the full request URL for checking the import job's status (including your endpoint, project name, and job ID) is contained in the response's `location-location` header. 
+
 Use the following **GET** request to query the status of your import job. You can use the URL you received from the previous step, or replace the placeholder values below with your own values. 
 
 ```rest
@@ -21,7 +24,7 @@ Use the following **GET** request to query the status of your import job. You ca
 |---------|---------|---------|
 |`{ENDPOINT}`     | The endpoint for authenticating your API request.   | `https://<your-custom-subdomain>.cognitiveservices.azure.com` |
 |`{PROJECT-NAME}`     | The name for your project. This value is case-sensitive.  | `myProject` |
-|`{JOB-ID}`     | The ID for locating your export job status. This is in the `location` header value you received in the previous step.  | `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx` |
+|`{JOB-ID}`     | The ID for locating your import job status.  | `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx` |
 |`{API-VERSION}`     | The version of the API you are calling. The value referenced here is for the latest released [model version](../../../concepts/model-lifecycle.md#choose-the-model-version-used-on-your-data). | `2022-05-01` |
 
 #### Headers

articles/cognitive-services/language-service/conversational-language-understanding/includes/rest-api/get-training-status.md

@@ -9,6 +9,9 @@ ms.date: 05/12/2022
 ms.author: aahi
 ---
 
+> [!NOTE]
+> When you send a successful training request, the full request URL for checking the job's status (including your endpoint, project name, and job ID) is contained in the response's `location-location` header. 
+
 Use the following **GET** request to get the status of your model's training progress. Replace the placeholder values below with your own values. 
 
 ### Request URL
@@ -21,7 +24,7 @@ Use the following **GET** request to get the status of your model's training pro
 |---------|---------|---------|
 |`{YOUR-ENDPOINT}`     | The endpoint for authenticating your API request.   | `https://<your-custom-subdomain>.cognitiveservices.azure.com` |
 |`{PROJECT-NAME}`     | The name for your project. This value is case-sensitive.   | `EmailApp` |
-|`{JOB-ID}`     | The ID for locating your model's training status. This is in the `location` header value you received when submitted your training job.  | `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx` |
+|`{JOB-ID}`     | The ID for locating your model's training status.  | `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx` |
 |`{API-VERSION}`     | The version of the API you are calling. The value referenced here is for the latest version released. Learn more about other available [API versions](../../../concepts/model-lifecycle.md#choose-the-model-version-used-on-your-data)  | `2022-05-01` |
 
 ### Headers

articles/cognitive-services/language-service/conversational-language-understanding/includes/rest-api/import-project.md

@@ -36,7 +36,7 @@ Use the following header to authenticate your request.
 
 ### Body
 
-Use the following sample JSON as your body.
+The JSON body you send will look similar to the below. See the [reference documentation](/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/import?tabs=HTTP#successful-import-project) for more details about the JSON object.
 
 ```json
 {
@@ -101,3 +101,8 @@ Use the following sample JSON as your body.
 | `multilingual` | `true`| A boolean value that enables you to have documents in multiple languages in your dataset. When your model is deployed, you can query the model in any [supported language](../../language-support.md#multi-lingual-option). This includes languages that aren't included in your training documents.  | `true`|
 | `dataset` | `{DATASET}` |  See [how to train a model](../../how-to/tag-utterances.md) for information on splitting your data between a testing and training set. Possible values for this field are `Train` and `Test`.      |`Train`|
 
+Upon a successful request, the API response will contain an `operation-location` header with a URL you can use to check the status of the import job. It will be formatted like this: 
+
+```http
+{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/import/jobs/{JOB-ID}?api-version={API-VERSION}
+``` 

articles/cognitive-services/language-service/conversational-language-understanding/includes/rest-api/train-model.md

@@ -67,4 +67,5 @@ Once you send your API request, you will receive a `202` response indicating suc
 ```rest
 {ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/train/jobs/{JOB-ID}?api-version={API-VERSION}
 ``` 
+
 You can use this URL to get the training job status.

articles/cognitive-services/language-service/conversational-language-understanding/quickstart.md

@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: language-service
 ms.topic: quickstart
-ms.date: 02/28/2023
+ms.date: 03/14/2023
 ms.author: aahi
 ms.custom: language-service-clu, ignite-fall-2021, mode-other
 zone_pivot_groups: usage-custom-language-features