DokumentationAPI-Referenz
Mitglieder
Die Mitglieder des Workspaces, ihre Rollen und die Einladungen.
Jede Operation unten ist auch ein MCP-Tool mit demselben Namen. Operationen mit Kostenlos kosten nichts; Operationen mit Kostenpflichtig verbrauchen die Credits des Workspaces, wie in der App (Was es kostet).
| Operation | Aufruf | |
|---|---|---|
| Mitglieder auflisten | GET /workspace/members | Kostenlos |
| Einladungen auflisten | GET /workspace/invitations | Kostenlos |
| Mitglied einladen | POST /workspace/invitations | Kostenlos |
| Einladung zurückziehen | DELETE /workspace/invitations/{invitationId} | Kostenlos |
| Mitglied ändern | PATCH /workspace/members/{userId} | Kostenlos |
| Mitglied entfernen | DELETE /workspace/members/{userId} | Kostenlos |
Mitglieder auflisten
/workspace/membersKostenlosDie Mitglieder des Workspaces und ihre Rolle.
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"
}
]
}Einladungen auflisten
/workspace/invitationsKostenlosDie offenen Einladungen des Workspaces.
- Nur Inhaber oder Administrator (die Rolle dessen, der den Schlüssel erstellt hat): sonst 403 FORBIDDEN.
MCP-Tool list_invitations
curl https://app.semchat.io/api/v1/workspace/invitations \
-H "Authorization: Bearer sk_live_…"Antwortet 200 mit { "data": … }.
Mitglied einladen
/workspace/invitationsKostenlosJemanden per E-Mail in den Workspace einladen: Die Person erhält die Einladungs-E-Mail, die 7 Tage gültig ist.
- Nur Inhaber oder Administrator (die Rolle dessen, der den Schlüssel erstellt hat): sonst 403 FORBIDDEN.
- 409 CONFLICT, wenn die E-Mail-Adresse bereits Mitglied oder bereits eingeladen ist.
MCP-Tool invite_member
| Argument | Typ | Beschreibung |
|---|---|---|
emailerforderlich | string | |
roleerforderlich | string | admin oder member (Standard).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"}'Antwortet 201 mit { "data": … }.
Einladung zurückziehen
/workspace/invitations/{invitationId}KostenlosEine Einladung zurückziehen: Ihr Link funktioniert dann nicht mehr.
- Nur Inhaber oder Administrator (die Rolle dessen, der den Schlüssel erstellt hat): sonst 403 FORBIDDEN.
MCP-Tool cancel_invitation
| Argument | Typ | Beschreibung |
|---|---|---|
invitationIdim Pfad | string | Die ID. |
curl -X DELETE https://app.semchat.io/api/v1/workspace/invitations/{invitationId} \
-H "Authorization: Bearer sk_live_…"Antwortet 200 mit { "data": … }.
Mitglied ändern
/workspace/members/{userId}KostenlosDie Rolle eines Mitglieds ändern (admin oder member).
- Nur Inhaber oder Administrator (die Rolle dessen, der den Schlüssel erstellt hat): sonst 403 FORBIDDEN.
- userId, wie list_members sie anzeigt. Die Rolle des Inhabers lässt sich nicht ändern.
MCP-Tool update_member
| Argument | Typ | Beschreibung |
|---|---|---|
userIdim Pfad | string | Die ID. |
roleerforderlich | 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"}'Antwortet 200 mit { "data": … }.
Mitglied entfernen
/workspace/members/{userId}KostenlosEin Mitglied aus dem Workspace entfernen.
- Inhaber oder Administrator, außer Sie entfernen sich selbst (dann verlässt der Ersteller des Schlüssels den Workspace). Der Inhaber kann nicht entfernt werden.
MCP-Tool remove_member
| Argument | Typ | Beschreibung |
|---|---|---|
userIdim Pfad | string | Die ID. |
curl -X DELETE https://app.semchat.io/api/v1/workspace/members/{userId} \
-H "Authorization: Bearer sk_live_…"Antwortet 200 mit { "data": … }.
Keine Antwort auf Ihre Frage gefunden? Schreiben Sie uns.

