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

OperationAufruf
Mitglieder auflistenGET /workspace/membersKostenlos
Einladungen auflistenGET /workspace/invitationsKostenlos
Mitglied einladenPOST /workspace/invitationsKostenlos
Einladung zurückziehenDELETE /workspace/invitations/{invitationId}Kostenlos
Mitglied ändernPATCH /workspace/members/{userId}Kostenlos
Mitglied entfernenDELETE /workspace/members/{userId}Kostenlos

Mitglieder auflisten

GET/workspace/membersKostenlos

Die Mitglieder des Workspaces und ihre Rolle.

MCP-Tool list_members

Anfrage
curl https://app.semchat.io/api/v1/workspace/members \
  -H "Authorization: Bearer sk_live_…"
Antwort · 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"
    }
  ]
}

Einladungen auflisten

GET/workspace/invitationsKostenlos

Die offenen Einladungen des Workspaces.

  • Nur Inhaber oder Administrator (die Rolle dessen, der den Schlüssel erstellt hat): sonst 403 FORBIDDEN.

MCP-Tool list_invitations

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

Antwortet 200 mit { "data": … }.

Mitglied einladen

POST/workspace/invitationsKostenlos

Jemanden 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

ArgumentTypBeschreibung
emailerforderlichstring
roleerforderlichstringadmin oder member (Standard).admin | member
Anfrage
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

DELETE/workspace/invitations/{invitationId}Kostenlos

Eine 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

ArgumentTypBeschreibung
invitationIdim PfadstringDie ID.
Anfrage
curl -X DELETE https://app.semchat.io/api/v1/workspace/invitations/{invitationId} \
  -H "Authorization: Bearer sk_live_…"

Antwortet 200 mit { "data": … }.

Mitglied ändern

PATCH/workspace/members/{userId}Kostenlos

Die 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

ArgumentTypBeschreibung
userIdim PfadstringDie ID.
roleerforderlichstringadmin | member
Anfrage
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

DELETE/workspace/members/{userId}Kostenlos

Ein 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

ArgumentTypBeschreibung
userIdim PfadstringDie ID.
Anfrage
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.

Bereit, Ihrer Website Aufschwung zu geben?

Stellen Sie Ihre erste Frage - semchat antwortet in Sekunden mit einem klaren Aktionsplan.

Kostenlos · ohne Anmeldung · in 5 Sekunden