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.

Parámetros:
  • page
  • per_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.

Parámetros:
  • page
  • per_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) o all_projects: true (uno de los dos es obligatorio), permission_role (full_access por defecto, view_only, custom o account_role), permissions (con custom: cada clave de función con sus verbos, por ejemplo {"prompts": ["read", "create"]}), account_role_id (con account_role), account_admin y billing_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.

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

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