Skip to main content

Team

Read your workspace roster and manage members. Member-management tools are admin-only and require an admin code; they preview before running.

note

These tools can only manage members. They can never grant admin, and refuse to touch an existing admin. Removing a member is a soft-remove.


list_workspace_members​

List this workspace's members (roster with roles + profiles).

Returns​

{ members: [{ userId, role, email, displayName, ... }] }.

Example prompt​

"Who's on my workspace?"


invite_user​

Invite an email into this workspace as a member (role is always member). Existing accounts are added directly; otherwise a pending invite is created.

Parameters​

NameTypeRequiredDescription
emailstringYesEmail to invite
admin_codestringYesWorkspace admin code

Returns​

{ ok, status, inviteId, memberCreated }.


cancel_invite​

Cancel a pending invite.

Parameters​

NameTypeRequiredDescription
invite_idstringYesThe pending invite id
admin_codestringYesWorkspace admin code

Returns​

{ ok, status }.


remove_member​

Soft-remove a member. Refuses to remove an admin (backend 403).

Parameters​

NameTypeRequiredDescription
uidstringYesThe member's user id
admin_codestringYesWorkspace admin code

Returns​

{ ok, status }.


change_member_role​

Set a member's role. Only "member" is accepted (granting "admin" is rejected; an existing admin can never be modified).

Parameters​

NameTypeRequiredDescription
uidstringYesThe member's user id
rolestringYesMust be "member"
admin_codestringYesWorkspace admin code

Returns​

{ ok, status }.