# Azure Policy Policy Definition Versions API

**Canonical:** https://apis.io/apis/microsoft-azure-policy/microsoft-azure-policy-policydefinitionversions-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 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 PolicyDefinitionVersions. The published artifact set on APIs.io includes an OpenAPI specification.

The PolicyDefinitionVersions API from Azure Policy — 9 operation(s) for policydefinitionversions.

## Operations (13)

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

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/microsoft-azure-policy/openapi/microsoft-azure-policy-policydefinitionversions-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 Set Definitions API](https://apis.io/apis/microsoft-azure-policy/microsoft-azure-policy-policysetdefinitions-api/)
- [Azure Policy Policy Set Definition Versions API](https://apis.io/apis/microsoft-azure-policy/microsoft-azure-policy-policysetdefinitionversions-api/)

## Tags

PolicyDefinitionVersions

---

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