Skip to main content

Troubleshooting

Common Issues​

"Vector store not configured"​

Cause: No vector store settings for the current project.

Solution: Navigate to Settings > Vector Store and configure your preferred provider.

"Embedding API key not set"​

Cause: Missing API key for the embedding provider.

Solution: Go to Settings > Embedding Model and enter your API key.

Documents stuck in "Syncing" status​

Cause: The sync job may have been interrupted by a timeout or server restart.

Solution:

  1. Wait up to 1 hour — the system automatically detects interrupted jobs and resumes them (up to 3 times)
  2. Check the Sync Health panel on the Dashboard for error details
  3. If still stuck after 1 hour, the job will be automatically marked as failed — you can then re-sync the affected documents
  4. Check the document's error message in document statistics for specific failure reasons
info

The system checkpoints progress after each document, so completed documents are never lost during a recovery. See Sync Reliability & Recovery for details.

OAuth connection expired​

Cause: Access tokens for Confluence or Google Drive have expired.

Solution:

  1. Go to Sources
  2. Delete the expired connection
  3. Re-connect the source to refresh authentication

Chunks not appearing after sync​

Cause: Vector store initialization incomplete.

Solution:

  1. Go to Settings > Vector Store
  2. Click "Initialize Database" or "Create Collection"
  3. Re-sync the affected documents

Folder monitor auto-disabled​

Cause: Monitor encountered 5 consecutive failures.

Solution:

  1. Check the error message in the monitor list
  2. Common issues:
    • OAuth token expired → Delete and reconnect the source
    • Folder deleted/moved → Verify the folder still exists
    • Permission revoked → Re-authorize access to the folder
  3. Fix the underlying issue
  4. Toggle the monitor switch to re-enable

New files not syncing from monitored folder​

Cause: Various potential issues.

Solution:

  1. Verify monitor is active: Check the status badge (should be green "Active")
  2. Check last polled time: Should update every 5 minutes when active
  3. Verify file type: Only supported file types are detected
  4. Check project assignment: Files sync to the project selected when monitor was created
  5. Review pending documents: New files appear as "Pending" before syncing

Cannot archive a project​

Cause: The project still contains documents.

Solution:

  1. Navigate to Documents page
  2. Filter by the project you want to archive
  3. Select all documents and use Bulk Delete to remove them
  4. Return to Settings > Projects and archive the project

Cannot restore an archived project​

Cause: Your subscription's project limit has been reached.

Solution:

  1. Free up a slot: Archive an existing active project first
  2. Upgrade your plan: Click the "Upgrade" button in the error toast to access billing
  3. Check current usage: Go to Settings > Projects to see your current count vs. limit

Getting Help​

If you encounter issues not covered here:

  1. Check the error messages in document statistics
  2. Review the console logs for detailed error information
  3. Contact support with:
    • Description of the issue
    • Steps to reproduce
    • Error messages received