Update Member
Workspace — Membership
Update Member
Edit a member’s access or profile fields, with two capability tiers
Update Member
Edits a member, with two capability tiers by field sensitivity:
- Powerful fields (
capabilities,permissions,rank) requireedit-member-access, plus the rank rule and the no-escalation guard. - Cosmetic fields (
title,metadata) require onlyedit-member-profile. A member editing their owntitleneeds no capability.
Path Parameters
string
required
The workspace UUID.
string
required
The target member’s user id.
Body Parameters
All optional; the controller enforces which tier each touched field belongs to. At least one must be provided.string[]
New capability set (powerful —
edit-member-access).string[]
New permission set (powerful —
edit-member-access).number
New rank (powerful —
edit-member-access + rank rules).string
New cosmetic title (
edit-member-profile, or self for own title). Nullable.object
New cosmetic metadata (
edit-member-profile).string
Service/master keys only — the acting user (sent in the body; the path
:userId is the target).Response
Returns the updated WorkspaceMember object.Error Responses
Insufficient Rank — 403
Insufficient Rank — 403
No Escalation — 403
No Escalation — 403

