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

Paramètres :
  • page
  • per_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.

Paramètres :
  • page
  • per_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) ou all_projects: true (l’un des deux est obligatoire), permission_role (full_access par défaut, view_only, custom ou account_role), permissions (avec custom : chaque clé de fonctionnalité et ses verbes, par exemple {"prompts": ["read", "create"]}), account_role_id (avec account_role), account_admin et billing_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.

Chemin :
  • :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.

Chemin :
  • :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.