Skip to content

Team Invitations ​

Invite team members to your GhostAI organization with role-based access control.

Inviting Members ​

Via Admin Dashboard ​

  1. Open Admin Dashboard → Users
  2. Click the Invite button in the header
  3. Enter email addresses (one per line, or paste comma-separated lists)
  4. Select a role for each invitee:
    • Admin — Manage users, settings, billing
    • Member — Use all features, upload files, view reports
    • Viewer — Read-only access to conversations and reports
  5. Optionally add a personal welcome message
  6. Preview the invitation email
  7. Click Send Invites

Via API ​

bash
curl -X POST https://api.ghostai.com/api/organizations/{org_id}/members \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "newuser@company.com",
    "role": "member",
    "message": "Welcome to the team!"
  }'

Invite emails contain a link like https://your-app.com/invite?token=.... The backend uses the FRONTEND_URL environment variable to build this link. Ensure FRONTEND_URL is set to the public URL users will use (e.g. https://app.ghostai.com). If it points to an internal host or localhost, invitees will not be able to open the link.

Invite Lifecycle ​

StateDescriptionDuration
PendingInvite sent, awaiting acceptanceUp to 7 days
AcceptedUser joined the organization—
ExpiredTTL exceeded (7 days)Auto-expired
CancelledAdmin cancelled the invite—
DeclinedInvitee declined—

Auto-Expiration ​

Invites automatically expire after 7 days. A background scheduler runs every 6 hours to clean up expired invites.

Auto-Accept on Signup ​

When a user creates an account or logs in, any pending invites matching their email are automatically linked. The user is added to the organization without needing to click the invite link.

Signup feedback ​

Team Join links (/join?code=...) keep invitees on the signup screen after submission and show the result inline. Successful signups display the backend's verification instructions when email verification is required, or explain that the user can click Join Organization next when a session is created immediately. Failed signups display the returned error detail so the invitee can correct the problem or retry.

Managing Pending Invites ​

Resend an Invite ​

From Users, click Resend on any pending invite row. A fresh email is sent with a new expiration date.

Cancel an Invite ​

Click Cancel on a pending invite row, or use the batch actions in Team → Pending Invites.

Batch Actions ​

In Admin Dashboard → Team → Pending Invites:

  • Select multiple invites with checkboxes
  • Click Resend All or Cancel All

Seat Enforcement ​

GhostAI enforces seat limits based on your subscription tier:

TierSeats
Starter1
Personal1
Team10
Business50
EnterpriseUnlimited

When approaching or at your seat limit, the invite modal shows a warning with an upgrade link.

Bulk User Import (CSV/JSON) ​

You can import many users at once from a file. The format is documented here so you can prepare your file before selecting it.

CSV format ​

  • Required header row with at least: email
  • Optional columns: name, role
  • Role must be one of: owner, admin, member, viewer (default: member)
  • One row per user; duplicate emails in the file are skipped after the first

Example:

csv
email,name,role
jane@example.com,Jane Doe,member
bob@example.com,Bob Smith,admin
alice@example.com,Alice,viewer

JSON format ​

Either an object with a users array, or an array of user objects. Each user must have email; name and role are optional.

Example (object with users):

json
{
  "users": [
    { "email": "jane@example.com", "name": "Jane Doe", "role": "member" },
    { "email": "bob@example.com", "name": "Bob Smith", "role": "admin" }
  ]
}

Example (array only):

json
[
  { "email": "jane@example.com", "name": "Jane Doe", "role": "member" },
  { "email": "bob@example.com", "role": "admin" }
]

After import, users can be sent invitation emails (default) or added without email (e.g. for SCIM-synced users). Existing members (by email) are skipped.

Multi-Email Support ​

The invite modal supports several input methods:

  • Type individual emails
  • Paste comma-separated lists (e.g., from a spreadsheet)
  • Paste CSV-formatted data
  • Mix and match — duplicate emails are automatically deduplicated

API Reference ​

EndpointMethodDescription
/api/organizations/{id}/membersPOSTInvite a member
/api/organizations/{id}/members/{mid}DELETECancel or remove
/api/organizations/{id}/members/{mid}/resendPOSTResend invite
/api/organizations/{id}/invites/acceptPOSTAccept invite
/api/organizations/{id}/invites/declinePOSTDecline invite
/api/organizations/{id}/seat-infoGETSeat usage

SOC 2 Type II Certified | BAA Available | HIPAA-Ready