---
title: "Delete a Policy Group"
method: DELETE
path: "/policy-groups/{policy_group}"
tags: ["policy-groups"]
---

# Delete a Policy Group

`DELETE /policy-groups/{policy_group}`

This endpoint deletes a [policy group](/docs/policy-governance#open-policy-agent) by ID.
Only an unused policy group (that is not linked to any environment) can be removed.

## Path parameters

- `policy_group` string, required

## Response `204`

Deleted.

## Other responses

- `403` — User unauthorized to perform this action.
- `404` — Policy group not found or user unauthorized to perform action.
- `409` — Can't be deleted. The policy group is in use.
- `4XX` — Client error.
- `5XX` — Server error.

---

[API](https://skmtc.net/scalr/apis/scalr-iacp-api.md) · [All operations](https://skmtc.net/scalr/apis/scalr-iacp-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scalr/scalr-iacp-api/versions/fc927526ad12/schema)