Replace Member Roles

Required scope: member_roles:update

This operation replaces the complete role assignment, not the member’s team memberships. At least one role is required. The API key creator must be allowed to delegate both the member’s current roles and all proposed roles. The last workspace owner cannot be removed.

Generated Reference

POST /public-api/publicapi.v1.Member/ReplaceMemberRoles

Replaces all roles assigned to a member. Team memberships are unchanged.

Request ReplaceMemberRolesRequest

Response ReplaceMemberRolesResponse

ReplaceMemberRolesRequest

Field	Type
member_id	string
role_ids	repeated string

ReplaceMemberRolesResponse

Field	Type
member	Member

Related Types

Member

Field	Type
id	string
account_id	string
email	string
first_name	string
last_name	string
roles	repeated RoleReference
teams	repeated TeamReference
created_at	int64
updated_at	int64

RoleReference

Field	Type
id	string
name	string

TeamReference

Field	Type
id	string
name	string

Request

{
  "memberId": "<member-id>",
  "roleIds": ["<role-id>"]
}

The member’s effective authorization is recalculated after success. Do not blindly retry a timed-out mutation.