Merge pull request #7028 from mrbullwinkle/mrb_09_10_2025_ref_content_updates

[Azure OpenAI] [v1] [ref cross links]

Author: v-ccolin

articles/ai-foundry/openai/includes/api-surface.md

@@ -24,9 +24,9 @@ Each API surface/specification encapsulates a different set of Azure OpenAI capa
 
 | API | Latest preview release | Latest GA release | Specifications | Description |
 |:---|:----|:----|:----|:---|
-| **Control plane** | [`2024-06-01-preview`](/rest/api/aiservices/accountmanagement/operation-groups?view=rest-aiservices-accountmanagement-2024-06-01-preview&preserve-view=true) | [`2024-10-01`](/rest/api/aiservices/accountmanagement/deployments/create-or-update?view=rest-aiservices-accountmanagement-2024-10-01&tabs=HTTP&preserve-view=true) | [Spec files](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices) | Azure OpenAI shares a common control plane with all other services. The control plane API is used for things like [creating Azure OpenAI resources](/rest/api/aiservices/accountmanagement/accounts/create?view=rest-aiservices-accountmanagement-2023-05-01&tabs=HTTP&preserve-view=true), [model deployment](/rest/api/aiservices/accountmanagement/deployments/create-or-update?view=rest-aiservices-accountmanagement-2023-05-01&tabs=HTTP&preserve-view=true), and other higher level resource management tasks. The control plane also governs what is possible to do with capabilities like Azure Resource Manager, Bicep, Terraform, and Azure CLI.|
-| **Data plane - authoring** | [`2025-04-01-preview`](/azure/ai-foundry/openai/authoring-reference-preview) | `2024-10-21` | [Spec files](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/cognitiveservices/data-plane/AzureOpenAI/authoring) | The data plane authoring API controls [fine-tuning](/rest/api/azureopenai/fine-tuning?view=rest-azureopenai-2024-08-01-preview&preserve-view=true), [file-upload](/rest/api/azureopenai/files/upload?view=rest-azureopenai-2024-08-01-preview&tabs=HTTP&preserve-view=true), [ingestion jobs](/rest/api/azureopenai/ingestion-jobs/create?view=rest-azureopenai-2024-08-01-preview&tabs=HTTP&preserve-view=true), [batch](/rest/api/azureopenai/batch?view=rest-azureopenai-2024-08-01-preview&tabs=HTTP&preserve-view=true) and certain [model level queries](/rest/api/azureopenai/models/get?view=rest-azureopenai-2024-08-01-preview&tabs=HTTP&preserve-view=true)
-| **Data plane - inference** | [`2025-04-01-preview`](/azure/ai-foundry/openai/reference-preview#data-plane-inference) | [`2024-10-21`](/azure/ai-foundry/openai/reference#data-plane-inference) | [Spec files](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/cognitiveservices/data-plane/AzureOpenAI/inference) | The data plane inference API provides the inference capabilities/endpoints for features like completions, chat completions, embeddings, audio, on your data, Dall-e, assistants, etc. |
+| **Control plane** | `2025-07-01-preview` | [`2025-06-01`](/rest/api/aifoundry/accountmanagement/operation-groups?view=rest-aifoundry-accountmanagement-2025-06-01&preserve-view=true) | [Spec files](https://github.com/Azure/azure-rest-api-specs/blob/main/specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2025-06-01/cognitiveservices.json) | The control plane API is used for operations like [creating resources](/rest/api/aifoundry/accountmanagement/accounts/create?view=rest-aifoundry-accountmanagement-2025-06-01&tabs=HTTP&preserve-view=true), [model deployment](/rest/api/aifoundry/accountmanagement/deployments/create-or-update?view=rest-aifoundry-accountmanagement-2025-06-01&tabs=HTTP&preserve-view=true), and other higher level resource management tasks. The control plane also governs what is possible to do with capabilities like Azure Resource Manager, Bicep, Terraform, and Azure CLI.|
+| **Data plane** | [`v1 preview`](/azure/ai-foundry/openai/reference-preview-latest) | [`v1`](/azure/ai-foundry/openai/latest) | [Spec files](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/ai/data-plane/OpenAI.v1) | The data plane API controls inference and authoring operations.  |
+
 
 ## Authentication
 

articles/ai-foundry/toc-files/sdk-api-reference/toc.yml

@@ -51,38 +51,38 @@ items:
       href: /rest/api/aifoundry/get-image-embeddings/get-image-embeddings
 - name: Azure OpenAI
   items:
-  - name: v1 APIs
+  - name: v1 API
     items:
       - name: v1 API
-        items:
-        - name: v1 API
-          href: ../../openai/latest.md 
-        - name: Chat
-          href: ../../openai/latest.md#create-chat-completion
-        - name: Embeddings
-          href: ../../openai/latest.md#create-embedding   
-        - name: Evals (preview)
-          href: ../../openai/latest.md#list-evals
-        - name: Files
-          href: ../../openai/latest.md#create-file
-        - name: Fine-tuning
-          href: ../../openai/latest.md#create-fine-tuning-job
-        - name: Models
-          href: ../../openai/latest.md#list-models
-        - name: Responses
-          href: ../../openai/latest.md#create-response   
-        - name: Vector stores
-          href: ../../openai/latest.md#list-vector-stores
-      - name: v1 Preview API
-        href: ../../openai/reference-preview-latest.md
-  - name: Pre v1 API
+        href: ../../openai/latest.md 
+      - name: Chat
+        href: ../../openai/latest.md#create-chat-completion
+      - name: Embeddings
+        href: ../../openai/latest.md#create-embedding   
+      - name: Evals (preview)
+        href: ../../openai/latest.md#list-evals
+      - name: Files
+        href: ../../openai/latest.md#create-file
+      - name: Fine-tuning
+        href: ../../openai/latest.md#create-fine-tuning-job
+      - name: Models
+        href: ../../openai/latest.md#list-models
+      - name: Responses
+        href: ../../openai/latest.md#create-response   
+      - name: Vector stores
+        href: ../../openai/latest.md#list-vector-stores
+  - name: Previous versions
     items:
-    - name:  2024-10-21 API reference
-      href: ../../openai/reference.md
-    - name: 2025-04-01-preview - Authoring 
-      href: ../../openai/authoring-reference-preview.md
-    - name: 2025-04-01-preview - Inference 
-      href: ../../openai/reference-preview.md
+       - name:  2024-10-21 API reference
+         href: ../../openai/reference.md
+       - name: Preview APIs
+         items:
+          - name: v1 Preview API
+            href: ../../openai/reference-preview-latest.md
+          - name: 2025-04-01-preview - Authoring 
+            href: ../../openai/authoring-reference-preview.md
+          - name: 2025-04-01-preview - Inference 
+            href: ../../openai/reference-preview.md
   - name: Assistants API Reference
     items:
       - name: REST