Method: notes.permissions.batchDelete

Stay organized with collections Save and categorize content based on your preferences.

Deletes one or more permissions on the note. The specified entities will immediately lose access. A permission with the OWNER role can't be removed. If removing a permission fails, then the entire request fails and no changes are made. Returns a 400 bad request error if a specified permission does not exist on the note.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



The parent resource shared by all permissions being deleted. Format: notes/{note} If this is set, the parent of all of the permissions specified in the DeletePermissionRequest messages must match this field.

Request body

The request body contains data with the following structure:

JSON representation
  "names": [


Required. The names of the permissions to delete. Format: notes/{note}/permissions/{permission}

Response body

If successful, the response body is empty.

Authorization Scopes

Requires the following OAuth scope:


For more information, see the Authorization guide.