Have your connection details ready.
Your proxy’s base URL
For hosted setup, use your proxy’s public HTTPS base URL, reachable from LiteLedger. Your proxy operator can provide this address.
One workspace connection key
Ask your proxy operator for a key with access to the key list, spend logs, and daily activity across the customers you want to sync. A workspace administrator adds this shared connection to LiteLedger.
Set up your workspace.
Access
Sign in to your workspace
Request access if you’re new to LiteLedger. Sign in with your organization’s configured identity provider. Workspace access is approved by an administrator or through a pre-authorized domain. Have a workspace administrator complete the connection and sync steps below.
Settings → LiteLLM Data Source
Save the proxy URL and shared key
Enter the Base URL and choose Save URL. Expand Shared workspace key, enter the key, and choose Save shared key. These settings connect your workspace to one shared dataset.
Settings → LiteLLM Data Source
Test the saved connection
Choose Test Connection. A successful result shows Connected to followed by your proxy URL. This checks access to the key-list endpoint; use the permissions listed above when choosing your connection key.
Operations → Data Pipeline
Run your first sync
Choose Sync to import your proxy records. Follow the progress display as LiteLedger loads and prepares the data. When the run completes, explore your customer list, dashboard, request logs, and spend breakdowns. These views use synced records and work without an AI provider key.
Settings → AI & Models
Add analysis when you’re ready
Configure a supported AI provider for analysis and Ask. The provider settings are separate from your data-source connection. Add guides and terminology to Primer in Settings → Product Knowledge to give the analysis your product context. Review AI usage and costs →
Operations → Data Pipeline
Keep your workspace up to date
In Automatic Sync, enable the schedule, add one or more run times, choose a timezone, and select Save times. Workspace administrators manage the schedule; the panel shows the last automatic run and the next scheduled time.
Start with the history your proxy holds.
The first sync imports available detailed request records and daily activity totals. How far back each reaches depends on your proxy’s retained history; daily totals can extend beyond the conversations available to read.
LiteLedger keeps synced request records by default, so your history builds with continued syncing. Workspace admins can configure detailed-record retention in Settings → Data Governance.
See what you can learn from your customers.
Explore a sample report to see the signals, session evidence, and recommended actions that analysis brings together.
Add product context · Explore data handling and access controls