Members
Manage workspace members, roles, invitations, and groups.
15 tools
# list_members
List workspace members
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| limit | integer | — | Max results |
| offset | integer | — | Offset |
# update_member_role
Change a member's role. Owners and admins only. Admins can't change owners or other admins, and can't grant admin. The last owner can't be demoted.
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| string | ● | Member email | |
| role | string | ● | New role (admin|member|guest) |
# remove_member
Deactivate a workspace member. Owners and admins only. Admins can't remove owners or other admins. The last owner can't be removed.
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| string | ● | Member email |
# leave_workspace
Leave a workspace you are a member of. Acts on the calling user — it takes no email, so it can never remove anyone else. The last owner cannot leave.
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
# invite_user
Email an invitation to join the workspace. Owners can invite admins, members and guests. Admins can invite members and guests. Returns the invitation ID, email, role and expiry date.
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| string | ● | Invitee email | |
| role | string | — | Role (admin|member|guest, default: member) |
# list_invitations
List pending workspace invitations. Owners and admins only. Returns the invitation ID, email, role, send date, expiry date and whether it has expired. The invitation token is never returned.
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| limit | integer | — | Max results |
| offset | integer | — | Offset |
# revoke_invitation
Revoke a pending invitation. Owners and admins only; admins can't revoke an admin-role invitation. The invite link stops working immediately.
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| invitation_id | string | ● | Invitation ID (UUID, from list_invitations) |
# resend_invitation
Re-send a pending invitation: a fresh link, a new seven-day expiry, and another email. The old link stops working. Owners and admins only.
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| invitation_id | string | ● | Invitation ID (UUID, from list_invitations) |
# list_groups
List user groups in the workspace
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
# create_group
Create a user group
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| name | string | ● | Group name |
| description | string | — | Description |
# update_group
Update a group's name or description
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| group_id | string | ● | Group ID (UUID) |
| name | string | ● | Group name |
| description | string | — | Description |
# delete_group
Delete a user group
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| group_id | string | ● | Group ID (UUID) |
# list_group_members
List the members of a group
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| group_id | string | ● | Group ID (UUID) |
# add_group_member
Add a member to a group
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| group_id | string | ● | Group ID (UUID) |
| string | ● | Member email |
# remove_group_member
Remove a member from a group
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| group_id | string | ● | Group ID (UUID) |
| string | ● | Member email |