Memory & RAG
Get Memory Usage
Monthly (or custom-period) spend breakdown for the workspace’s memory operations
GET
Return the wallet owner’s spend on memory operations over a given period, broken down by operation type. Unbilled — calling this endpoint is always free and works even when the wallet is empty.
Use this endpoint to:
- Power a “Memory spend” widget in your own dashboard
- Alert on daily/monthly spend thresholds
- Reconcile refunds against original charges
Request
Headers
Bearer token with your API key
Query parameters
Time window to aggregate over. One of:
current_month— from midnight on the 1st of the current monthlast_30_days— rolling 30-day window ending nowall_time— all history (since the transaction log was created)
Response
true on success.Example
Notes
- Refunds appear as separate service types (
MEMORY_EXTRACT_REFUND,MEMORY_INGEST_REFUND, etc.) with negativenet_spend_usd. This preserves an auditable distinction between “a charge that happened and was reversed” vs “no charge at all”. - The
billing_owner.current_balance_usdreflects the live wallet — it is not period-scoped, it’s always the current balance regardless of whichperiodyou requested. - For a full operation-level audit trail (every single row in
transaction_log), use the dashboard — this endpoint is an aggregated summary.
Related
- Pricing & Billing — rates, refund policy, header reference
- Memory feature overview