Troubleshooting & Error Reference
This page covers common errors and troubleshooting steps for different areas of the Vantage platform.
Authentication Errors
| Error | Cause | Solution |
|---|
| "Invalid credentials" | Wrong email or password | Verify email and password. Use "Forgot password?" to reset. |
| "2FA code invalid" | Expired or incorrect 2FA code | Ensure your authenticator app time is synced. For email codes, request a new code. |
| "Passkey failed" | Browser doesn't support WebAuthn | Try a different browser (Chrome, Safari, Firefox latest). Ensure biometrics are enabled on your device. |
| "Session expired" | Inactive session timeout | Sign in again. |
Integration Errors
| Error | Cause | Solution |
|---|
| "Connection refused" | Database server unreachable | Verify host, port, and that your IP is whitelisted. Check if the server is running. |
| "Authentication failed" | Invalid credentials | Verify username, password, or API key is correct. |
| "OAuth redirect error" | Popup blocked or redirect issue | Allow popups in your browser. Clear cookies and try again. |
| "Token expired" | OAuth refresh token expired | Click "Reconnect" on the integration card to re-authorize. |
| "Rate limit exceeded" | Too many API calls | Wait and retry. Consider reducing workflow frequency. |
| "API key rejected" | Invalid or revoked key | Generate a new API key from the external service and update in Vantage. |
Workflow Errors
| Error | Cause | Solution |
|---|
| Node shows red error | Processing failed | Click the node to view the error message. Check input data format and configuration. |
| "No input data" | Previous node produced empty output | Verify the upstream node executed successfully and returned data. |
| "Invalid query" | SQL syntax error | Check your query syntax. Test in a database client first. |
| Workflow won't start | No trigger configured or trigger not fired | Ensure a trigger node is connected. Check schedule or condition settings. |
| "Workflow timeout" | Processing took too long | Reduce data volume, optimize queries, or split into smaller workflows. |
Dashboard Errors
| Error | Cause | Solution |
|---|
| Tile shows "No data" | Data source not connected or query returned empty | Check the tile's data source configuration and credential status. |
| Tile won't load | Network issue or browser cache | Clear browser cache and refresh. Check network connection. |
| "Permission denied" | User lacks view_dashboards permission | Contact admin to update your role permissions. |
| AI summary not appearing | AI provider not configured or tokens depleted | Check AI settings and token balance in Settings. |
Billing Errors
| Error | Cause | Solution |
|---|
| "Payment failed" | Card declined or expired | Update payment method in Stripe checkout. |
| "Insufficient tokens" | Token balance is zero | Purchase more tokens in Settings → Account → Billing. |
| "No plans available" | Stripe configuration issue | Contact support — billing plans may need to be reconfigured. |
| Balance not updating | Webhook processing delay | Wait 30 seconds and refresh the page. |
AI Errors
| Error | Cause | Solution |
|---|
| "Invalid API key" | AI provider key is incorrect | Update the API key on the Integrations page. |
| "Insufficient credits" | Third-party AI provider balance is low | Add credits to your account with the AI provider (e.g., OpenAI billing). |
| "Model not found" | Selected model unavailable | Switch to a different model in Settings → AI Features. |
| "Rate limit" | Too many AI requests | Wait and retry. Consider switching to a less-loaded provider. |
| "Context too large" | Too much data sent to AI | Reduce dataset size, use sampling, or disable "Process Large Datasets." |
Getting Help
If you can't resolve an issue using this guide:
- Check the FAQ for common questions
- Visit the Support Center for more troubleshooting
- Contact support via the Contact Us page