Skip to main content

Overview

useUpdateWorkspaceMember returns a callable that edits a direct member of a workspace. Authorization: capability-gated + rank-bounded, in two 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 at all.
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.

Usage Example

Parameters

string
required
The workspace UUID.
string
required
The target member’s user id — a path param, not an acting user.
WorkspaceCapability[]
New capability set (powerful — edit-member-access).
string[]
New opaque permission set (powerful — edit-member-access).
number
New rank (powerful — edit-member-access + rank rules).
string | null
New cosmetic title (edit-member-profile, or self for your own title).
Record<string, any>
New cosmetic metadata (edit-member-profile).

Returns

Returns the updated WorkspaceMember object.

Error codes