Method: policies.delete

Deletes a policy. This action is permanent.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. The resource name of the policy to delete. Format: policies/{attachmentPoint}/denypolicies/{policyId}

Use the URL-encoded full resource name, which means that the forward-slash character, /, must be written as %2F. For example, policies/

For organizations and folders, use the numeric ID in the full resource name. For projects, you can use the alphanumeric or the numeric ID.

Query parameters



Optional. The expected etag of the policy to delete. If the value does not match the value that is stored in IAM, the request fails with a 409 error code and ABORTED status.

If you omit this field, the policy is deleted regardless of its current etag.

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of Operation.

Authorization scopes

Requires one of the following OAuth scopes:


For more information, see the Authentication Overview.