Docs: Tool reference
admin toolset

invite_member

Invite a member. Invites someone to join this workspace as an owner, manager or contributor. Emails them a link valid for 7 days unless notify is false. They must sign in with the invited email to accept. If they already have a pending invitation (even an expired one), it is renewed instead: new role, new link, new 7-day expiry; the old link stops working. Fails if they are already a member. Owners only.

Toolset
admin
Who can call it
Owners
REST
POST /api/v1/w/{workspace}/members/invitations
Behavior
changes dataaccepts idempotency_key

Input

FieldTypeDescription
emailrequiredstring
rolerequiredone of: owner, manager, contributor
notifybooleanSend the invitation email (default true). Default: true.
idempotency_keystringRetry-safe key. Repeating a call with the same key returns the first result.

Output

FieldTypeDescription
idrequiredstringID with prefix "inv_"
workspace_idrequiredstringID with prefix "ws_"
emailrequiredstring (email)
rolerequiredone of: owner, manager, contributor
invited_by_member_idrequiredstringID with prefix "mem_"
expires_atrequiredstring (date-time)
accepted_atrequiredstring (date-time) or null
revoked_atrequiredstring (date-time) or null
created_atrequiredstring (date-time)

Calling it

// MCP: tools/call
{ "name": "invite_member", "arguments": {"email":"<string>","role":"<one of: owner, manager, contributor>"} }

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