---
title: "Delete Permission Policy"
method: DELETE
path: "/organizations/{orgId}/permissionpolicies/{id}"
tags: ["PermissionPolicy"]
---

# Delete Permission Policy

`DELETE /organizations/{orgId}/permissionpolicies/{id}`

Delete the PermissionPolicy for the UUID

## Path parameters

- `id` string, required
- `orgId` string, required

## Response `200`

Returns the PermissionPolicy that was deleted

- PermissionPolicyResponse
  - `id` string, required — The UUID of the entity.
  - `version` integer — The version number: - **Create:** On initial Create to insert a new entity, the version is set at 1 in the response. - **Update:** On successful Update, the version is incremented by 1 in the response.
  - `name` string — The name of the Permission Policy.
  - `permissionPolicy` PermissionStatement[] — Array containing the Permission Policies information.
    - `effect` 'ALLOW' | 'DENY', required
    - `action` PermissionAction[], required — The actions available to users who are assigned the Permission Policy - what they can do or cannot do with respect to the specified resource. **NOTE:** Use lower case and a colon-separated format, for example, if you want to confer full CRUD, use: ``` "config:create", "config:delete", "config:retrieve", "config:update" ```
    - `resource` string[], required — See [Statements - Available Resources](https://www.m3ter.com/docs/guides/managing-organization-and-users/creating-and-managing-permissions#statements---available-resources) for a listing of available resources for Permission Policy statements.
  - `managedPolicy` boolean — Indicates whether this is a system generated Managed Permission Policy.
  - `dtCreated` string, date-time — The date and time *(in ISO-8601 format)* when the Permission Policy was created.
  - `dtLastModified` string, date-time — The date and time *(in ISO-8601 format)* when the Permission Policy was last modified.
  - `createdBy` string — The unique identifier (UUID) of the user who created this Permission Policy.
  - `lastModifiedBy` string — The unique identifier (UUID) of the user who last modified this Permission Policy.

## Other responses

- `4XX` — Error message
- `5XX` — Error message

---

[API](https://skmtc.net/m3ter-com/apis/m3ter-api.md) · [All operations](https://skmtc.net/m3ter-com/apis/m3ter-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/m3ter-com/m3ter-api/revisions/ac93d1a9e6d9/schema)