Skip to main content
Update Member
Edits a member, with two capability tiers by field sensitivity:
  • Powerful fields (capabilities, permissions, rank) require edit-member-access, plus the rank rule and the no-escalation guard.
  • Cosmetic fields (title, metadata) require only edit-member-profile. A member editing their own title needs no capability.
Grant vs strip asymmetry: you may only add a capability/permission you hold on the target node (resolved set, including via reach); stripping is governed by rank alone. Cross-node rank is not compared — the rank guard runs only when actor and target share a member row on the same workspace.

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