v1

latestOpenAPI 3.0.42026-08-068161,1253.1 MB
Groups

Update Group Membership

Deprecated. Use AssignGroupRole and UnassignGroupRole instead. Updates the group membership for a particular group member. This action requires the requester to be able to manage lower ranked members. Guest or Owner ranks cannot be assigned, and a requester cannot change their own rank.

patch/cloud/v2/groups/{group_id}/memberships/{membership_id}

Path parameters

group_idstring required

The group ID.

membership_idstring required

The membership ID.

Request body

pathstring

The resource path of the group membership.

Format: groups/{group_id}/memberships/{group_membership_id}

createTimestring date-time

The timestamp when the group membership was created.

updateTimestring date-time

The timestamp when the group membership was last updated.

userstring

The resource path of a member of the group.

rolestring

The resource path of the member's highest-ranked role. When the member holds multiple roles, this reflects only the highest-ranked one. Prefer using the roles field, which always contains the complete set of assigned roles.

rolesstring[]

The resource paths of all roles assigned to the group member. This is the recommended field for reading a member's roles, as it always contains the complete set of roles held by the member.

Example request

{
  "path": "groups/123/memberships/123",
  "createTime": "2023-07-05T12:34:56Z",
  "updateTime": "2023-07-05T12:34:56Z",
  "user": "users/21557",
  "role": "groups/7/roles/99513316"
}

Response

OK

pathstring

The resource path of the group membership.

Format: groups/{group_id}/memberships/{group_membership_id}

createTimestring date-time

The timestamp when the group membership was created.

updateTimestring date-time

The timestamp when the group membership was last updated.

userstring

The resource path of a member of the group.

rolestring

The resource path of the member's highest-ranked role. When the member holds multiple roles, this reflects only the highest-ranked one. Prefer using the roles field, which always contains the complete set of assigned roles.

rolesstring[]

The resource paths of all roles assigned to the group member. This is the recommended field for reading a member's roles, as it always contains the complete set of roles held by the member.

Example response

{
  "path": "groups/123/memberships/123",
  "createTime": "2023-07-05T12:34:56Z",
  "updateTime": "2023-07-05T12:34:56Z",
  "user": "users/21557",
  "role": "groups/7/roles/99513316"
}