---
title: "Deletes a policy assignment."
method: DELETE
path: "/{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}"
tags: ["PolicyAssignments"]
---

# Deletes a policy assignment.

`DELETE /{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}`

This operation deletes a policy assignment, given its name and the scope it was created in. The scope of a policy assignment is the part of its ID preceding '/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'.

## Path parameters

- `scope` string, required
- `policyAssignmentName` string, required

## Query parameters

- `api-version` string, required

## Response `200`

OK - Returns information about the deleted assignment.

- PolicyAssignment — The policy assignment.
  - `properties` PolicyAssignmentProperties — The policy assignment properties.
    - `displayName` string — The display name of the policy assignment.
    - `policyDefinitionId` string — The ID of the policy definition or policy set definition being assigned.
    - `scope` string — The scope for the policy assignment.
    - `notScopes` string[] — The policy's excluded scopes.
    - `parameters` object — Required if a parameter is used in policy rule.
    - `description` string — This message will be part of response in case of policy violation.
    - `metadata` object — The policy assignment metadata.
    - `enforcementMode` 'Default' | 'DoNotEnforce' — The policy assignment enforcement mode. Possible values are Default and DoNotEnforce.
  - `id` string — The ID of the policy assignment.
  - `type` string — The type of the policy assignment.
  - `name` string — The name of the policy assignment.
  - `sku` PolicySku — The policy sku. This property is optional, obsolete, and will be ignored.
    - `name` string, required — The name of the policy sku. Possible values are A0 and A1.
    - `tier` string — The policy sku tier. Possible values are Free and Standard.
  - `location` string — The location of the policy assignment. Only required when utilizing managed identity.
  - `identity` Identity — Identity for the resource.
    - `principalId` string — The principal ID of the resource identity.
    - `tenantId` string — The tenant ID of the resource identity.
    - `type` 'SystemAssigned' | 'None' — The identity type.

## Other responses

- `204` — No Content - the policy assignment doesn't exist.
- `default` — Error response describing why the operation failed.

---

[API](https://skmtc.net/azure/apis/policyclient-2.md) · [All operations](https://skmtc.net/azure/apis/policyclient-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/policyclient-2/versions/cd0bdb00ef1a/schema)