Unary · Billing
Returns a signed download URL for a CSV export of credit usage.
The URL points to an HTTP endpoint that streams gzip-compressed CSV and
is valid for five minutes. The download must be made by the same principal
that requested it, carrying its own bearer token. The export range may
cover up to a year.
For organizations without enterprise credit usage enabled (no billing
contract start date), the export instead contains BYOK cost usage with a
different column set, and groupBy=RESOURCE is rejected.
Use this method to:
- Export per-user daily credit usage for external reporting
- Export a per-environment and per-conversation resource breakdown
Examples
-
Export January’s daily summary:
Authorization
Requiresbilling:read_usage permission on the organization.
Endpoint
https://app.ona.com with that domain.
Request example
Request
gitpod.v1.GetCreditUsageExportRequest
Response
gitpod.v1.GetCreditUsageExportResponse
Related types
DateRange
DateRange
DateRange specifies a time period for queries.
gitpod.v1.DateRangeCreditUsageExportGroupBy
CreditUsageExportGroupBy
How to group the credit usage export data.