Team

Verwalten Sie das Team des Kontos: Mitglieder und ausstehende Einladungen auflisten, eine Person per E-Mail einladen und ihr Projekte und Zugriffsrechte zuweisen, eine Einladung widerrufen oder ein Mitglied entfernen. Es gelten dieselben Regeln wie auf der Einstellungsseite „Teammitglieder“. Für API-Schlüssel, die auf bestimmte Projekte beschränkt sind, nicht verfügbar.

GET/team_members

Zuerst der Kontoinhaber, dann alle Mitglieder, die dem Team beigetreten sind, jeweils mit ihrer Zugriffsebene (permission_role, account_role und den daraus resultierenden permissions), den Kennzeichen für Konto-Admin (account_admin) und billing_access, dem Projektzugriff, status (active oder blocked), last_sign_in_at und joined_at. Verfügbar für den Kontoinhaber, Konto-Admins und Teammitglieder mit der Berechtigung für Teammitglieder. Auch als MCP-Tool list_team_members verfügbar.

Parameter:
  • page
  • per_pageStandard: 20, maximal 100

GET/team_invitations

Noch nicht angenommene Einladungen mit den Zugriffsrechten und Projekten, die sie gewähren, sowie invited_at und expires_at. Eine angenommene Einladung behält ihre ID und erscheint danach unter GET /team_members. Auch als MCP-Tool list_team_invitations verfügbar.

Parameter:
  • page
  • per_pageStandard: 20, maximal 100

POST/team_invitations

Lädt eine Person per E-Mail ein. Es gelten dieselben Regeln wie auf der Einstellungsseite „Teammitglieder“. Die eingeladene Person erhält die Einladungs-E-Mail (email_sent ist false, wenn der E-Mail-Versanddienst sie abgelehnt hat). Die Zugriffsrechte legen der Kontoinhaber und die Konto-Admins fest. Ein Teammitglied, das einladen darf, kann die Zugriffsrechte nicht festlegen: Die Einladung übernimmt die Berechtigungen der einladenden Person. Nur der Kontoinhaber kann die Rolle Konto-Admin oder den Zugriff auf Tarife & Abrechnung vergeben. Eine Adresse, die bereits registriert ist oder für die eine Einladung aussteht, wird mit ERR_INVALID_PARAM abgelehnt. Ein Konto, das keine weiteren Teammitglieder hinzufügen kann oder sein Tageslimit für Einladungen über die API und MCP erreicht hat (widerrufene Einladungen zählen mit), erhält ERR_LIMIT_REACHED. Erfordert einen Schlüssel mit dem Zugriffsumfang read_write. Auch als MCP-Tool invite_team_member verfügbar.

  • Anfragetext (JSON): email (erforderlich), project_ids (Array) oder all_projects: true (eines davon ist erforderlich), permission_role (full_access als Standard, view_only, custom oder account_role), permissions (mit custom: Zuordnung von Funktionsschlüsseln zu Verben, zum Beispiel {"prompts": ["read", "create"]}), account_role_id (mit account_role), account_admin und billing_access (boolesche Werte, darf nur der Kontoinhaber senden).

DELETE/team_invitations/:id

Widerruft eine ausstehende Einladung: Der Einladungslink funktioniert sofort nicht mehr. Einladungen widerrufen dürfen nur der Kontoinhaber und Konto-Admins; ein Konto-Admin kann keine Einladung widerrufen, durch die jemand Konto-Admin würde. Erfordert einen Schlüssel mit dem Zugriffsumfang read_write. Auch als MCP-Tool revoke_team_invitation verfügbar.

Pfad:
  • :idID der Einladung

Gibt ERR_NOT_FOUND zurück, wenn die ID zu keiner ausstehenden Einladung des Kontos gehört.

DELETE/team_members/:id

Entfernt ein Mitglied aus dem Team: Seine Sitzungen und API-Schlüssel funktionieren sofort nicht mehr, und sein Konto wird kurz darauf gelöscht. Mitglieder entfernen dürfen nur der Kontoinhaber und Konto-Admins; ein Konto-Admin kann dabei weder den Kontoinhaber noch einen anderen Konto-Admin noch sich selbst entfernen. Erfordert einen Schlüssel mit dem Zugriffsumfang read_write. Auch als MCP-Tool remove_team_member verfügbar.

Pfad:
  • :idID des Mitglieds

Gibt ERR_NOT_FOUND zurück, wenn die ID zu keinem Mitglied des Kontos gehört; das gilt auch für den Kontoinhaber und für ausstehende Einladungen.