Team

Manage the account team: list members and pending invitations, invite someone by email with their projects and access, revoke an invitation or remove a member. The same rules as the Team Members settings page apply. Not available to an API key limited to some projects.

GET/team_members

The account owner first, then every member who joined, with their access level (permission_role, account_role and the resulting permissions), co-owner (account_admin) and billing_access flags, project access, status (active or blocked), last_sign_in_at and joined_at. Available to the account owner, co-owners and team members with the Team Members permission. Also available as the MCP tool list_team_members.

Params:
  • page
  • per_pagedefault 20, max 100

GET/team_invitations

Invitations not accepted yet, with the access and projects they grant, invited_at and expires_at. An accepted invitation keeps its id and moves to GET /team_members. Also available as the MCP tool list_team_invitations.

Params:
  • page
  • per_pagedefault 20, max 100

POST/team_invitations

Invite someone by email with the same rules as the Team Members settings page; they receive the invitation email (email_sent is false if the email provider refused it). The account owner and co-owners choose the access. A team member allowed to invite cannot: the invitation copies their own permissions. Only the account owner can grant co-owner or billing access. An address already registered, or with a pending invitation, is refused with ERR_INVALID_PARAM, and an account that cannot add more team members, or that reached its daily limit of invitations sent through the API and MCP (revoked ones count), gets ERR_LIMIT_REACHED. Requires a read_write scope key. Also available as the MCP tool invite_team_member.

  • Body (JSON): email (required), project_ids (array) or all_projects: true (one of them is required), permission_role (full_access by default, view_only, custom or account_role), permissions (with custom: feature key to verbs, for example {"prompts": ["read", "create"]}), account_role_id (with account_role), account_admin and billing_access (booleans, account owner only).

DELETE/team_invitations/:id

Revoke a pending invitation: its link stops working at once. Account owner or co-owner only; a co-owner cannot revoke an invitation that would make someone a co-owner. Requires a read_write scope key. Also available as the MCP tool revoke_team_invitation.

Path:
  • :idinvitation id

Returns ERR_NOT_FOUND for an id that is not a pending invitation of the account.

DELETE/team_members/:id

Remove a member from the team: their sessions and API keys stop working at once and their user is deleted shortly after. Account owner or co-owner only; a co-owner cannot remove the owner, another co-owner or themselves. Requires a read_write scope key. Also available as the MCP tool remove_team_member.

Path:
  • :idmember id

Returns ERR_NOT_FOUND for an id that is not a member of the account, including the owner and pending invitations.