Method: organizations.approvalRequests.invalidate

Invalidates an existing ApprovalRequest. Returns the updated ApprovalRequest.

NOTE: This does not deny access to the resource if another request has been made and approved. It only invalidates a single approval.

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

HTTP request

POST https://accessapproval.googleapis.com/v1/{name=organizations/*/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.