Method: folders.approvalRequests.invalidate

Invalidates an existing ApprovalRequest. Returns the updated ApprovalRequest.

NOTE: This action revokes Google access based on this approval request. If the resource has other active approvals, access will remain granted.

Returns FAILED_PRECONDITION if the request exists but is not in an approved state.

HTTP request

POST https://accessapproval.googleapis.com/v1/{name=folders/*/approvalRequests/*}:invalidate

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Name of the ApprovalRequest to invalidate.

Authorization requires the following IAM permission on the specified resource name:

  • accessapproval.requests.invalidate

Request body

The request body must be empty.

Response body

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

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the Authentication Overview.