Merge branch 'paulhsu/CU-rest2' into paul-4952-rest-custom

Author: laujan

articles/ai-services/content-understanding/quickstart/use-rest-api.md

@@ -41,15 +41,8 @@ Analyzers define how your content is processed and the insights that are extract
 This quickstart uses prebuilt document, image, audio, and video analyzers to help you get started.
 
 ### Send file for analysis
-#### POST request
 
-```bash
-curl -i -X POST "{endpoint}/analyzers/{analyzerId}:analyze?api-version=2025-05-01-preview" \
-  -H "Ocp-Apim-Subscription-Key: {key}" \
-  -H "Content-Type: application/json" \
-  -d "{\"url\":\"{fileUrl}\"}"
-```
-Before running the cURL command, make the following changes to the HTTP request:
+Before running the cURL command below, make the following changes to the HTTP request:
 # [Document](#tab/document)
 
 1. Replace `{endpoint}` and `{key}` with the corresponding values from your Azure AI Services instance in the Azure portal.
@@ -75,12 +68,21 @@ Before running the cURL command, make the following changes to the HTTP request:
 3. Replace `{fileUrl}` with a publicly accessible URL of the file to analyze—such as a path to an Azure Storage Blob with a shared access signature (SAS), or use the sample URL: `https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/FlightSimulator.mp4`.
 ---
 
+#### POST request
+
+```bash
+curl -i -X POST "{endpoint}/contentunderstanding/analyzers/{analyzerId}:analyze?api-version=2025-05-01-preview" \
+  -H "Ocp-Apim-Subscription-Key: {key}" \
+  -H "Content-Type: application/json" \
+  -d "{\"url\":\"{fileUrl}\"}"
+```
 
 #### POST response
-
-The response returns `resultId` that you can use to track the status of this asynchronous analyze operation.
+The response includes a JSON body containing the `resultId`, which you use to retrieve the results of the asynchronous analysis operation. Additionally, the `Operation-Location` header provides the direct URL to access the analysis result.
 
 ```
+202 Accepted
+Operation-Location: {endpoint}/contentunderstanding/analyzerResults/{resultId}?api-version=2024-12-01-preview
 {
   "id": {resultId},
   "status": "Running",
@@ -109,7 +111,7 @@ curl -i -X GET "{endpoint}/contentunderstanding/analyzerResults/{resultId}?api-v
 
 #### GET response
 
-The 200 (`OK`) JSON response includes a `status` field indicating the status of the operation. If the operation isn't complete, the value of `status` is `running` or `notStarted`. In such cases, you should send the `GET` request again, either manually or through a script. Wait an interval of one second or more between calls.
+The 200 (`OK`) JSON response includes a `status` field indicating the status of the operation. If the operation isn't complete, the value of `status` is `Running` or `NotStarted`. In such cases, you should send the `GET` request again, either manually or through a script. Wait an interval of one second or more between calls.
 
 # [Document](#tab/document)
 
@@ -350,6 +352,6 @@ The 200 (`OK`) JSON response includes a `status` field indicating the status of
 
 ## Next steps
 
-Learn to [create a custom analyzer](../concepts/analyzers-overview.md) to better fit your use case.
+* Learn to [create a custom analyzer](../tutorial/create-custom-analyzer.md) to better fit your use case.
 
 

articles/ai-services/content-understanding/tutorial/create-custom-analyzer.md

@@ -1,5 +1,5 @@
 ---
-title: Create a custom analyzer with Azure AI Content Understanding
+title: Create a custom analyzer with Azure AI Content Understanding using REST APIs
 titleSuffix: Azure AI services
 description: Learn to create a custom analyzer with Azure AI Content Understanding
 author: laujan
@@ -10,7 +10,7 @@ ms.topic: overview
 ms.date: 05/19/2025
 ---
 
-# Create a custom analyzer
+# Create a custom analyzer via REST APIs
 
 Content Understanding analyzers define how to process and extract insights from your content. They ensure uniform processing and output structure across all your content to deliver reliable and predictable results. We offer [prebuilt analyzers](../concepts/prebuilt-analyzers.md) for common use cases. This guide shows how these analyzers can be customized to better fit your needs.
 
@@ -587,3 +587,9 @@ A `200 OK` response includes a `status` field that shows the operation's progres
   }
 }
 ```
+
+## Next steps
+
+* Review code samples: [**visual document search**](https://github.com/Azure-Samples/azure-ai-search-with-content-understanding-python/blob/main/notebooks/search_with_visual_document.ipynb).
+* Review code sample: [**analyzer templates**](https://github.com/Azure-Samples/azure-ai-content-understanding-python/tree/main/analyzer_templates).
+* Try processing your document content using Content Understanding in [Azure AI Foundry](https://aka.ms/cu-landing).