# REST Resource: projects.approvalRequests

- [Resource: ApprovalRequest](https://docs.cloud.google.com/assured-workloads/access-approval/docs/reference/rest/v1/projects.approvalRequests#ApprovalRequest)
  - [JSON representation](https://docs.cloud.google.com/assured-workloads/access-approval/docs/reference/rest/v1/projects.approvalRequests#ApprovalRequest.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/assured-workloads/access-approval/docs/reference/rest/v1/projects.approvalRequests#METHODS_SUMMARY)

## Resource: ApprovalRequest

A request for the customer to approve access to a resource.

| JSON representation |
|---|
| ``` { "name": string, "requestedResourceName": string, "requestedAugmentedInfo": { object (`https://docs.cloud.google.com/assured-workloads/access-approval/docs/reference/rest/v1/folders.approvalRequests#ApprovalRequest.AugmentedInfo`) }, "requestedResourceProperties": { object (`https://docs.cloud.google.com/assured-workloads/access-approval/docs/reference/rest/v1/folders.approvalRequests#ApprovalRequest.ResourceProperties`) }, "requestedReason": { object (`https://docs.cloud.google.com/assured-workloads/access-approval/docs/reference/rest/v1/folders.approvalRequests#ApprovalRequest.AccessReason`) }, "requestedLocations": { object (`https://docs.cloud.google.com/assured-workloads/access-approval/docs/reference/rest/v1/folders.approvalRequests#ApprovalRequest.AccessLocations`) }, "requestTime": string, "requestedExpiration": string, "requestedDuration": string, // Union field `decision` can be only one of the following: "approve": { object (`https://docs.cloud.google.com/assured-workloads/access-approval/docs/reference/rest/v1/folders.approvalRequests#ApprovalRequest.ApproveDecision`) }, "dismiss": { object (`https://docs.cloud.google.com/assured-workloads/access-approval/docs/reference/rest/v1/folders.approvalRequests#ApprovalRequest.DismissDecision`) } // End of list of possible types for union field `decision`. } ``` |

| Fields ||
|---|---|
| `name` | `string` The resource name of the request. Format is "{projects\|folders\|organizations}/{id}/approvalRequests/{approval_request}". |
| `requestedResourceName` | `string` The resource for which approval is being requested. The format of the resource name is defined at <https://cloud.google.com/apis/design/resource_names>. The resource name here may either be a "full" resource name (e.g. "//library.googleapis.com/shelves/shelf1/books/book2") or a "relative" resource name (e.g. "shelves/shelf1/books/book2") as described in the resource name specification. |
| `requestedAugmentedInfo` | ``object (`https://docs.cloud.google.com/assured-workloads/access-approval/docs/reference/rest/v1/folders.approvalRequests#ApprovalRequest.AugmentedInfo`)`` This field contains the augmented information of the request. |
| `requestedResourceProperties` | ``object (`https://docs.cloud.google.com/assured-workloads/access-approval/docs/reference/rest/v1/folders.approvalRequests#ApprovalRequest.ResourceProperties`)`` Properties related to the resource represented by requestedResourceName. |
| `requestedReason` | ``object (`https://docs.cloud.google.com/assured-workloads/access-approval/docs/reference/rest/v1/folders.approvalRequests#ApprovalRequest.AccessReason`)`` The access reason for which approval is being requested. |
| `requestedLocations` | ``object (`https://docs.cloud.google.com/assured-workloads/access-approval/docs/reference/rest/v1/folders.approvalRequests#ApprovalRequest.AccessLocations`)`` The locations for which approval is being requested. |
| `requestTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` The time at which approval was requested. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `requestedExpiration` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` The original requested expiration for the approval. Calculated by adding the requestedDuration to the requestTime. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `requestedDuration` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#duration` format)`` The requested access duration. A duration in seconds with up to nine fractional digits, ending with '`s`'. Example: `"3.5s"`. |
| Union field `decision`. The current decision on the approval request. `decision` can be only one of the following: ||
| `approve` | ``object (`https://docs.cloud.google.com/assured-workloads/access-approval/docs/reference/rest/v1/folders.approvalRequests#ApprovalRequest.ApproveDecision`)`` Access was approved. |
| `dismiss` | ``object (`https://docs.cloud.google.com/assured-workloads/access-approval/docs/reference/rest/v1/folders.approvalRequests#ApprovalRequest.DismissDecision`)`` The request was dismissed. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/assured-workloads/access-approval/docs/reference/rest/v1/projects.approvalRequests/approve` | Approves a request and returns the updated ApprovalRequest. |
| ### `https://docs.cloud.google.com/assured-workloads/access-approval/docs/reference/rest/v1/projects.approvalRequests/dismiss` | Dismisses a request. |
| ### `https://docs.cloud.google.com/assured-workloads/access-approval/docs/reference/rest/v1/projects.approvalRequests/get` | Gets an approval request. |
| ### `https://docs.cloud.google.com/assured-workloads/access-approval/docs/reference/rest/v1/projects.approvalRequests/invalidate` | Invalidates an existing ApprovalRequest. |
| ### `https://docs.cloud.google.com/assured-workloads/access-approval/docs/reference/rest/v1/projects.approvalRequests/list` | Lists approval requests associated with a project, folder, or organization. |