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.
pageper_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.
pageper_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) orall_projects: true(one of them is required),permission_role(full_accessby default,view_only,customoraccount_role),permissions(withcustom: feature key to verbs, for example{"prompts": ["read", "create"]}),account_role_id(withaccount_role),account_adminandbilling_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.
: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.
:idmember id
Returns ERR_NOT_FOUND for an id that is not a member of the account, including the owner and pending invitations.