Method: folders.locations.entitlements.grants.deny

grants.deny is used to deny a grant. This method can only be called on a grant when it's in the APPROVAL_AWAITED state. This operation can't be undone.

HTTP request

POST https://privilegedaccessmanager.googleapis.com/v1/{name=folders/*/locations/*/entitlements/*/grants/*}:deny

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. Name of the grant resource which is being denied.

Request body

The request body contains data with the following structure:

JSON representation
{
  "reason": string
}
Fields
reason

string

Optional. The reason for denying this grant. This is required if requireApproverJustification field of the ManualApprovals workflow used in this grant is true.

Response body

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

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.