Equipo
Gestiona el equipo de la cuenta: consulta los miembros y las invitaciones pendientes, invita a alguien por correo electrónico con los proyectos y el acceso que tendrá, revoca una invitación o elimina a un miembro. Se aplican las mismas reglas que en la página de Miembros del equipo. No está disponible para una clave de API limitada a algunos proyectos.
GET/team_members
Primero el propietario de la cuenta y después todos los miembros que se han unido al equipo, con su nivel de acceso (permission_role, account_role y los permisos resultantes en permissions), los indicadores de copropietario (account_admin) y billing_access, el acceso a proyectos, status (active o blocked), last_sign_in_at y joined_at. Disponible para el propietario de la cuenta, los copropietarios y los miembros del equipo con el permiso Miembros del equipo. También disponible como herramienta MCP list_team_members.
pageper_pagepor defecto 20, máximo 100
GET/team_invitations
Invitaciones que todavía no se han aceptado, con el acceso y los proyectos que conceden, invited_at y expires_at. Una invitación aceptada conserva su id y pasa a aparecer en GET /team_members. También disponible como herramienta MCP list_team_invitations.
pageper_pagepor defecto 20, máximo 100
POST/team_invitations
Invita a alguien por correo electrónico con las mismas reglas que en la página de Miembros del equipo; la persona invitada recibe el correo de invitación (email_sent es false si el proveedor de correo lo ha rechazado). El propietario de la cuenta y los copropietarios eligen el acceso de la persona invitada. Un miembro del equipo con permiso para invitar no puede elegirlo: la invitación copia los permisos de quien invita. Solo el propietario de la cuenta puede conceder el acceso de copropietario o el acceso a Planes y facturación. Una dirección de correo ya registrada, o con una invitación pendiente, se rechaza con ERR_INVALID_PARAM, y una cuenta que no puede añadir más miembros del equipo, o que ha alcanzado su límite diario de invitaciones enviadas a través de la API y de MCP (las revocadas también cuentan), recibe ERR_LIMIT_REACHED. Requiere una clave de API con el ámbito read_write. También disponible como herramienta MCP invite_team_member.
- Cuerpo (JSON):
email(obligatorio),project_ids(array) oall_projects: true(uno de los dos es obligatorio),permission_role(full_accesspor defecto,view_only,customoaccount_role),permissions(concustom: cada clave de función con sus verbos, por ejemplo{"prompts": ["read", "create"]}),account_role_id(conaccount_role),account_adminybilling_access(booleanos, solo el propietario de la cuenta).
DELETE/team_invitations/:id
Revoca una invitación pendiente: el enlace de la invitación deja de funcionar de inmediato. Solo puede hacerlo el propietario de la cuenta o un copropietario; un copropietario no puede revocar una invitación que convertiría a alguien en copropietario. Requiere una clave de API con el ámbito read_write. También disponible como herramienta MCP revoke_team_invitation.
:idid de la invitación
Devuelve ERR_NOT_FOUND para un id que no sea el de una invitación pendiente de la cuenta.
DELETE/team_members/:id
Elimina a un miembro del equipo: sus sesiones y sus claves de API dejan de funcionar de inmediato y su usuario se elimina poco después. Solo puede hacerlo el propietario de la cuenta o un copropietario; un copropietario no puede eliminar al propietario, a otro copropietario ni a sí mismo. Requiere una clave de API con el ámbito read_write. También disponible como herramienta MCP remove_team_member.
:idid del miembro
Devuelve ERR_NOT_FOUND para un id que no sea el de un miembro de la cuenta, incluidos el del propietario y los de las invitaciones pendientes.