Manage workspace members
manage_membersAdmin-only membership controls. list returns members and pending invites. invite adds/renews an email invite (default member; existing members refused); email_sent reports best-effort delivery. resend_invite renews by invite_id; revoke_invite withdraws. set_role supports admin/manager/member/viewer, never demotes the last admin. set_manager sets/clears a manager, rejecting self-reporting and cycles. set_read_scope uses own/team/all/null (role default), optionally include_reports; cannot restrict admins. remove cannot target yourself or the last admin; records remain. Except list/revoke_invite, actions preview the person/change until confirm:true. This connection is bound to one membership; leave/switch your own workspace in the browser.
When to use: An admin manages membership, invitations or an individual's access.
Example: Invite sara@brightside.example as a manager.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role | No | invite (default member) and set_role: admin, manager, member or viewer. | |
| No | invite: the address to invite (lower-cased and trimmed). | ||
| action | Yes | list, invite, resend_invite, revoke_invite, set_role, set_manager, set_read_scope or remove. One of: list | invite | resend_invite | revoke_invite | set_role | set_manager | set_read_scope | remove. | |
| confirm | No | invite / resend_invite / set_role / set_manager / remove: true carries the change out; omitted or false returns the preview and changes nothing. | |
| user_id | No | set_role / set_manager / remove: the member's user_id from a list call. | |
| invite_id | No | resend_invite / revoke_invite: the pending invite's id from a list call. | |
| manager_id | No | set_manager: the manager's user_id, or null to clear the reporting line. | |
| read_scope | No | set_read_scope: own, team, all, or null to follow the role's setting. | |
| include_reports | No | set_read_scope: also everyone reporting up to this member. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| action | No | ||
| invite | No | ||
| member | No | ||
| applied | No | ||
| invites | No | ||
| members | No | ||
| email_sent | No | ||
| requires_confirm | No |