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).

OperationCall
List membersGET /workspace/membersFree
List invitationsGET /workspace/invitationsFree
Invite memberPOST /workspace/invitationsFree
Cancel invitationDELETE /workspace/invitations/{invitationId}Free
Update memberPATCH /workspace/members/{userId}Free
Remove memberDELETE /workspace/members/{userId}Free

List members

GET/workspace/membersFree

The members of the workspace and their role.

MCP tool list_members

Request
curl https://app.semchat.io/api/v1/workspace/members \
  -H "Authorization: Bearer sk_live_…"
Response · 200
{
  "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

GET/workspace/invitationsFree

The workspace’s pending invitations.

  • Owner or admin only (the role of the key’s creator): 403 FORBIDDEN otherwise.

MCP tool list_invitations

Request
curl https://app.semchat.io/api/v1/workspace/invitations \
  -H "Authorization: Bearer sk_live_…"

Answers 200 with { "data": … }.

Invite member

POST/workspace/invitationsFree

Invite 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

ArgumentTypeDescription
emailrequiredstring
rolerequiredstringadmin or member (default).admin | member
Request
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

DELETE/workspace/invitations/{invitationId}Free

Cancel an invitation: its link stops working.

  • Owner or admin only (the role of the key’s creator): 403 FORBIDDEN otherwise.

MCP tool cancel_invitation

ArgumentTypeDescription
invitationIdin the pathstringIts id.
Request
curl -X DELETE https://app.semchat.io/api/v1/workspace/invitations/{invitationId} \
  -H "Authorization: Bearer sk_live_…"

Answers 200 with { "data": … }.

Update member

PATCH/workspace/members/{userId}Free

Change 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

ArgumentTypeDescription
userIdin the pathstringIts id.
rolerequiredstringadmin | member
Request
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

DELETE/workspace/members/{userId}Free

Remove 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

ArgumentTypeDescription
userIdin the pathstringIts id.
Request
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.

Ready to get your site off the ground?

Ask your first question - semchat replies with a clear action plan in seconds.

Free · no sign-up · takes 5 seconds