Team

Invite a team member

Changed on

Invites someone to the account team with the same rules as the Team Members settings page, and sends them the invitation email (email_sent is false when the email provider refused it; the invitation still exists, so revoke it and invite again once the address is fixed). Send project_ids, or all_projects: true for every project (for a team member inviting, every project they can access). The account owner and co-owners choose the access with permission_role: full_access (default), view_only, custom (with permissions, feature key to verbs) or account_role (with account_role_id). A team member with permission to invite cannot choose access: leave those fields out and the invitation copies their own permissions. Only the account owner can set account_admin (co-owner) or billing_access. An address already registered on the platform, or with an invitation pending, is refused with ERR_INVALID_PARAM (revoke the pending one first). 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), answers ERR_LIMIT_REACHED; the message says which. Requires a read_write scope API key.

post/team_invitations

Request

  • Base URL
    https://api.llmpulse.ai/api/v1
  • URL
    https://api.llmpulse.ai/api/v1/team_invitations
  • Auth
    API key in header Authorization

Request body

emailstring required
project_idsinteger[]

Projects the member can access. Send this or all_projects true.

all_projectsboolean

Access to every project, including future ones

permission_role'full_access' | 'view_only' | 'custom' | 'account_role'

Default full_access. Owner and co-owners only.

account_role_idinteger

One of the account's roles, with permission_role account_role

permissionsobject

With permission_role custom: feature key to the verbs granted (read, create, update, delete), for example {"overview": ["read"], "prompts": ["read", "create"]}

account_adminboolean

Make the member a co-owner. Account owner only.

billing_accessboolean

Access to Billing and Plans. Account owner only.

Response

Created. The invitation, as GET /team_invitations lists it, and whether the email went out.

idinteger required

Kept by the member once they accept, when they move to GET /team_members.

emailstring required
permission_role'full_access' | 'view_only' | 'custom' | 'account_role' required
permissionsTeamPermissions nullable required

What the person can do, feature key to the verbs granted (read, create, update, delete), resolved from their role. Null for the account owner, who can do everything.

account_adminboolean required
billing_accessboolean required
all_projectsboolean required
project_idsinteger[] required
invited_atstring date-time nullable

When the invitation email was last sent.

expires_atstring date-time nullable

When the invitation link stops working.

created_atstring date-time
email_sentboolean required

False when the email provider refused the invitation email

request_idstring

Changes