Foundry data-plane: add draft flag to Agent versions

specification/ai-foundry/data-plane/Foundry/openapi3/v1/microsoft-foundry-openapi3.json

@@ -2727,6 +2727,17 @@
             },
             "explode": false
           },
+          {
+            "name": "include_drafts",
+            "in": "query",
+            "required": false,
+            "description": "(Preview) Whether to include draft versions in the listing. The service defaults to `false` if a value is not specified by the caller (only non-draft versions are returned).",
+            "schema": {
+              "type": "boolean",
+              "default": false
+            },
+            "explode": false
+          },
           {
             "name": "api-version",
             "in": "query",
@@ -17852,6 +17863,11 @@
           "definition": {
             "$ref": "#/components/schemas/AgentDefinition"
           },
+          "draft": {
+            "type": "boolean",
+            "description": "Whether this agent version is a draft (candidate) rather than a release. Draft versions are recorded but excluded from default 'latest' resolution and are not auto-promoted. Defaults to false.",
+            "default": false
+          },
           "status": {
             "allOf": [
               {
@@ -20635,6 +20651,11 @@
             ],
             "description": "The blueprint reference for the agent."
           },
+          "draft": {
+            "type": "boolean",
+            "description": "(Preview) Whether this agent version is a draft (candidate) rather than a release. The service defaults to `false` if a value is not specified by the caller. Draft versions are recorded but excluded from default 'latest' resolution and are not auto-promoted.",
+            "default": false
+          },
           "agent_endpoint": {
             "allOf": [
               {
@@ -20801,6 +20822,11 @@
               }
             ],
             "description": "The blueprint reference for the agent."
+          },
+          "draft": {
+            "type": "boolean",
+            "description": "(Preview) Whether this agent version is a draft (candidate) rather than a release. The service defaults to `false` if a value is not specified by the caller. Draft versions are recorded but excluded from default 'latest' resolution and are not auto-promoted.",
+            "default": false
           }
         },
         "x-ms-foundry-meta": {

specification/ai-foundry/data-plane/Foundry/openapi3/v1/microsoft-foundry-openapi3.yaml

@@ -1863,6 +1863,14 @@ paths:
           schema:
             type: string
           explode: false
+        - name: include_drafts
+          in: query
+          required: false
+          description: (Preview) Whether to include draft versions in the listing. The service defaults to `false` if a value is not specified by the caller (only non-draft versions are returned).
+          schema:
+            type: boolean
+            default: false
+          explode: false
         - name: api-version
           in: query
           required: true
@@ -11760,6 +11768,10 @@ components:
           description: The Unix timestamp (seconds) when the agent was created.
         definition:
           $ref: '#/components/schemas/AgentDefinition'
+        draft:
+          type: boolean
+          description: Whether this agent version is a draft (candidate) rather than a release. Draft versions are recorded but excluded from default 'latest' resolution and are not auto-promoted. Defaults to false.
+          default: false
         status:
           allOf:
             - $ref: '#/components/schemas/AgentVersionStatus'
@@ -13618,6 +13630,10 @@ components:
           allOf:
             - $ref: '#/components/schemas/AgentBlueprintReference'
           description: The blueprint reference for the agent.
+        draft:
+          type: boolean
+          description: (Preview) Whether this agent version is a draft (candidate) rather than a release. The service defaults to `false` if a value is not specified by the caller. Draft versions are recorded but excluded from default 'latest' resolution and are not auto-promoted.
+          default: false
         agent_endpoint:
           allOf:
             - $ref: '#/components/schemas/AgentEndpointConfig'
@@ -13747,6 +13763,10 @@ components:
           allOf:
             - $ref: '#/components/schemas/AgentBlueprintReference'
           description: The blueprint reference for the agent.
+        draft:
+          type: boolean
+          description: (Preview) Whether this agent version is a draft (candidate) rather than a release. The service defaults to `false` if a value is not specified by the caller. Draft versions are recorded but excluded from default 'latest' resolution and are not auto-promoted.
+          default: false
       x-ms-foundry-meta:
         conditional_previews:
           - WorkflowAgents=V1Preview

specification/ai-foundry/data-plane/Foundry/openapi3/virtual-public-preview/microsoft-foundry-openapi3.json

@@ -3091,6 +3091,17 @@
             },
             "explode": false
           },
+          {
+            "name": "include_drafts",
+            "in": "query",
+            "required": false,
+            "description": "(Preview) Whether to include draft versions in the listing. The service defaults to `false` if a value is not specified by the caller (only non-draft versions are returned).",
+            "schema": {
+              "type": "boolean",
+              "default": false
+            },
+            "explode": false
+          },
           {
             "name": "api-version",
             "in": "query",
@@ -21241,6 +21252,11 @@
           "definition": {
             "$ref": "#/components/schemas/AgentDefinition"
           },
+          "draft": {
+            "type": "boolean",
+            "description": "Whether this agent version is a draft (candidate) rather than a release. Draft versions are recorded but excluded from default 'latest' resolution and are not auto-promoted. Defaults to false.",
+            "default": false
+          },
           "status": {
             "allOf": [
               {
@@ -24205,6 +24221,11 @@
             ],
             "description": "The blueprint reference for the agent."
           },
+          "draft": {
+            "type": "boolean",
+            "description": "(Preview) Whether this agent version is a draft (candidate) rather than a release. The service defaults to `false` if a value is not specified by the caller. Draft versions are recorded but excluded from default 'latest' resolution and are not auto-promoted.",
+            "default": false
+          },
           "agent_endpoint": {
             "allOf": [
               {
@@ -24371,6 +24392,11 @@
               }
             ],
             "description": "The blueprint reference for the agent."
+          },
+          "draft": {
+            "type": "boolean",
+            "description": "(Preview) Whether this agent version is a draft (candidate) rather than a release. The service defaults to `false` if a value is not specified by the caller. Draft versions are recorded but excluded from default 'latest' resolution and are not auto-promoted.",
+            "default": false
           }
         },
         "x-ms-foundry-meta": {

specification/ai-foundry/data-plane/Foundry/openapi3/virtual-public-preview/microsoft-foundry-openapi3.yaml

@@ -2119,6 +2119,14 @@ paths:
           schema:
             type: string
           explode: false
+        - name: include_drafts
+          in: query
+          required: false
+          description: (Preview) Whether to include draft versions in the listing. The service defaults to `false` if a value is not specified by the caller (only non-draft versions are returned).
+          schema:
+            type: boolean
+            default: false
+          explode: false
         - name: api-version
           in: query
           required: true
@@ -14028,6 +14036,10 @@ components:
           description: The Unix timestamp (seconds) when the agent was created.
         definition:
           $ref: '#/components/schemas/AgentDefinition'
+        draft:
+          type: boolean
+          description: Whether this agent version is a draft (candidate) rather than a release. Draft versions are recorded but excluded from default 'latest' resolution and are not auto-promoted. Defaults to false.
+          default: false
         status:
           allOf:
             - $ref: '#/components/schemas/AgentVersionStatus'
@@ -16008,6 +16020,10 @@ components:
           allOf:
             - $ref: '#/components/schemas/AgentBlueprintReference'
           description: The blueprint reference for the agent.
+        draft:
+          type: boolean
+          description: (Preview) Whether this agent version is a draft (candidate) rather than a release. The service defaults to `false` if a value is not specified by the caller. Draft versions are recorded but excluded from default 'latest' resolution and are not auto-promoted.
+          default: false
         agent_endpoint:
           allOf:
             - $ref: '#/components/schemas/AgentEndpointConfig'
@@ -16137,6 +16153,10 @@ components:
           allOf:
             - $ref: '#/components/schemas/AgentBlueprintReference'
           description: The blueprint reference for the agent.
+        draft:
+          type: boolean
+          description: (Preview) Whether this agent version is a draft (candidate) rather than a release. The service defaults to `false` if a value is not specified by the caller. Draft versions are recorded but excluded from default 'latest' resolution and are not auto-promoted.
+          default: false
       x-ms-foundry-meta:
         conditional_previews:
           - WorkflowAgents=V1Preview

specification/ai-foundry/data-plane/Foundry/src/agents/models.tsp

@@ -28,6 +28,9 @@ model CreateAgentVersionRequest {
 
   @doc("The blueprint reference for the agent.")
   blueprint_reference?: AgentBlueprintReference;
+
+  @doc("(Preview) Whether this agent version is a draft (candidate) rather than a release. The service defaults to `false` if a value is not specified by the caller. Draft versions are recorded but excluded from default 'latest' resolution and are not auto-promoted.")
+  draft?: boolean = false;
 }
 
 model CreateAgentVersionFromManifestRequest {
@@ -85,7 +88,7 @@ model CreateAgentRequest {
 }
 
 model UpdateAgentRequest {
-  ...CreateAgentVersionRequest;
+  ...OmitProperties<CreateAgentVersionRequest, "draft">;
 }
 
 model PatchAgentRequest {
@@ -178,6 +181,9 @@ model AgentVersionObject {
 
   definition: AgentDefinition;
 
+  @doc("Whether this agent version is a draft (candidate) rather than a release. Draft versions are recorded but excluded from default 'latest' resolution and are not auto-promoted. Defaults to false.")
+  draft?: boolean = false;
+
   @doc("The provisioning status of the agent version. Defaults to 'active' for non-hosted agents. For hosted agents, reflects infrastructure readiness.")
   status?: AgentVersionStatus;
 

specification/ai-foundry/data-plane/Foundry/src/agents/routes.tsp

@@ -310,6 +310,9 @@ interface Agents {
       @path agent_name: string;
 
       ...CommonPageQueryParameters;
+
+      /** (Preview) Whether to include draft versions in the listing. The service defaults to `false` if a value is not specified by the caller (only non-draft versions are returned). */
+      @query include_drafts?: boolean = false;
     },
     AgentsPagedResult<AgentVersionObject>
   >;