Appearance
Team Invitations
Invite team members to your GhostAI organization with role-based access control.
Inviting Members
Via Admin Dashboard
- Open Admin Dashboard → Users
- Click the Invite button in the header
- Enter email addresses (one per line, or paste comma-separated lists)
- 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
- Optionally add a personal welcome message
- Preview the invitation email
- 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 link and FRONTEND_URL
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
| State | Description | Duration |
|---|---|---|
| Pending | Invite sent, awaiting acceptance | Up to 7 days |
| Accepted | User joined the organization | — |
| Expired | TTL exceeded (7 days) | Auto-expired |
| Cancelled | Admin cancelled the invite | — |
| Declined | Invitee 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:
| Tier | Seats |
|---|---|
| Starter | 1 |
| Personal | 1 |
| Team | 10 |
| Business | 50 |
| Enterprise | Unlimited |
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,viewerJSON 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
| Endpoint | Method | Description |
|---|---|---|
/api/organizations/{id}/members | POST | Invite a member |
/api/organizations/{id}/members/{mid} | DELETE | Cancel or remove |
/api/organizations/{id}/members/{mid}/resend | POST | Resend invite |
/api/organizations/{id}/invites/accept | POST | Accept invite |
/api/organizations/{id}/invites/decline | POST | Decline invite |
/api/organizations/{id}/seat-info | GET | Seat usage |