Skip to content

Team Settings ​

The Team Settings panel in the Admin Dashboard provides a comprehensive suite of tools for managing your organization's team configuration.

Accessing Team Settings ​

  1. Open Admin Dashboard from the sidebar
  2. Select Team in the sidebar

Sub-Tabs ​

Pending Invites ​

View and manage all pending invitations:

  • See invite recipient, role, status, and expiry date
  • Resend individual invites or use Resend All
  • Cancel individual invites or use Cancel All
  • Pending count badge appears on Team

Allowed Domains ​

Configure email domains for automatic team membership:

  1. Click Add Domain
  2. Enter the domain (e.g., company.com)
  3. Toggle Auto-Join to automatically add users with matching emails
  4. Click Verify to verify domain ownership via DNS TXT record

Domain Verification

Add a TXT record to your DNS with the verification code shown in the UI. GhostAI checks for this record and marks the domain as verified.

Create shareable team join URLs:

  1. Click Create Link
  2. Configure:
    • Role — Default role for users who join via this link
    • Expiry — How long the link remains active
    • Max Uses — Maximum number of times the link can be used
    • Require Approval — Require admin approval before users join
  3. Copy the generated link and share via Slack, email, or documentation

Join Requests: When approval is required, pending requests appear in this tab. Click Approve or Deny for each request.

Welcome Message ​

Customize the message new members see when they join:

  1. Enter your welcome message in the editor
  2. Use the Live Preview to see how it will appear
  3. Click Save

Setup Checklist ​

Note: The Setup Checklist has been promoted out of Team Settings. It is now available in two places:

  1. Setup — A dedicated top-level item in the Admin Dashboard sidebar with a detailed step-by-step view, descriptions for each step, and a progress summary card.
  2. Banner — A dismissible banner at the very top of the Admin Dashboard showing a compact progress bar with incomplete-step pills for at-a-glance visibility. The banner auto-hides at 100% completion or can be dismissed for the session.

See Dashboards & Analytics — Setup Checklist for full details.

SCIM ​

Connect your Identity Provider for automated user provisioning. See SCIM Provisioning for details.

Activity ​

Real-time feed of all team and administrative actions:

  • Color-coded by action type (invites, role changes, policy updates)
  • Human-readable labels
  • Relative timestamps (e.g., "2 hours ago")
  • Detailed information for each action

Leave an Organization ​

Open Organization Settings from the account menu. In the Danger Zone, choose Leave organization and type the organization name to confirm. Leaving permanently removes the authenticated user's membership and access; it does not delete the organization, the user's account, or the user's personal provider keys, which are scoped to the account rather than an individual organization. The action is recorded in the organization audit feed as member_left.

The organization owner cannot leave while they are the last owner. Transfer ownership first. Support/test users are ordinary tenant members, so the same self-leave flow applies to their seated tenant-admin membership.

Public Figure Reconciliation ​

Org Owners and Admins can manage Public Figure Reconciliation settings for the entire organization. This feature prevents well-known public figures from being incorrectly flagged as PII, while safety filters ensure that private individuals are never accidentally exposed.

Navigate to Settings → PII Detection → Public Figure Reconciliation to configure:

  • Enable/Disable — Toggle public figure reconciliation on or off for the organization
  • Resolution Tiers — Control which resolution methods are available:
    • Built-in — Matches against a curated list of ~5,000 known public figures (highest authority — can override multi-detector consensus)
    • Wikidata — Resolves names against the Wikidata knowledge base (blocked when 2+ detectors agree)
    • LLM — Uses the language model to assess whether a name is a public figure (blocked when 2+ detectors agree)
  • User Overrides — Toggle user_can_override_public_figure to allow or disallow individual users from adjusting public figure settings in their own sessions

Built-in Safety Filters (Always Active) ​

Even when public figure reconciliation is enabled, three safety filters run automatically to prevent false positives:

FilterProtection
Co-occurrence FilterIf correlated PII (email containing name, phone/SSN nearby) appears alongside a PERSON entity, reconciliation is blocked. Example: "Sarah Johnson" + sarah.johnson@acme.com → stays masked.
Multi-Detector Consensus GateWhen 2+ independent PII detectors (e.g., Presidio + NER) both flag a name, only the curated built-in list can override. Wikidata and LLM matches are blocked.
Confidence ThresholdEach tier has a minimum confidence score. Low-confidence matches are rejected.

These filters cannot be disabled — they are always active as a defense-in-depth measure.

TIP

Start with the Built-in tier for fastest performance, lowest latency, and strongest authority. The built-in list is the only tier that can override multi-detector consensus. Enable Wikidata or LLM tiers if your teams frequently reference lesser-known public figures that the built-in list does not cover.

Public Knowledge Reconciliation ​

Org Owners and Admins can also control Public Knowledge Reconciliation for non-person entities:

  • LOCATION
  • ORGANIZATION — built-in list is a curated set of well-known organizations; we do not use a registry of public companies (e.g. SEC or stock exchange).
  • EVENT
  • DATE_TIME (contextual)

Navigate to Settings → PII Detection → Public Knowledge Reconciliation to configure:

  • Enable/Disable — Organization-level master toggle
  • Entity Types — Select which entity classes are eligible
  • Resolution Tiers — builtin, wikidata, llm
  • User Overrides — Allow/disallow user-level changes

Privacy Warning for External Tiers ​

Enabling Wikidata or LLM tiers can transmit candidate entity text to external systems after safety filters run. For stricter environments, keep tiers set to ["builtin"] only.

RAG / File Intelligence Settings ​

The Admin Dashboard includes RAG / File Intelligence in the sidebar where administrators can configure retrieval settings for the organization:

  • Hybrid Search — Toggle BM25 + semantic search with Reciprocal Rank Fusion (on by default)
  • HNSW ANN — Enable approximate nearest neighbor for files with >100K chunks (on by default)
  • Chunk-Level PII Cache — Cache PII detection per chunk hash to avoid redundant scanning (on by default)
  • Streaming Ingestion — Stream large text files (>50 MB) into the index without full memory load (on by default)
  • Embedding Device — Select hardware for vector embeddings: Auto-detect, CPU, CUDA (NVIDIA), or MPS (Apple Silicon)
  • RAG Indexing Threshold — File size above which automatic chunking activates (default: 1 MB; 10 KB in comparison mode)
  • Streaming Threshold — File size above which streaming ingestion activates (default: 50 MB)

Note: In comparison mode, files >= 10 KB are automatically indexed for RAG to reduce payload duplication across 2-4 models. This threshold is not configurable and is separate from the standard 1 MB threshold above.

These settings are available under Admin Dashboard → RAG / File Intelligence.

Branding & Email Settings ​

Branding (Business and Enterprise tiers) allows customization of the organization's visual identity and email configuration:

  • Auto-Brand — One-click suggestion of company name, logo, and colors from your public website; review and apply in the Branding tab.
  • Logo — Upload dark/light mode logos for the sidebar and system emails
  • Brand Colors — Primary, secondary, and sidebar colors
  • Company Name — Displayed throughout the UI and in email subject lines
  • Email Footer Text — Custom footer appended to all system-generated emails
  • Email From Address — Per-org sender address for all transactional emails (magic links, invites, receipts, reports). Must be a domain verified in Resend. Leave blank to use the platform default (EMAIL_FROM_ADDRESS env var).
  • "Powered by GhostAI" — Toggle attribution badge (Enterprise only can disable)

These settings are available under Admin Dashboard → Branding.

API Reference ​

EndpointMethodDescription
/api/organizations/{id}/allowed-domainsGET/POSTDomain management
/api/organizations/{id}/allowed-domains/{did}/verifyPOSTVerify domain
/api/organizations/{id}/invite-linksGET/POSTInvite links
/api/organizations/{id}/joinPOSTJoin via link
/api/organizations/{id}/join-requestsGETList join requests
/api/organizations/{id}/join-requests/{rid}/reviewPOSTApprove/deny
/api/organizations/{id}/settingsGET/PUTWelcome message
/api/organizations/{id}/setup-progressGETSetup checklist
/api/admin/audit-logGETActivity feed

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