Docs: Tool reference
admin toolset

update_member_role

Change a member's role. Changes a member's role to owner, manager or contributor; it takes effect on their next request. Owners manage members, settings and security; managers configure and triage; contributors post, tag and draft. The last owner can't be demoted. Destructive: pass confirm: true, or dry_run: true to preview. No email is sent. Owners only.

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

Input

FieldTypeDescription
memberrequiredstringThe member's ID (mem_…) or email address.
rolerequiredone of: owner, manager, contributor
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": "update_member_role", "arguments": {"member":"<string>","role":"<one of: owner, manager, contributor>"} }

// Typed client
await carechannel.update_member_role({"member":"<string>","role":"<one of: owner, manager, contributor>"});