Merge pull request #293456 from batamig/patch-62358

SOC optimization - adding links to API version

Author: prmerger-automator[bot]

articles/sentinel/soc-optimization/soc-optimization-api.md

@@ -20,9 +20,9 @@ appliesto:
 
 # Use SOC optimizations programmatically (Preview)
 
-Use the Microsoft Sentinel `recommendations` API to programmatically interact with SOC optimization recommendations, helping you to close coverage gaps against specific threats and tighten ingestion rates. You can get details about all current recommendations across your workspaces or a specific SOC optimization recommendation, or you can reevaluate a recommendation if you've made changes in your environment.
+Use the Microsoft Sentinel *[`recommendations`](/rest/api/securityinsights/get-recommendations/list)* API to programmatically interact with SOC optimization recommendations, helping you to close coverage gaps against specific threats and tighten ingestion rates. You can get details about all current recommendations across your workspaces or a specific SOC optimization recommendation, or you can reevaluate a recommendation if you've made changes in your environment.
 
-For example, use the `recommendations` API to:
+For example, use the *[`recommendations`](/rest/api/securityinsights/get-recommendations/list)* API to:
 
 - Build custom reports and dashboards. For example, see [Visualize custom SOC optimization data](#visualize-custom-soc-optimization-data).
 - Integrate with third-party tools, such as for SOAR and ITSM services
@@ -33,11 +33,11 @@ For customers or MSSPs managing multiple environments, the `recommendations` API
 > [!IMPORTANT]
 > [!INCLUDE [unified-soc-preview-without-alert](../includes/unified-soc-preview-without-alert.md)]
 >
-> The `recommendations` API is in **PREVIEW**. See the [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/) for additional legal terms that apply to Azure features that are in beta, preview, or otherwise not yet released into general availability.
+> The [`recommendations`](/rest/api/securityinsights/get-recommendations/list) API is in **PREVIEW** and uses version *2024-01-01-preview* or later. See the [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/) for additional legal terms that apply to Azure features that are in beta, preview, or otherwise not yet released into general availability.
 
 ## Get, update, or reevaluate recommendations
 
-Use the following examples of the `recommendations` API to interact with SOC optimization recommendations programmatically:
+Use the following examples of the [`recommendations`](/rest/api/securityinsights/get-recommendations/list)` API to interact with SOC optimization recommendations programmatically:
 
 - **Get a list of all current SOC optimization recommendations in your workspace**:
 
@@ -67,7 +67,7 @@ Use the following examples of the `recommendations` API to interact with SOC opt
 
 ## Visualize custom SOC optimization data
 
-The **Microsoft Sentinel Optimization Workbook** uses the `recommendations` API to visualize SOC optimization data. Install and customize the workbook in your workspace to create your own custom SOC optimization dashboard.
+The **Microsoft Sentinel Optimization Workbook** uses the [`recommendations`](/rest/api/securityinsights/get-recommendations/list) API to visualize SOC optimization data. Install and customize the workbook in your workspace to create your own custom SOC optimization dashboard.
 
 In the **Microsoft Sentinel Optimization Workbooks**, select the **SOC Optimization** tab and expand the items under **Details** to drill down into to view SOC optimization data. Edit the workbook to modify the data shown as needed for your organization.
 
@@ -86,4 +86,5 @@ For more information, see:
 
 - [Optimize your security operations](soc-optimization-access.md)
 - [SOC optimization reference of recommendations](soc-optimization-reference.md)
+- [Get Recommendations REST API reference](/rest/api/securityinsights/get-recommendations/list)
 - Blogs: [Introducing the SOC Optimization API](https://aka.ms/SocOptimizationAPI) | [Unlock the power of precision-driven security management](https://aka.ms/SOC_Optimization)