---
title: "DELETE /subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/remediations/{remediationName}"
method: DELETE
path: "/subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/remediations/{remediationName}"
---

# DELETE /subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/remediations/{remediationName}

`DELETE /subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/remediations/{remediationName}`

Deletes an existing remediation at subscription scope.

## Path parameters

- `subscriptionId` string, required
- `remediationName` string, required

## Query parameters

- `api-version` string, required

## Response `200`

The deleted remediation.

- Remediation — The remediation definition.
  - `properties` RemediationProperties — The remediation properties.
    - `policyAssignmentId` string — The resource ID of the policy assignment that should be remediated.
    - `policyDefinitionReferenceId` string — The policy definition reference ID of the individual definition that should be remediated. Required when the policy assignment being remediated assigns a policy set definition.
    - `resourceDiscoveryMode` 'ExistingNonCompliant' | 'ReEvaluateCompliance' — The way resources to remediate are discovered. Defaults to ExistingNonCompliant if not specified.
    - `provisioningState` string — The status of the remediation.
    - `createdOn` string, date-time — The time at which the remediation was created.
    - `lastUpdatedOn` string, date-time — The time at which the remediation was last updated.
    - `filters` RemediationFilters — The filters that will be applied to determine which resources to remediate.
      - `locations` string[] — The resource locations that will be remediated.
    - `deploymentStatus` RemediationDeploymentSummary — The deployment status summary for all deployments created by the remediation.
      - `totalDeployments` integer — The number of deployments required by the remediation.
      - `successfulDeployments` integer — The number of deployments required by the remediation that have succeeded.
      - `failedDeployments` integer — The number of deployments required by the remediation that have failed.
  - `id` string — The ID of the remediation.
  - `type` string — The type of the remediation.
  - `name` string — The name of the remediation.

## Other responses

- `204` — The remediation did not exist.
- `default` — Error response describing why the operation failed.

---

[API](https://skmtc.net/azure/apis/remediationsclient.md) · [All operations](https://skmtc.net/azure/apis/remediationsclient/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/remediationsclient/revisions/1cf51ae76be4/schema)