Summarize credit usage
Owner or admin only. Returns totals for every event matching the filters, not just one page: credits used, credits added, refunds and adjustments, net change and event count. Takes the same filters as List credit usage.
Authorizations
The full Cookie header copied from a signed-in connie.ai browser request. See the Authentication page.
Path Parameters
The workspace id, as in the app URL connie.ai/<workspaceId>/....
Query Parameters
Search text, 2 to 200 characters.
2 - 200Time window. billing_period is the current billing period. custom uses from and to and is implied when either is given. Defaults to 30d.
today, 7d, 30d, billing_period, custom Start of a custom range, as YYYY-MM-DD or an ISO date-time. Only with period=custom.
End of a custom range, as YYYY-MM-DD (that whole day is included) or an ISO date-time.
Only credits used, added, or refunded and adjusted.
used, added, refunded_adjusted One or more categories, repeated or comma-separated.
ai, enrichment, workflow, tool_integration, grant, purchase, refund, adjustment One or more exact actions, such as tool.used. Repeated or comma-separated.
Who triggered the event, as a user id or an API key id, or system. Repeated or comma-separated.
Where the credits were used. Repeated or comma-separated.
Where the credits were used, such as Chat (ai_chat), MCP, an API key or a workflow.
ai_chat, mcp, agent, workflow, ui_enrichment, api_key, managed_app, system Only events charged to these records. Repeated or comma-separated.
Smallest credit amount per event, ignoring sign.
x >= 0Largest credit amount per event, ignoring sign.
x >= 0Include older imported history. Pass false to hide it.
Response
Totals.
Credits spent, as a positive number.
Credits granted or purchased.
Credits returned by refunds and adjustments.
credits_added plus credits_refunded_adjusted.
Signed sum of every matching event.
The window the results cover.
Start of the current billing period, if the workspace has one.
Whether the workspace has older imported history that include_legacy controls.