# REST Resource: labels.revisions.permissions

- [Resource: LabelPermission](https://developers.google.com/workspace/drive/labels/reference/rest/v2beta/labels.revisions.permissions#LabelPermission)
  - [JSON representation](https://developers.google.com/workspace/drive/labels/reference/rest/v2beta/labels.revisions.permissions#LabelPermission.SCHEMA_REPRESENTATION)
- [Methods](https://developers.google.com/workspace/drive/labels/reference/rest/v2beta/labels.revisions.permissions#METHODS_SUMMARY)

## Resource: LabelPermission

The permission that applies to a principal (user, group, audience) on a label.

| JSON representation |
|---|
| ``` { "name": string, "email": string, "role": enum (`https://developers.google.com/workspace/drive/labels/reference/rest/v2beta/labels.permissions#LabelPermission.LabelRole`), "person": string, "group": string, "audience": string } ``` |

| Fields ||
|---|---|
| `name` | `string` Resource name of this permission. |
| `email` | `string` Specifies the email address for a user or group pricinpal. Not populated for audience principals. User and Group permissions may only be inserted using email address. On update requests, if email address is specified, no principal should be specified. |
| `role` | ``enum (`https://developers.google.com/workspace/drive/labels/reference/rest/v2beta/labels.permissions#LabelPermission.LabelRole`)`` The role the principal should have. |
| Union field `principal`. The principal this permission applies to. Must be either an email, user, group, or audience. Example: \* people/12345 \* groups/45678 \* audiences/default `principal` can be only one of the following: ||
| `person` | `string` Person resource name. |
| `group` | `string` Group resource name. |
| `audience` | `string` Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the Label. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/workspace/drive/labels/reference/rest/v2beta/labels.revisions.permissions/batchDelete` | Deletes Label permissions. |
| ### `https://developers.google.com/workspace/drive/labels/reference/rest/v2beta/labels.revisions.permissions/batchUpdate` | Updates Label permissions. |
| ### `https://developers.google.com/workspace/drive/labels/reference/rest/v2beta/labels.revisions.permissions/create` | Updates a Label's permissions. |
| ### `https://developers.google.com/workspace/drive/labels/reference/rest/v2beta/labels.revisions.permissions/delete` | Deletes a Label's permission. |
| ### `https://developers.google.com/workspace/drive/labels/reference/rest/v2beta/labels.revisions.permissions/list` | Lists a Label's permissions. |