Troubleshooting & Error States

Resolving Sync Failures & Expired Tokens

If an integration token expires or a sync fails, LedgeSpace protects the integrity of your reports.

1. The Integration Health Monitor (on your Dashboard) will display a red alert indicating which platform requires re-authentication.
2. During RUSHA AI query execution, the orchestrator performs a health check (getConnectedSources). If a token is expired, it gracefully halts the query and instructs the user to reconnect.
3. To Fix: Navigate to Integrations, locate the flagged platform, and click Reconnect to initiate a fresh OAuth flow.

Troubleshooting Failed Report Deliveries

If a scheduled report fails to deliver:

1. Verify your Custom SMTP Integration settings under Settings > Email Infrastructure.
2. Check that the smtpHost, smtpPort, smtpUser, and smtpPass are perfectly accurate. Ensure no firewall is blocking the connection.
3. Send a report to a test client using your own email address and confirm it arrives. If a report fails to send, you'll receive an alert email and a dashboard notification.
4. Check your client's email address in their Client Profile for typos, and advise them to check their spam/junk folders if the email sent successfully but was not received.

Handling RUSHA Quota Exhaustion Mid-Cycle

When your monthly "Insights Bucket" is depleted:

1. With an active RUSHA plan, AI keeps working. Usage beyond your allowance and any top-up is billed at $0.05 per extra insight and invoiced separately, with a safety cap of 2,000 insights per cycle.
2. Automated Anomaly Detection and Correlation scans do not check your insight quota, so they are not paused by it.
3. Without an active RUSHA plan (for example during a trial), AI actions are blocked until you purchase a Top-Up Block (available in increments of 50 or 120 insights) or subscribe to a RUSHA plan.

Maintenance Protocols & Update Triggers

To ensure this documentation remains accurate, the LedgeSpace team strictly adheres to the following update triggers:

• Integrations: Whenever a new platform is added or removed.
• Pricing: Whenever subscription tiers or discounts (e.g., Annual 20% discount) are modified.
• RUSHA AI: Whenever new capabilities or guardrails are implemented. When any of these occur, both these guides and the llms.txt file are immediately updated.