---
title: "POST /v2/{+parent}/permissions:batchUpdate"
method: POST
path: "/v2/{+parent}/permissions:batchUpdate"
tags: ["labels"]
---

# POST /v2/{+parent}/permissions:batchUpdate

`POST /v2/{+parent}/permissions:batchUpdate`

Updates label permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.

## Path parameters

- `parent` string, required

## Request body

- GoogleAppsDriveLabelsV2BatchUpdateLabelPermissionsRequest — Updates one or more label permissions.
  - `useAdminAccess` boolean — Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access. If this is set, the `use_admin_access` field in the `UpdateLabelPermissionRequest` messages must either be empty or match this field.
  - `requests` GoogleAppsDriveLabelsV2UpdateLabelPermissionRequest[] — Required. The request message specifying the resources to update.
    - `parent` string — Required. The parent label resource name.
    - `useAdminAccess` boolean — Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.
    - `labelPermission` GoogleAppsDriveLabelsV2LabelPermission — The permission that applies to a principal (user, group, audience) on a label.
      - `group` string — Group resource name.
      - `name` string — Resource name of this permission.
      - `email` string — Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified.
      - `role` 'LABEL_ROLE_UNSPECIFIED' | 'READER' | 'APPLIER' | 'ORGANIZER' | 'EDITOR' — The role the principal should have.
      - `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.
      - `person` string — Person resource name.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/drivelabels.md) · [All operations](https://skmtc.net/google/apis/drivelabels/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/drivelabels/versions/0865f97e9c4a/schema)