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.
pageper_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.
pageper_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) oderall_projects: true(eines davon ist erforderlich),permission_role(full_accessals Standard,view_only,customoderaccount_role),permissions(mitcustom: Zuordnung von Funktionsschlüsseln zu Verben, zum Beispiel{"prompts": ["read", "create"]}),account_role_id(mitaccount_role),account_adminundbilling_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.
: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.
: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.