DocumentationAPI reference
Members
The workspace’s members, their roles and the invitations.
Every operation below is also an MCP tool, under the same name. Free operations cost nothing; Billed ones use the workspace’s credits, as in the app (What it costs).
| Operation | Call | |
|---|---|---|
| List members | GET /workspace/members | Free |
| List invitations | GET /workspace/invitations | Free |
| Invite member | POST /workspace/invitations | Free |
| Cancel invitation | DELETE /workspace/invitations/{invitationId} | Free |
| Update member | PATCH /workspace/members/{userId} | Free |
| Remove member | DELETE /workspace/members/{userId} | Free |
List members
/workspace/membersFreeThe members of the workspace and their role.
MCP tool list_members
curl https://app.semchat.io/api/v1/workspace/members \
-H "Authorization: Bearer sk_live_…"{
"data": [
{
"user_id": "01995d03-8ea0-7e30-9bc8-4a6a79a79b4f",
"name": "Olivia Owner",
"email": "owner@example.com",
"role": "owner",
"joined_at": "2025-09-18T13:28:58.000Z"
},
{
"user_id": "01995d05-6360-74e9-8aa2-63377289227a",
"name": "Adam Admin",
"email": "admin@example.com",
"role": "admin",
"joined_at": "2026-07-15T13:26:58.000Z"
}
]
}List invitations
/workspace/invitationsFreeThe workspace’s pending invitations.
- Owner or admin only (the role of the key’s creator): 403 FORBIDDEN otherwise.
MCP tool list_invitations
curl https://app.semchat.io/api/v1/workspace/invitations \
-H "Authorization: Bearer sk_live_…"Answers 200 with { "data": … }.
Invite member
/workspace/invitationsFreeInvite someone to the workspace by email: they receive the invitation email, valid 7 days.
- Owner or admin only (the role of the key’s creator): 403 FORBIDDEN otherwise.
- 409 CONFLICT when the email is already a member or already invited.
MCP tool invite_member
| Argument | Type | Description |
|---|---|---|
emailrequired | string | |
rolerequired | string | admin or member (default).admin | member |
curl -X POST https://app.semchat.io/api/v1/workspace/invitations \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"email": "name@example.com", "role": "admin"}'Answers 201 with { "data": … }.
Cancel invitation
/workspace/invitations/{invitationId}FreeCancel an invitation: its link stops working.
- Owner or admin only (the role of the key’s creator): 403 FORBIDDEN otherwise.
MCP tool cancel_invitation
| Argument | Type | Description |
|---|---|---|
invitationIdin the path | string | Its id. |
curl -X DELETE https://app.semchat.io/api/v1/workspace/invitations/{invitationId} \
-H "Authorization: Bearer sk_live_…"Answers 200 with { "data": … }.
Update member
/workspace/members/{userId}FreeChange a member’s role (admin or member).
- Owner or admin only (the role of the key’s creator): 403 FORBIDDEN otherwise.
- userId as list_members shows it. The owner’s role can’t be changed.
MCP tool update_member
| Argument | Type | Description |
|---|---|---|
userIdin the path | string | Its id. |
rolerequired | string | admin | member |
curl -X PATCH https://app.semchat.io/api/v1/workspace/members/{userId} \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"role": "admin"}'Answers 200 with { "data": … }.
Remove member
/workspace/members/{userId}FreeRemove a member from the workspace.
- Owner or admin, except to remove yourself (the key’s creator leaves the workspace). The owner can’t be removed.
MCP tool remove_member
| Argument | Type | Description |
|---|---|---|
userIdin the path | string | Its id. |
curl -X DELETE https://app.semchat.io/api/v1/workspace/members/{userId} \
-H "Authorization: Bearer sk_live_…"Answers 200 with { "data": … }.
A question this doesn’t answer? Write to us.

