Docs: Tool reference
admin toolset

remove_member

Remove a member. Removes a member from the workspace. They lose admin and MCP access immediately; their posts, comments and audit history stay. They can be invited again later. The last owner can't be removed. Destructive: pass confirm: true, or dry_run: true to preview. No email is sent. Owners only. Returns the member as they were.

Toolset
admin
Who can call it
Owners
REST
DELETE /api/v1/w/{workspace}/members/{member}
Behavior
changes datadestructive (confirm: true, dry_run)

Input

FieldTypeDescription
memberrequiredstringThe member's ID (mem_…) or email address.
expected_versionintegerThe member's version from list_members. If it changed since, the call fails instead of overwriting a newer change.
confirmbooleanMust be true to perform this destructive action, unless dry_run is true.
dry_runbooleanPreview the result without changing anything.

Output

FieldTypeDescription
idrequiredstringID with prefix "mem_"
workspace_idrequiredstringID with prefix "ws_"
account_idrequiredstringID with prefix "acc_"
emailrequiredstring (email)
rolerequiredone of: owner, manager, contributor
display_namerequiredstring
versionrequiredinteger
created_atrequiredstring (date-time)
updated_atrequiredstring (date-time)

Calling it

// MCP: tools/call
{ "name": "remove_member", "arguments": {"member":"<string>"} }

// Typed client
await carechannel.remove_member({"member":"<string>"});