Method: folders.updateAccessApprovalSettings

Updates the settings associated with a project, folder, or organization. Settings to update are determined by the value of field_mask.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



The resource name of the settings. Format is one of:

  • "projects/{project}/accessApprovalSettings"
  • "folders/{folder}/accessApprovalSettings"
  • "organizations/{organization}/accessApprovalSettings"

Query parameters


string (FieldMask format)

The update mask applies to the settings. Only the top level fields of AccessApprovalSettings (notificationEmails & enrolledServices) are supported. For each field, if it is included, the currently stored value will be entirely overwritten with the value of the field passed in this request.

For the FieldMask definition, see If this field is left unset, only the notificationEmails field will be updated.

This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo".

Request body

The request body contains an instance of AccessApprovalSettings.

Response body

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

Authorization scopes

Requires the following OAuth scope:


For more information, see the Authentication Overview.