Équipe
Gérez l’équipe du compte : listez les membres et les invitations en attente, invitez une personne par e-mail en choisissant ses projets et ses accès, révoquez une invitation ou retirez un membre. Les règles sont les mêmes que sur la page Membres de l’équipe des paramètres. Non disponible pour une clé API limitée à certains projets.
GET/team_members
Le propriétaire du compte d’abord, puis chaque membre ayant rejoint l’équipe, avec son niveau d’accès (permission_role, account_role et les permissions qui en découlent), les indicateurs copropriétaire (account_admin) et billing_access, l’accès aux projets, status (active ou blocked), last_sign_in_at et joined_at. Accessible au propriétaire du compte, aux copropriétaires et aux membres de l’équipe disposant de l’autorisation « Membres de l’équipe ». Également disponible via l’outil MCP list_team_members.
pageper_page20 par défaut, 100 maximum
GET/team_invitations
Invitations non encore acceptées, avec les accès et les projets qu’elles accordent, invited_at et expires_at. Une invitation acceptée conserve son identifiant et passe dans GET /team_members. Également disponible via l’outil MCP list_team_invitations.
pageper_page20 par défaut, 100 maximum
POST/team_invitations
Invite une personne par e-mail selon les mêmes règles que la page de paramètres « Membres de l’équipe » ; elle reçoit l’e-mail d’invitation (email_sent vaut false si le fournisseur d’e-mail l’a refusé). Le propriétaire du compte et les copropriétaires choisissent les accès. Un membre de l’équipe autorisé à inviter ne peut pas les choisir : l’invitation reprend ses propres autorisations. Seul le propriétaire du compte peut accorder le statut de copropriétaire ou l’accès à la facturation. Une adresse déjà inscrite, ou qui a une invitation en attente, est refusée avec ERR_INVALID_PARAM, et un compte qui ne peut plus ajouter de membres, ou qui a atteint sa limite quotidienne d’invitations envoyées via l’API et le MCP (les invitations révoquées comptent), reçoit ERR_LIMIT_REACHED. Nécessite une clé avec le scope read_write. Également disponible via l’outil MCP invite_team_member.
- Corps (JSON) :
email(obligatoire),project_ids(tableau) ouall_projects: true(l’un des deux est obligatoire),permission_role(full_accesspar défaut,view_only,customouaccount_role),permissions(aveccustom: chaque clé de fonctionnalité et ses verbes, par exemple{"prompts": ["read", "create"]}),account_role_id(avecaccount_role),account_adminetbilling_access(booléens, propriétaire du compte uniquement).
DELETE/team_invitations/:id
Révoque une invitation en attente : son lien cesse immédiatement de fonctionner. Réservé au propriétaire du compte ou à un copropriétaire ; un copropriétaire ne peut pas révoquer une invitation qui ferait de la personne invitée un copropriétaire. Nécessite une clé de portée read_write. Également disponible via l’outil MCP revoke_team_invitation.
:idID de l’invitation
Renvoie ERR_NOT_FOUND pour un ID qui ne correspond à aucune invitation en attente du compte.
DELETE/team_members/:id
Retire un membre de l’équipe : ses sessions et ses clés API cessent immédiatement de fonctionner, et son compte utilisateur est supprimé peu après. Réservé au propriétaire du compte ou à un copropriétaire ; un copropriétaire ne peut retirer ni le propriétaire, ni un autre copropriétaire, ni lui-même. Nécessite une clé de portée read_write. Également disponible via l’outil MCP remove_team_member.
:ididentifiant du membre
Renvoie ERR_NOT_FOUND pour un identifiant qui ne correspond à aucun membre du compte, notamment celui du propriétaire ou d’une invitation en attente.