# Method: groups.memberships.modifyMembershipRoles

Modifies the `MembershipRole`s of a `Membership`.

### HTTP request

`POST https://cloudidentity.googleapis.com/v1/{name=groups/*/memberships/*}:modifyMembershipRoles`

The URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.

### Path parameters

| Parameters ||
|---|---|
| `name` | `string` Required. The [resource name](https://cloud.google.com/apis/design/resource_names) of the `Membership` whose roles are to be modified. Must be of the form `groups/{group}/memberships/{membership}`. |

### Request body

The request body contains data with the following structure:

| JSON representation |
|---|
| ``` { "addRoles": [ { object (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/groups.memberships#MembershipRole`) } ], "removeRoles": [ string ], "updateRolesParams": [ { object (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/groups.memberships/modifyMembershipRoles#UpdateMembershipRolesParams`) } ] } ``` |

| Fields ||
|---|---|
| `addRoles[]` | ``object (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/groups.memberships#MembershipRole`)`` The `MembershipRole`s to be added. Adding or removing roles in the same request as updating roles is not supported. Must not be set if `update_roles_params` is set. |
| `removeRoles[]` | `string` The `name`s of the `MembershipRole`s to be removed. Adding or removing roles in the same request as updating roles is not supported. It is not possible to remove the `MEMBER` `MembershipRole`. If you wish to delete a `Membership`, call `https://docs.cloud.google.com/identity/docs/reference/rest/v1/groups.memberships/delete#google.apps.cloudidentity.groups.v1.MembershipsService.DeleteMembership` instead. Must not contain `MEMBER`. Must not be set if `update_roles_params` is set. |
| `updateRolesParams[]` | ``object (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/groups.memberships/modifyMembershipRoles#UpdateMembershipRolesParams`)`` The `MembershipRole`s to be updated. Updating roles in the same request as adding or removing roles is not supported. Must not be set if either `add_roles` or `remove_roles` is set. |

### Response body

The response message for `https://docs.cloud.google.com/identity/docs/reference/rest/v1/groups.memberships/modifyMembershipRoles#google.apps.cloudidentity.groups.v1.MembershipsService.ModifyMembershipRoles`.

If successful, the response body contains data with the following structure:

| JSON representation |
|---|
| ``` { "membership": { object (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/groups.memberships#Membership`) } } ``` |

| Fields ||
|---|---|
| `membership` | ``object (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/groups.memberships#Membership`)`` The `Membership` resource after modifying its `MembershipRole`s. |

### Authorization scopes

Requires one of the following OAuth scopes:

- `https://www.googleapis.com/auth/cloud-identity.groups`
- `https://www.googleapis.com/auth/cloud-identity`
- `https://www.googleapis.com/auth/cloud-platform`

For more information, see the [Authorization guide](https://developers.google.com/workspace/guides/configure-oauth-consent).

## UpdateMembershipRolesParams

The details of an update to a `MembershipRole`.

| JSON representation |
|---|
| ``` { "fieldMask": string, "membershipRole": { object (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/groups.memberships#MembershipRole`) } } ``` |

| Fields ||
|---|---|
| `fieldMask` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#field-mask` format)`` The fully-qualified names of fields to update. May only contain the field `expiry_detail.expire_time`. This is a comma-separated list of fully qualified names of fields. Example: `"user.displayName,photo"`. |
| `membershipRole` | ``object (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/groups.memberships#MembershipRole`)`` The `MembershipRole`s to be updated. Only `MEMBER` `MembershipRole` can currently be updated. |