# Azure Policy Policy Set Definition Versions API

**Canonical:** https://apis.io/apis/microsoft-azure-policy/microsoft-azure-policy-policysetdefinitionversions-api/  
**Provider:** Azure Policy — https://apis.io/providers/microsoft-azure-policy/  
**Base URL:** https://management.azure.com  
**Documentation:** https://learn.microsoft.com/en-us/rest/api/policy/

Azure Policy Policy Set Definition Versions API is one of 7 APIs that [Azure Policy](https://apis.io/providers/microsoft-azure-policy/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include PolicySetDefinitionVersions. The published artifact set on APIs.io includes an OpenAPI specification.

The PolicySetDefinitionVersions API from Azure Policy — 9 operation(s) for policysetdefinitionversions.

## Operations (13)

| Method | Path | Summary |
|---|---|---|
| POST | `/providers/Microsoft.Authorization/listPolicySetDefinitionVersions` | Lists all built-in policy set definition versions |
| POST | `/providers/Microsoft.Management/managementGroups/{managementGroupName}/providers/Microsoft.Authorization/listPolicySetDefinitionVersions` | Lists all policy set definition versions at management group scope |
| POST | `/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/listPolicySetDefinitionVersions` | Lists all policy set definition versions within a subscription |
| PUT | `/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policySetDefinitions/{policySetDefinitionName}/versions/{policyDefinitionVersion}` | Creates or updates a policy set definition version |
| DELETE | `/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policySetDefinitions/{policySetDefinitionName}/versions/{policyDefinitionVersion}` | Deletes a policy set definition version |
| GET | `/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policySetDefinitions/{policySetDefinitionName}/versions/{policyDefinitionVersion}` | Retrieves a policy set definition version |
| GET | `/providers/Microsoft.Authorization/policySetDefinitions/{policySetDefinitionName}/versions/{policyDefinitionVersion}` | Retrieves a built in policy set definition version |
| GET | `/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policySetDefinitions/{policySetDefinitionName}/versions` | Retrieves the policy set definition versions for a given policy set definition… |
| GET | `/providers/Microsoft.Authorization/policySetDefinitions/{policySetDefinitionName}/versions` | Retrieves built-in policy set definition versions |
| PUT | `/providers/Microsoft.Management/managementGroups/{managementGroupName}/providers/Microsoft.Authorization/policySetDefinitions/{policySetDefinitionName}/versions/{policyDefinitionVersion}` | Creates or updates a policy set definition version |
| DELETE | `/providers/Microsoft.Management/managementGroups/{managementGroupName}/providers/Microsoft.Authorization/policySetDefinitions/{policySetDefinitionName}/versions/{policyDefinitionVersion}` | Deletes a policy set definition version |
| GET | `/providers/Microsoft.Management/managementGroups/{managementGroupName}/providers/Microsoft.Authorization/policySetDefinitions/{policySetDefinitionName}/versions/{policyDefinitionVersion}` | Retrieves a policy set definition version |
| GET | `/providers/Microsoft.Management/managementGroups/{managementGroupName}/providers/Microsoft.Authorization/policySetDefinitions/{policySetDefinitionName}/versions` | Retrieves all policy set definition versions for a given policy set definition… |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/microsoft-azure-policy/openapi/microsoft-azure-policy-policysetdefinitionversions-api-openapi.yml

## Other Azure Policy APIs (6)

- [Azure Policy Operations API](https://apis.io/apis/microsoft-azure-policy/microsoft-azure-policy-operations-api/)
- [Azure Policy REST API](https://apis.io/apis/microsoft-azure-policy/microsoft-azure-policy-policy-definitions-api/)
- [Azure Policy Policy Assignments API](https://apis.io/apis/microsoft-azure-policy/microsoft-azure-policy-policyassignments-api/)
- [Azure Policy Policy Definitions API](https://apis.io/apis/microsoft-azure-policy/microsoft-azure-policy-policydefinitions-api/)
- [Azure Policy Policy Definition Versions API](https://apis.io/apis/microsoft-azure-policy/microsoft-azure-policy-policydefinitionversions-api/)
- [Azure Policy Policy Set Definitions API](https://apis.io/apis/microsoft-azure-policy/microsoft-azure-policy-policysetdefinitions-api/)

## Tags

PolicySetDefinitionVersions

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/microsoft-azure-policy/microsoft-azure-policy-policysetdefinitionversions-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/microsoft-azure-policy/.