Add CognitiveServices stable API version 2026-03-01 by fmabroukmsft · Pull Request #41880 · Azure/azure-rest-api-specs

fmabroukmsft · 2026-03-29T11:00:16Z

ARM (Control Plane) API Specification Update Pull Request

Tip

Overwhelmed by all this guidance? See the Getting help section at the bottom of this PR description.

PR review workflow diagram

Please understand this diagram before proceeding. It explains how to get your PR approved & merged.

Purpose of this PR

What's the purpose of this PR? Check the specific option that applies. This is mandatory!

New resource provider.
New API version for an existing resource provider. (If API spec is not defined in TypeSpec, the PR should have been created in adherence to OpenAPI specs PR creation guidance).
Update existing version for a new feature. (This is applicable only when you are revising a private preview API version.)
Update existing version to fix OpenAPI spec quality issues in S360.
Convert existing OpenAPI spec to TypeSpec spec (do not combine this with implementing changes for a new API version).
Other, please clarify:
- edit this with your clarification

Due diligence checklist

To merge this PR, you must go through the following checklist and confirm you understood
and followed the instructions by checking all the boxes:

I confirm this PR is modifying Azure Resource Manager (ARM) related specifications, and not data plane related specifications.
I have reviewed following Resource Provider guidelines, including
ARM resource provider contract and
REST guidelines (estimated time: 4 hours).
I understand this is required before I can proceed to the diagram Step 2, "ARM API changes review", for this PR.
A release plan has been created. If not, please create one as it will help guide you through the REST API and SDK creation process.

Additional information

Viewing API changes

For convenient view of the API changes made by this PR, refer to the URLs provided in the table
in the Generated ApiView comment added to this PR. You can use ApiView to show API versions diff.

Suppressing failures

If one or multiple validation error/warning suppression(s) is detected in your PR, please follow the
suppressions guide to get approval.

Getting help

First, please carefully read through this PR description, from top to bottom. Please fill out the Purpose of this PR and Due diligence checklist.
If you don't have permissions to remove or add labels to the PR, request write access per aka.ms/azsdk/access#request-access-to-rest-api-or-sdk-repositories
To understand what you must do next to merge this PR, see the Next Steps to Merge comment. It will appear within few minutes of submitting this PR and will continue to be up-to-date with current PR state.
For guidance on fixing this PR CI check failures, see the hyperlinks provided in given failure
and https://aka.ms/ci-fix.
For help with ARM review (PR workflow diagram Step 2), see https://aka.ms/azsdk/pr-arm-review.
If the PR CI checks appear to be stuck in queued state, please add a comment with contents /azp run.
This should result in a new comment denoting a PR validation pipeline has started and the checks should be updated after few minutes.
If the help provided by the previous points is not enough, post to https://aka.ms/azsdk/support/specreview-channel and link to this PR.
For guidance on SDK breaking change review, refer to https://aka.ms/ci-fix.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

github-actions · 2026-03-29T11:00:42Z

Next Steps to Merge

✅ All automated merging requirements have been met! To get your PR merged, see aka.ms/azsdk/specreview/merge.

Comment generated by summarize-checks workflow run.

ravimeda · 2026-03-30T23:50:14Z

Please address the 'Required' checks that are failing.

Copilot

Pull request overview

Adds a new stable CognitiveServices ARM API version 2026-03-01 by introducing the corresponding example payloads for the management-plane operations.

Changes:

Added ARM swagger x-ms-examples JSON files under stable/2026-03-01 for the RP.
Added mirrored CognitiveServices.Management example files for 2026-03-01.
Introduced examples for new/expanded resource areas (projects, connections, managed network, quota tiers, RAI resources, agent apps/deployments).

Reviewed changes

Copilot reviewed 299 out of 319 changed files in this pull request and generated 10 comments.

Show a summary per file

File	Description
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/PurgeDeletedAccount.json	Adds 2026-03-01 example for purging a deleted account.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ProjectConnection/get.json	Adds 2026-03-01 example for getting a project connection.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ProjectConnection/delete.json	Adds 2026-03-01 example for deleting a project connection.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ProjectConnection/create.json	Adds 2026-03-01 example for creating a project connection.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ProjectCapabilityHost/list.json	Adds 2026-03-01 example for listing project capability hosts.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ProjectCapabilityHost/get.json	Adds 2026-03-01 example for getting a project capability host.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ProjectCapabilityHost/delete.json	Adds 2026-03-01 example for deleting a project capability host.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/PauseDeployment.json	Adds 2026-03-01 example for pausing a deployment.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ManagedNetwork/provisionManagedNetwork.json	Adds 2026-03-01 example for provisioning a managed network.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ManagedNetwork/getRuleV2.json	Adds 2026-03-01 example for getting an outbound rule.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ManagedNetwork/deleteRuleV2.json	Adds 2026-03-01 example for deleting an outbound rule (LRO).
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ListUsagesGlobalScope.json	Adds 2026-03-01 example for listing usages (global scope).
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ListUsagesDataZoneScope.json	Adds 2026-03-01 example for listing usages (data zone scope).
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ListUsagesClassicScope.json	Adds 2026-03-01 example for listing usages (classic scope).
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ListUsages.json	Adds 2026-03-01 example for listing usages.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ListSkus.json	Adds 2026-03-01 example for listing account SKUs.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ListSharedCommitmentPlansBySubscription.json	Adds 2026-03-01 example for listing shared commitment plans by subscription.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ListSharedCommitmentPlansByResourceGroup.json	Adds 2026-03-01 example for listing shared commitment plans by resource group.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ListSharedCommitmentPlanAssociations.json	Adds 2026-03-01 example for listing shared commitment plan associations.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ListRaiTopics.json	Adds 2026-03-01 example for listing RAI topics.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ListQuotaTiers.json	Adds 2026-03-01 example for listing quota tiers.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ListPrivateLinkResources.json	Adds 2026-03-01 example for listing private link resources.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ListPrivateEndpointConnections.json	Adds 2026-03-01 example for listing private endpoint connections.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ListModelCapacitiesGlobalScope.json	Adds 2026-03-01 example for listing model capacities (global scope).
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ListModelCapacitiesDataZoneScope.json	Adds 2026-03-01 example for listing model capacities (data zone scope).
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ListModelCapacitiesClassicScope.json	Adds 2026-03-01 example for listing model capacities (classic scope).
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ListModelCapacities.json	Adds 2026-03-01 example for listing model capacities.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ListLocationBasedModelCapacitiesGlobalScope.json	Adds 2026-03-01 example for listing location-based model capacities (global scope).
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ListLocationBasedModelCapacitiesDataZoneScope.json	Adds 2026-03-01 example for listing location-based model capacities (data zone scope).
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ListLocationBasedModelCapacitiesClassicScope.json	Adds 2026-03-01 example for listing location-based model capacities (classic scope).
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ListLocationBasedModelCapacities.json	Adds 2026-03-01 example for listing location-based model capacities.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ListKeys.json	Adds 2026-03-01 example for listing account keys.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ListDeployments.json	Adds 2026-03-01 example for listing deployments.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ListDeploymentSkus.json	Adds 2026-03-01 example for listing deployment SKUs.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ListCommitmentTiers.json	Adds 2026-03-01 example for listing commitment tiers.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ListCommitmentPlans.json	Adds 2026-03-01 example for listing commitment plans.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/ListBlocklists.json	Adds 2026-03-01 example for listing RAI blocklists.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/GetUsagesGlobalScope.json	Adds 2026-03-01 example for account usages (global scope).
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/GetUsagesDataZoneScope.json	Adds 2026-03-01 example for account usages (data zone scope).
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/GetUsagesClassicScope.json	Adds 2026-03-01 example for account usages (classic scope).
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/GetUsages.json	Adds 2026-03-01 example for account usages.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/GetSharedCommitmentPlanAssociation.json	Adds 2026-03-01 example for getting a shared commitment plan association.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/GetSharedCommitmentPlan.json	Adds 2026-03-01 example for getting a shared commitment plan.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/GetRaiTopic.json	Adds 2026-03-01 example for getting an RAI topic.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/GetRaiExternalSafetyProvider.json	Adds 2026-03-01 example for getting an external safety provider.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/GetRaiContentFilter.json	Adds 2026-03-01 example for getting an RAI content filter.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/GetRaiBlocklistItem.json	Adds 2026-03-01 example for getting an RAI blocklist item.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/GetRaiBlocklist.json	Adds 2026-03-01 example for getting an RAI blocklist.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/GetQuotaTier.json	Adds 2026-03-01 example for getting a quota tier.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/GetPrivateEndpointConnection.json	Adds 2026-03-01 example for getting a private endpoint connection.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/GetOperations.json	Adds 2026-03-01 example for listing provider operations.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/GetDeployment.json	Adds 2026-03-01 example for getting a deployment.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/GetDeletedAccount.json	Adds 2026-03-01 example for getting a deleted account.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/GetDefenderForAISetting.json	Adds 2026-03-01 example for getting DefenderForAI setting.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/GetCommitmentPlan.json	Adds 2026-03-01 example for getting a commitment plan.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/GetAccount.json	Adds 2026-03-01 example for getting an account.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/DeleteSubscriptionRaiPolicy.json	Adds 2026-03-01 example for deleting a subscription RAI policy (LRO).
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/DeleteSharedCommitmentPlanAssociation.json	Adds 2026-03-01 example for deleting a shared commitment plan association (LRO).
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/DeleteSharedCommitmentPlan.json	Adds 2026-03-01 example for deleting a shared commitment plan (LRO).
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/DeleteRaiTopic.json	Adds 2026-03-01 example for deleting an RAI topic (LRO).
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/DeleteRaiToolLabel.json	Adds 2026-03-01 example for deleting an RAI tool label (LRO).
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/DeleteRaiPolicy.json	Adds 2026-03-01 example for deleting an RAI policy (LRO).
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/DeleteRaiExternalSafetyProvider.json	Adds 2026-03-01 example for deleting an external safety provider (LRO).
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/DeleteRaiBlocklistItems.json	Adds 2026-03-01 example for batch-deleting RAI blocklist items.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/DeleteRaiBlocklistItem.json	Adds 2026-03-01 example for deleting an RAI blocklist item (LRO).
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/DeleteRaiBlocklist.json	Adds 2026-03-01 example for deleting an RAI blocklist (LRO).
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/DeleteProject.json	Adds 2026-03-01 example for deleting a project (LRO).
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/DeletePrivateEndpointConnection.json	Adds 2026-03-01 example for deleting a private endpoint connection (LRO).
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/DeleteEncryptionScope.json	Adds 2026-03-01 example for deleting an encryption scope (LRO).
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/DeleteDeployment.json	Adds 2026-03-01 example for deleting a deployment (LRO).
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/DeleteCommitmentPlan.json	Adds 2026-03-01 example for deleting a commitment plan (LRO).
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/DeleteAccount.json	Adds 2026-03-01 example for deleting an account (LRO).
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/CheckSkuAvailability.json	Adds 2026-03-01 example for checking SKU availability.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/CheckDomainAvailability.json	Adds 2026-03-01 example for checking domain availability.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/AgentDeployment/stop.json	Adds 2026-03-01 example for stopping an agent deployment.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/AgentDeployment/start.json	Adds 2026-03-01 example for starting an agent deployment.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/AgentDeployment/delete.json	Adds 2026-03-01 example for deleting an agent deployment (LRO).
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/AgentApplication/enable.json	Adds 2026-03-01 example for enabling an agent application.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/AgentApplication/disable.json	Adds 2026-03-01 example for disabling an agent application.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/AgentApplication/delete.json	Adds 2026-03-01 example for deleting an agent application (LRO).
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/AddRaiBlocklistItems.json	Adds 2026-03-01 example for batch-adding RAI blocklist items.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/AccountConnection/get.json	Adds 2026-03-01 example for getting an account connection.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/AccountConnection/delete.json	Adds 2026-03-01 example for deleting an account connection.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/AccountConnection/create.json	Adds 2026-03-01 example for creating an account connection.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/AccountCapabilityHost/list.json	Adds 2026-03-01 example for listing account capability hosts.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/AccountCapabilityHost/get.json	Adds 2026-03-01 example for getting an account capability host.
specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2026-03-01/examples/AccountCapabilityHost/delete.json	Adds 2026-03-01 example for deleting an account capability host (LRO).
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/UpdateQuotaTier.json	Adds 2026-03-01 management example for updating quota tier.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ResumeDeployment.json	Adds 2026-03-01 management example for resuming a deployment.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/RegenerateKey.json	Adds 2026-03-01 management example for regenerating keys.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/PutRaiBlocklist.json	Adds 2026-03-01 management example for creating/updating a blocklist.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/PurgeDeletedAccount.json	Adds 2026-03-01 management example for purging a deleted account.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ProjectConnection/get.json	Adds 2026-03-01 management example for getting a project connection.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ProjectConnection/delete.json	Adds 2026-03-01 management example for deleting a project connection.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ProjectConnection/create.json	Adds 2026-03-01 management example for creating a project connection.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ProjectCapabilityHost/list.json	Adds 2026-03-01 management example for listing project capability hosts.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ProjectCapabilityHost/get.json	Adds 2026-03-01 management example for getting a project capability host.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ProjectCapabilityHost/delete.json	Adds 2026-03-01 management example for deleting a project capability host.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/PauseDeployment.json	Adds 2026-03-01 management example for pausing a deployment.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ManagedNetwork/provisionManagedNetwork.json	Adds 2026-03-01 management example for provisioning a managed network.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ManagedNetwork/getRuleV2.json	Adds 2026-03-01 management example for getting an outbound rule.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ManagedNetwork/deleteRuleV2.json	Adds 2026-03-01 management example for deleting an outbound rule (LRO).
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ManagedNetwork/deleteManagedNetworkV2.json	Adds 2026-03-01 management example for deleting managed network settings (LRO).
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ListUsagesGlobalScope.json	Adds 2026-03-01 management example for listing usages (global scope).
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ListUsagesDataZoneScope.json	Adds 2026-03-01 management example for listing usages (data zone scope).
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ListUsagesClassicScope.json	Adds 2026-03-01 management example for listing usages (classic scope).
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ListUsages.json	Adds 2026-03-01 management example for listing usages.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ListSkus.json	Adds 2026-03-01 management example for listing account SKUs.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ListSharedCommitmentPlansBySubscription.json	Adds 2026-03-01 management example for listing shared commitment plans by subscription.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ListSharedCommitmentPlansByResourceGroup.json	Adds 2026-03-01 management example for listing shared commitment plans by resource group.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ListSharedCommitmentPlanAssociations.json	Adds 2026-03-01 management example for listing shared commitment plan associations.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ListRaiTopics.json	Adds 2026-03-01 management example for listing RAI topics.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ListRaiToolLabels.json	Adds 2026-03-01 management example for listing RAI tool labels.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ListQuotaTiers.json	Adds 2026-03-01 management example for listing quota tiers.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ListPrivateLinkResources.json	Adds 2026-03-01 management example for listing private link resources.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ListPrivateEndpointConnections.json	Adds 2026-03-01 management example for listing private endpoint connections.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ListModelCapacitiesGlobalScope.json	Adds 2026-03-01 management example for listing model capacities (global scope).
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ListModelCapacitiesDataZoneScope.json	Adds 2026-03-01 management example for listing model capacities (data zone scope).
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ListModelCapacitiesClassicScope.json	Adds 2026-03-01 management example for listing model capacities (classic scope).
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ListModelCapacities.json	Adds 2026-03-01 management example for listing model capacities.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ListLocationBasedModelCapacitiesGlobalScope.json	Adds 2026-03-01 management example for listing location-based model capacities (global scope).
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ListLocationBasedModelCapacitiesDataZoneScope.json	Adds 2026-03-01 management example for listing location-based model capacities (data zone scope).
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ListLocationBasedModelCapacitiesClassicScope.json	Adds 2026-03-01 management example for listing location-based model capacities (classic scope).
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ListLocationBasedModelCapacities.json	Adds 2026-03-01 management example for listing location-based model capacities.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ListKeys.json	Adds 2026-03-01 management example for listing account keys.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ListDeployments.json	Adds 2026-03-01 management example for listing deployments.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ListDeploymentSkus.json	Adds 2026-03-01 management example for listing deployment SKUs.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ListDefenderForAISetting.json	Adds 2026-03-01 management example for listing DefenderForAI settings.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ListCommitmentTiers.json	Adds 2026-03-01 management example for listing commitment tiers.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ListCommitmentPlans.json	Adds 2026-03-01 management example for listing commitment plans.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ListBlocklists.json	Adds 2026-03-01 management example for listing RAI blocklists.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/ListBlocklistItems.json	Adds 2026-03-01 management example for listing RAI blocklist items.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/GetUsagesGlobalScope.json	Adds 2026-03-01 management example for account usages (global scope).
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/GetUsagesDataZoneScope.json	Adds 2026-03-01 management example for account usages (data zone scope).
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/GetUsagesClassicScope.json	Adds 2026-03-01 management example for account usages (classic scope).
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/GetUsages.json	Adds 2026-03-01 management example for account usages.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/GetSharedCommitmentPlanAssociation.json	Adds 2026-03-01 management example for getting a shared commitment plan association.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/GetSharedCommitmentPlan.json	Adds 2026-03-01 management example for getting a shared commitment plan.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/GetRaiTopic.json	Adds 2026-03-01 management example for getting an RAI topic.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/GetRaiExternalSafetyProvider.json	Adds 2026-03-01 management example for getting an external safety provider.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/GetRaiContentFilter.json	Adds 2026-03-01 management example for getting an RAI content filter.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/GetRaiBlocklistItem.json	Adds 2026-03-01 management example for getting an RAI blocklist item.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/GetRaiBlocklist.json	Adds 2026-03-01 management example for getting an RAI blocklist.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/GetQuotaTier.json	Adds 2026-03-01 management example for getting a quota tier.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/GetProject.json	Adds 2026-03-01 management example for getting a project.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/GetPrivateEndpointConnection.json	Adds 2026-03-01 management example for getting a private endpoint connection.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/GetOperations.json	Adds 2026-03-01 management example for listing provider operations.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/GetDeployment.json	Adds 2026-03-01 management example for getting a deployment.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/GetDeletedAccount.json	Adds 2026-03-01 management example for getting a deleted account.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/GetDefenderForAISetting.json	Adds 2026-03-01 management example for getting DefenderForAI setting.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/GetComputeOperationStatus.json	Adds 2026-03-01 management example for compute operation status.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/GetCommitmentPlan.json	Adds 2026-03-01 management example for getting a commitment plan.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/GetAccount.json	Adds 2026-03-01 management example for getting an account.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/DeleteSubscriptionRaiPolicy.json	Adds 2026-03-01 management example for deleting subscription RAI policy (LRO).
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/DeleteSharedCommitmentPlanAssociation.json	Adds 2026-03-01 management example for deleting shared commitment plan association (LRO).
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/DeleteSharedCommitmentPlan.json	Adds 2026-03-01 management example for deleting shared commitment plan (LRO).
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/DeleteRaiTopic.json	Adds 2026-03-01 management example for deleting RAI topic (LRO).
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/DeleteRaiToolLabel.json	Adds 2026-03-01 management example for deleting RAI tool label (LRO).
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/DeleteRaiPolicy.json	Adds 2026-03-01 management example for deleting RAI policy (LRO).
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/DeleteRaiExternalSafetyProvider.json	Adds 2026-03-01 management example for deleting external safety provider (LRO).
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/DeleteRaiBlocklistItems.json	Adds 2026-03-01 management example for batch-deleting RAI blocklist items.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/DeleteRaiBlocklistItem.json	Adds 2026-03-01 management example for deleting RAI blocklist item (LRO).
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/DeleteRaiBlocklist.json	Adds 2026-03-01 management example for deleting RAI blocklist (LRO).
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/DeleteProject.json	Adds 2026-03-01 management example for deleting a project (LRO).
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/DeletePrivateEndpointConnection.json	Adds 2026-03-01 management example for deleting private endpoint connection (LRO).
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/DeleteEncryptionScope.json	Adds 2026-03-01 management example for deleting encryption scope (LRO).
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/DeleteDeployment.json	Adds 2026-03-01 management example for deleting a deployment (LRO).
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/DeleteCommitmentPlan.json	Adds 2026-03-01 management example for deleting a commitment plan (LRO).
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/DeleteAccount.json	Adds 2026-03-01 management example for deleting an account (LRO).
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/CheckSkuAvailability.json	Adds 2026-03-01 management example for checking SKU availability.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/CheckDomainAvailability.json	Adds 2026-03-01 management example for checking domain availability.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/CalculateModelCapacity.json	Adds 2026-03-01 management example for calculating model capacity.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/AgentDeployment/stop.json	Adds 2026-03-01 management example for stopping agent deployment.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/AgentDeployment/start.json	Adds 2026-03-01 management example for starting agent deployment.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/AgentDeployment/delete.json	Adds 2026-03-01 management example for deleting agent deployment (LRO).
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/AgentApplication/enable.json	Adds 2026-03-01 management example for enabling agent application.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/AgentApplication/disable.json	Adds 2026-03-01 management example for disabling agent application.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/AgentApplication/delete.json	Adds 2026-03-01 management example for deleting agent application (LRO).
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/AddRaiBlocklistItems.json	Adds 2026-03-01 management example for batch-adding RAI blocklist items.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/AccountConnection/get.json	Adds 2026-03-01 management example for getting an account connection.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/AccountConnection/delete.json	Adds 2026-03-01 management example for deleting an account connection.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/AccountConnection/create.json	Adds 2026-03-01 management example for creating an account connection.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/AccountCapabilityHost/list.json	Adds 2026-03-01 management example for listing account capability hosts.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/AccountCapabilityHost/get.json	Adds 2026-03-01 management example for getting an account capability host.
specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/AccountCapabilityHost/delete.json	Adds 2026-03-01 management example for deleting an account capability host.

Comments suppressed due to low confidence (1)

specification/cognitiveservices/CognitiveServices.Management/examples/2026-03-01/CalculateModelCapacity.json:1

This operationId casing/pattern is inconsistent with the rest of the examples in this version (mostly Noun_Verb). If the actual swagger operationId follows the standard pattern, this mismatch will break x-ms-examples linking/validation—please ensure the example’s operationId exactly matches the operation’s operationId in the 2026-03-01 swagger.

…eadme tag - Add v2026_03_01 to Versions enum in main.tsp - Gate 4 preview-only features with @removed(Versions.v2026_03_01): ComputeOperationStatus, FoundryAutoUpgrade, QuotaScopeType, ManagedNetwork delete operation - Delete 14 orphaned example files (compute, managed network delete, 12 scope-variant files) - Fix api-version strings in 4 example files - Add package-2026-03-01 tag section to readme.md with all suppressions - Update default tag to package-2026-03-01 - Clean recompile from TypeSpec source Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

fmabroukmsft · 2026-04-01T17:10:18Z

Copilot Review Comment Accuracy Evaluation

I reviewed all 10 Copilot review comments against the actual file contents and the source version (2026-01-15-preview) examples. Here are the findings:

❌ FALSE POSITIVES (2 comments)

1. ManagedNetwork/deleteRuleV2.json — "LRO polling URL uses 2026-01-15-preview"

Wrong. The file already has api-version=2026-03-01. The previous version (2026-01-15-preview) had 2026-01-15-preview and was correctly updated. Copilot appears to be hallucinating based on the source version, not the actual file content.

2. AgentDeployment/delete.json — same claim

Wrong. Same issue — the URL was already correctly updated to 2026-03-01.

✅ ACCURATE but PRE-EXISTING (6 comments)

3–4. ListPrivateEndpointConnections.json — response id mismatches request params

Correct observation. Request uses res6977/sto2527, response uses res7231/sto288. However, the identical mismatch exists in the 2026-01-15-preview source — this is inherited, not introduced by this PR.

5–7. GetPrivateEndpointConnection.json — same id mismatch

Correct. Same inherited inconsistency from the source version.

8. CheckDomainAvailability.json — title says "Check SKU Availability"

Correct. The title is wrong — operationId is CheckDomainAvailability but title says "Check SKU Availability". Same title exists in the 2026-01-15-preview source — pre-existing.

⚠️ DEBATABLE / PRE-EXISTING (2 comments)

9. ManagedNetwork/getRuleV2.json — ARM type should be fully qualified

The value "accounts/outboundRules" is the short form; Copilot suggests "Microsoft.CognitiveServices/accounts/outboundRules". Both forms are valid in ARM. Pre-existing from the source version.

10. GetPrivateEndpointConnection.json — "monitor": "true" should be boolean true

Whether "true" (string) vs true (boolean) is correct depends on the TypeSpec parameter definition. The string form has been used across multiple versions without CI failure, suggesting it may be intentionally typed as a string. Pre-existing.

Summary

Verdict	Count	Comments
❌ False positive (factually wrong)	2	#1, #2
✅ Accurate but pre-existing	6	#3–8
⚠️ Debatable + pre-existing	2	#9, #10
🔴 Genuine new issue	0	—

Key takeaway: None of the flagged issues were introduced by this PR. The examples were mechanically cloned from 2026-01-15-preview with only the api-version field updated (which Copilot incorrectly flagged as not done on 2 files). The remaining observations are real cosmetic issues in the example files but are all inherited from the source version.

* Add CognitiveServices stable API version 2026-03-01 swagger Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Fix CogSvc 2026-03-01 stable: add TypeSpec version, feature gating, readme tag - Add v2026_03_01 to Versions enum in main.tsp - Gate 4 preview-only features with @removed(Versions.v2026_03_01): ComputeOperationStatus, FoundryAutoUpgrade, QuotaScopeType, ManagedNetwork delete operation - Delete 14 orphaned example files (compute, managed network delete, 12 scope-variant files) - Fix api-version strings in 4 example files - Add package-2026-03-01 tag section to readme.md with all suppressions - Update default tag to package-2026-03-01 - Clean recompile from TypeSpec source Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: Ravi Eda <raeda@microsoft.com>

Add CognitiveServices stable API version 2026-03-01 swagger

653955f

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

fmabroukmsft requested a review from rkuthala as a code owner March 29, 2026 11:00

microsoft-github-policy-service Bot added the Cognitive Services label Mar 29, 2026

github-actions Bot added ARMReview new-api-version resource-manager TypeSpec Authored with TypeSpec WaitForARMFeedback <valid label in PR review process> add this label when ARM review is required labels Mar 29, 2026

ravimeda requested a review from Copilot March 30, 2026 23:48

Merge branch 'main' into swagger-agent/CogSvc-2026-03-01-typespec

324c363

ravimeda added ARMChangesRequested and removed WaitForARMFeedback <valid label in PR review process> add this label when ARM review is required labels Mar 30, 2026

Copilot AI reviewed Mar 30, 2026

View reviewed changes

fmabroukmsft and others added 2 commits March 30, 2026 20:04

Merge branch 'main' into swagger-agent/CogSvc-2026-03-01-typespec

8e692a4

github-actions Bot added ARMAutoSignedOff-IncrementalTSP ARMSignedOff <valid label in PR review process>add this label when ARM approve updates after review BreakingChange-Go-Sdk BreakingChange-JavaScript-Sdk and removed ARMChangesRequested labels Mar 31, 2026

kazrael2119 added the BreakingChange-JavaScript-Sdk-Approved label Apr 1, 2026

rkuthala approved these changes Apr 1, 2026

View reviewed changes

fmabroukmsft added the PublishToCustomers Acknowledgement the changes will be published to Azure customers. label Apr 1, 2026

tadelesh added the BreakingChange-Go-Sdk-Approved label Apr 2, 2026

fmabroukmsft merged commit edf4ca5 into main Apr 2, 2026
68 checks passed

fmabroukmsft deleted the swagger-agent/CogSvc-2026-03-01-typespec branch April 2, 2026 14:57

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add CognitiveServices stable API version 2026-03-01#41880

Add CognitiveServices stable API version 2026-03-01#41880
fmabroukmsft merged 4 commits intomainfrom
swagger-agent/CogSvc-2026-03-01-typespec

fmabroukmsft commented Mar 29, 2026

Uh oh!

github-actions Bot commented Mar 29, 2026 •

edited

Loading

Uh oh!

ravimeda commented Mar 30, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

fmabroukmsft commented Apr 1, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

Conversation

fmabroukmsft commented Mar 29, 2026

ARM (Control Plane) API Specification Update Pull Request

PR review workflow diagram

Purpose of this PR

Due diligence checklist

Additional information

Getting help

Uh oh!

github-actions Bot commented Mar 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Next Steps to Merge

Uh oh!

ravimeda commented Mar 30, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

fmabroukmsft commented Apr 1, 2026

Copilot Review Comment Accuracy Evaluation

❌ FALSE POSITIVES (2 comments)

✅ ACCURATE but PRE-EXISTING (6 comments)

⚠️ DEBATABLE / PRE-EXISTING (2 comments)

Summary

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

github-actions Bot commented Mar 29, 2026 •

edited

Loading