# Azure Policy Policy Definitions API

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

The PolicyDefinitions API from Azure Policy — 6 operation(s) for policydefinitions.

## Operations (10)

| Method | Path | Summary |
|---|---|---|
| PUT | `/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policyDefinitions/{policyDefinitionName}` | Creates or updates a policy definition in a subscription |
| DELETE | `/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policyDefinitions/{policyDefinitionName}` | Deletes a policy definition in a subscription |
| GET | `/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policyDefinitions/{policyDefinitionName}` | Retrieves a policy definition in a subscription |
| GET | `/providers/Microsoft.Authorization/policyDefinitions/{policyDefinitionName}` | Retrieves a built-in policy definition |
| PUT | `/providers/Microsoft.Management/managementGroups/{managementGroupId}/providers/Microsoft.Authorization/policyDefinitions/{policyDefinitionName}` | Creates or updates a policy definition in a management group |
| DELETE | `/providers/Microsoft.Management/managementGroups/{managementGroupId}/providers/Microsoft.Authorization/policyDefinitions/{policyDefinitionName}` | Deletes a policy definition in a management group |
| GET | `/providers/Microsoft.Management/managementGroups/{managementGroupId}/providers/Microsoft.Authorization/policyDefinitions/{policyDefinitionName}` | Retrieve a policy definition in a management group |
| GET | `/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policyDefinitions` | Retrieves policy definitions in a subscription |
| GET | `/providers/Microsoft.Authorization/policyDefinitions` | Retrieve built-in policy definitions |
| GET | `/providers/Microsoft.Management/managementGroups/{managementGroupId}/providers/Microsoft.Authorization/policyDefinitions` | Retrieve policy definitions in a management group |

## Machine-readable artifacts (1)

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

## Tags

Policy Definitions

---

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