---
title: "PATCH /v2/{+name}"
method: PATCH
path: "/v2/{+name}"
tags: ["domains"]
---

# PATCH /v2/{+name}

`PATCH /v2/{+name}`

[Developer Preview](https://developers.google.com/workspace/preview): Updates a user for a domain. Only Owners and Admins can execute this RPC, only a user's domain permission will be allowed to be updated. Returns NOT_FOUND if the user does not exist. Returns INVALID_ARGUMENT if a permission is not provided or is PERMISSION_UNSPECIFIED, NONE, or OWNER.

## Path parameters

- `name` string, required

## Query parameters

- `updateMask` string

## Request body

- User — [Developer Preview](https://developers.google.com/workspace/preview): Information about a user's access to a domain.
  - `user` string — The user's email address.
  - `name` string — Identifier. The resource name of the user. Format: users/{user} Note: {user} is the user's email address.
  - `permission` 'PERMISSION_UNSPECIFIED' | 'READER' | 'ADMIN' | 'OWNER' | 'NONE' — The permission level that the user has for the specified domain.
  - `accessGranter` string — Output only. The user that added the current user.
  - `createTime` string, google-datetime — Output only. The time the user was granted access.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/gmailpostmastertools.md) · [All operations](https://skmtc.dev/google/apis/gmailpostmastertools/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/gmailpostmastertools/revisions/ee090f4a0797/schema)