Standardize tool project connection fields

Vishwanath Balaji · Copilot · Vishwanath Balaji · commit d69f1c4bb750 · 2026-06-18T11:20:38.000-07:00
Co-authored-by: Copilot &lt;223556219+Copilot@users.noreply.github.com&gt;
diff --git a/specification/ai-foundry/data-plane/Foundry/openapi3/v1/microsoft-foundry-openapi3.json b/specification/ai-foundry/data-plane/Foundry/openapi3/v1/microsoft-foundry-openapi3.json
@@ -14969,7 +14969,7 @@
           },
           "project_connection_id": {
             "type": "string",
-            "description": "The connection ID in the project for the A2A server.\nThe connection stores authentication and other connection details needed to connect to the A2A server."
+            "description": "The project connection ID used by this tool."
           }
         },
         "allOf": [
@@ -15003,7 +15003,7 @@
           },
           "project_connection_id": {
             "type": "string",
-            "description": "The connection ID in the project for the A2A server.\nThe connection stores authentication and other connection details needed to connect to the A2A server."
+            "description": "The project connection ID used by this tool."
           }
         },
         "allOf": [
@@ -22594,7 +22594,7 @@
           },
           "project_connection_id": {
             "type": "string",
-            "description": "The ID of the FabricIQ project connection."
+            "description": "The project connection ID used by this tool."
           },
           "server_label": {
             "type": "string",
@@ -22656,7 +22656,7 @@
           },
           "project_connection_id": {
             "type": "string",
-            "description": "The ID of the FabricIQ project connection."
+            "description": "The project connection ID used by this tool."
           },
           "server_label": {
             "type": "string",
@@ -24108,7 +24108,7 @@
           },
           "project_connection_id": {
             "type": "string",
-            "description": "The connection ID in the project for the MCP server. The connection stores authentication and other connection details needed to connect to the MCP server."
+            "description": "The project connection ID used by this tool."
           }
         },
         "allOf": [
@@ -38472,7 +38472,7 @@
           },
           "project_connection_id": {
             "type": "string",
-            "description": "The connection ID in the project for the MCP server. The connection stores authentication and other connection details needed to connect to the MCP server."
+            "description": "The project connection ID used by this tool."
           }
         },
         "allOf": [
@@ -49688,7 +49688,7 @@
           },
           "project_connection_id": {
             "type": "string",
-            "description": "The ID of the WorkIQ project connection."
+            "description": "The project connection ID used by this tool."
           },
           "name": {
             "type": "string",
@@ -49722,7 +49722,7 @@
           },
           "project_connection_id": {
             "type": "string",
-            "description": "The ID of the WorkIQ project connection."
+            "description": "The project connection ID used by this tool."
           }
         },
         "allOf": [
diff --git a/specification/ai-foundry/data-plane/Foundry/openapi3/v1/microsoft-foundry-openapi3.yaml b/specification/ai-foundry/data-plane/Foundry/openapi3/v1/microsoft-foundry-openapi3.yaml
@@ -9966,9 +9966,7 @@ components:
             If not provided, defaults to  `/.well-known/agent-card.json`
         project_connection_id:
           type: string
-          description: |-
-            The connection ID in the project for the A2A server.
-            The connection stores authentication and other connection details needed to connect to the A2A server.
+          description: The project connection ID used by this tool.
       allOf:
         - $ref: '#/components/schemas/OpenAI.Tool'
       description: An agent implementing the A2A protocol.
@@ -9993,9 +9991,7 @@ components:
             If not provided, defaults to  `/.well-known/agent-card.json`
         project_connection_id:
           type: string
-          description: |-
-            The connection ID in the project for the A2A server.
-            The connection stores authentication and other connection details needed to connect to the A2A server.
+          description: The project connection ID used by this tool.
       allOf:
         - $ref: '#/components/schemas/ToolboxTool'
       description: An A2A tool stored in a toolbox.
@@ -15345,7 +15341,7 @@ components:
           description: The object type, which is always 'fabric_iq_preview'.
         project_connection_id:
           type: string
-          description: The ID of the FabricIQ project connection.
+          description: The project connection ID used by this tool.
         server_label:
           type: string
           description: (Optional) The label of the FabricIQ MCP server to connect to.
@@ -15385,7 +15381,7 @@ components:
           description: The type of the tool. Always `fabric_iq_preview`.
         project_connection_id:
           type: string
-          description: The ID of the FabricIQ project connection.
+          description: The project connection ID used by this tool.
         server_label:
           type: string
           description: (Optional) The label of the FabricIQ MCP server to connect to.
@@ -16343,7 +16339,7 @@ components:
           default: always
         project_connection_id:
           type: string
-          description: The connection ID in the project for the MCP server. The connection stores authentication and other connection details needed to connect to the MCP server.
+          description: The project connection ID used by this tool.
       allOf:
         - $ref: '#/components/schemas/ToolboxTool'
       description: An MCP tool stored in a toolbox.
@@ -26681,7 +26677,7 @@ components:
           default: always
         project_connection_id:
           type: string
-          description: The connection ID in the project for the MCP server. The connection stores authentication and other connection details needed to connect to the MCP server.
+          description: The project connection ID used by this tool.
       allOf:
         - $ref: '#/components/schemas/OpenAI.Tool'
       description: |-
@@ -35016,7 +35012,7 @@ components:
           description: The object type, which is always 'work_iq_preview'.
         project_connection_id:
           type: string
-          description: The ID of the WorkIQ project connection.
+          description: The project connection ID used by this tool.
         name:
           type: string
           description: Optional user-defined name for this tool or configuration.
@@ -35039,7 +35035,7 @@ components:
           description: The type of the tool. Always `work_iq_preview`.
         project_connection_id:
           type: string
-          description: The ID of the WorkIQ project connection.
+          description: The project connection ID used by this tool.
       allOf:
         - $ref: '#/components/schemas/ToolboxTool'
       description: A WorkIQ tool stored in a toolbox.
diff --git a/specification/ai-foundry/data-plane/Foundry/openapi3/virtual-public-preview/microsoft-foundry-openapi3.json b/specification/ai-foundry/data-plane/Foundry/openapi3/virtual-public-preview/microsoft-foundry-openapi3.json
@@ -17546,7 +17546,7 @@
           },
           "project_connection_id": {
             "type": "string",
-            "description": "The connection ID in the project for the A2A server.\nThe connection stores authentication and other connection details needed to connect to the A2A server."
+            "description": "The project connection ID used by this tool."
           }
         },
         "allOf": [
@@ -17580,7 +17580,7 @@
           },
           "project_connection_id": {
             "type": "string",
-            "description": "The connection ID in the project for the A2A server.\nThe connection stores authentication and other connection details needed to connect to the A2A server."
+            "description": "The project connection ID used by this tool."
           }
         },
         "allOf": [
@@ -26690,7 +26690,7 @@
           },
           "project_connection_id": {
             "type": "string",
-            "description": "The ID of the FabricIQ project connection."
+            "description": "The project connection ID used by this tool."
           },
           "server_label": {
             "type": "string",
@@ -26752,7 +26752,7 @@
           },
           "project_connection_id": {
             "type": "string",
-            "description": "The ID of the FabricIQ project connection."
+            "description": "The project connection ID used by this tool."
           },
           "server_label": {
             "type": "string",
@@ -28277,7 +28277,7 @@
           },
           "project_connection_id": {
             "type": "string",
-            "description": "The connection ID in the project for the MCP server. The connection stores authentication and other connection details needed to connect to the MCP server."
+            "description": "The project connection ID used by this tool."
           }
         },
         "allOf": [
@@ -42741,7 +42741,7 @@
           },
           "project_connection_id": {
             "type": "string",
-            "description": "The connection ID in the project for the MCP server. The connection stores authentication and other connection details needed to connect to the MCP server."
+            "description": "The project connection ID used by this tool."
           }
         },
         "allOf": [
@@ -54181,7 +54181,7 @@
           },
           "project_connection_id": {
             "type": "string",
-            "description": "The ID of the WorkIQ project connection."
+            "description": "The project connection ID used by this tool."
           },
           "name": {
             "type": "string",
@@ -54215,7 +54215,7 @@
           },
           "project_connection_id": {
             "type": "string",
-            "description": "The ID of the WorkIQ project connection."
+            "description": "The project connection ID used by this tool."
           }
         },
         "allOf": [
diff --git a/specification/ai-foundry/data-plane/Foundry/openapi3/virtual-public-preview/microsoft-foundry-openapi3.yaml b/specification/ai-foundry/data-plane/Foundry/openapi3/virtual-public-preview/microsoft-foundry-openapi3.yaml
@@ -11700,9 +11700,7 @@ components:
             If not provided, defaults to  `/.well-known/agent-card.json`
         project_connection_id:
           type: string
-          description: |-
-            The connection ID in the project for the A2A server.
-            The connection stores authentication and other connection details needed to connect to the A2A server.
+          description: The project connection ID used by this tool.
       allOf:
         - $ref: '#/components/schemas/OpenAI.Tool'
       description: An agent implementing the A2A protocol.
@@ -11727,9 +11725,7 @@ components:
             If not provided, defaults to  `/.well-known/agent-card.json`
         project_connection_id:
           type: string
-          description: |-
-            The connection ID in the project for the A2A server.
-            The connection stores authentication and other connection details needed to connect to the A2A server.
+          description: The project connection ID used by this tool.
       allOf:
         - $ref: '#/components/schemas/ToolboxTool'
       description: An A2A tool stored in a toolbox.
@@ -18132,7 +18128,7 @@ components:
           description: The object type, which is always 'fabric_iq_preview'.
         project_connection_id:
           type: string
-          description: The ID of the FabricIQ project connection.
+          description: The project connection ID used by this tool.
         server_label:
           type: string
           description: (Optional) The label of the FabricIQ MCP server to connect to.
@@ -18172,7 +18168,7 @@ components:
           description: The type of the tool. Always `fabric_iq_preview`.
         project_connection_id:
           type: string
-          description: The ID of the FabricIQ project connection.
+          description: The project connection ID used by this tool.
         server_label:
           type: string
           description: (Optional) The label of the FabricIQ MCP server to connect to.
@@ -19176,7 +19172,7 @@ components:
           default: always
         project_connection_id:
           type: string
-          description: The connection ID in the project for the MCP server. The connection stores authentication and other connection details needed to connect to the MCP server.
+          description: The project connection ID used by this tool.
       allOf:
         - $ref: '#/components/schemas/ToolboxTool'
       description: An MCP tool stored in a toolbox.
@@ -29584,7 +29580,7 @@ components:
           default: always
         project_connection_id:
           type: string
-          description: The connection ID in the project for the MCP server. The connection stores authentication and other connection details needed to connect to the MCP server.
+          description: The project connection ID used by this tool.
       allOf:
         - $ref: '#/components/schemas/OpenAI.Tool'
       description: |-
@@ -38072,7 +38068,7 @@ components:
           description: The object type, which is always 'work_iq_preview'.
         project_connection_id:
           type: string
-          description: The ID of the WorkIQ project connection.
+          description: The project connection ID used by this tool.
         name:
           type: string
           description: Optional user-defined name for this tool or configuration.
@@ -38095,7 +38091,7 @@ components:
           description: The type of the tool. Always `work_iq_preview`.
         project_connection_id:
           type: string
-          description: The ID of the WorkIQ project connection.
+          description: The project connection ID used by this tool.
       allOf:
         - $ref: '#/components/schemas/ToolboxTool'
       description: A WorkIQ tool stored in a toolbox.
diff --git a/specification/ai-foundry/data-plane/Foundry/src/tools/models.tsp b/specification/ai-foundry/data-plane/Foundry/src/tools/models.tsp
@@ -46,7 +46,7 @@ namespace Azure.AI.Projects {
   #suppress "@azure-tools/typespec-azure-core/experimental-feature" "Using experimental feature"
   @@copyProperties(OpenAI.MCPTool,
     {
-      ...ToolProjectConnectionIdExtension,
+      ...OptionalToolProjectConnectionIdField,
     }
   );
 
@@ -131,13 +131,23 @@ namespace Azure.AI.Projects {
   /**
    * Optional project connection ID for tools that can use project-scoped connections.
    */
-  alias ToolProjectConnectionIdExtension = {
+  alias OptionalToolProjectConnectionIdField = {
     /**
-     * The connection ID in the project for the MCP server. The connection stores authentication and other connection details needed to connect to the MCP server.
+     * The project connection ID used by this tool.
      */
     project_connection_id?: string;
   };
 
+  /**
+   * Required project connection ID for tools that use project-scoped connections.
+   */
+  alias RequiredToolProjectConnectionIdField = {
+    /**
+     * The project connection ID used by this tool.
+     */
+    project_connection_id: string;
+  };
+
   /**
    * The input definition information for a bing grounding search tool as used to configure an agent.
    */
@@ -771,11 +781,7 @@ namespace Azure.AI.Projects {
      */
     agent_card_path?: string;
 
-    /**
-     * The connection ID in the project for the A2A server.
-     * The connection stores authentication and other connection details needed to connect to the A2A server.
-     */
-    project_connection_id?: string;
+    ...OptionalToolProjectConnectionIdField;
   }
 
   /**
@@ -795,10 +801,7 @@ namespace Azure.AI.Projects {
    * Shared fields for WorkIQ tool definitions.
    */
   model WorkIQPreviewToolFields {
-    /**
-     * The ID of the WorkIQ project connection.
-     */
-    project_connection_id: string;
+    ...RequiredToolProjectConnectionIdField;
   }
 
   /**
@@ -818,10 +821,7 @@ namespace Azure.AI.Projects {
    * Shared fields for FabricIQ tool definitions.
    */
   model FabricIQPreviewToolFields {
-    /**
-     * The ID of the FabricIQ project connection.
-     */
-    project_connection_id: string;
+    ...RequiredToolProjectConnectionIdField;
 
     /**
      * (Optional) The label of the FabricIQ MCP server to connect to.
