Consumption & costs

The Metrics dashboard aggregates usage from your database: spend, tokens, pipelines, daily charts, and budget — all derived from ingested events and optional budget settings.

Data flow

1. Your application (or proxy) posts usage events to the ingest API.
2. Events are stored in usage_events per user.
3. The RPC get_consumption_dashboard() returns JSON aggregates for the signed-in user.

Metrics endpoint

GET /api/dashboard/metrics returns structured totals, model breakdown, pipelines, and 30-day daily spend. Requires a valid session.

Budget

Default monthly budget is 4000 (USD) until you set user_consumption_settings via PATCH /api/settings/budget.

Pipelines

Include a pipeline string on each ingest event to attribute cost to named workloads (e.g. document-ingestion).