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: Sync operation may have timed out.

Solution:

  1. Wait a few minutes for processing to complete
  2. If still stuck, try re-syncing the document
  3. Check the error message in document statistics

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