Skip to main content
Unary · Billing Returns organization-level enterprise AI usage totals for reporting. Reports BYOK (bring-your-own-key) token spend: cost in the organization’s billing currency plus token counts, with a per-model breakdown. Credit-based usage from managed models is not included and the credits field is not populated by this endpoint. Use this method to:
  • Report total BYOK AI spend (cost and tokens) for a date range
  • Break down organization usage by model
Only available for enterprise organizations.

Examples

  • Get usage totals for January: Returns organization-wide BYOK spend for the month. Both dates are inclusive and the range must not exceed 31 days.

Authorization

Requires billing:read_usage permission on the organization.

Endpoint

Send a Bearer token as described in Authentication. If your organization uses a custom management-plane domain, replace https://app.ona.com with that domain.

Request example

Request

gitpod.v1.GetEnterpriseAIUsageSummaryRequest

Response

gitpod.v1.GetEnterpriseAIUsageSummaryResponse
DateRange specifies a time period for queries.gitpod.v1.DateRange
gitpod.v1.EnterpriseAITokenUsage
gitpod.v1.EnterpriseAIUsage
gitpod.v1.EnterpriseAIUsageBudget
gitpod.v1.EnterpriseAIUsageByModel
gitpod.v1.EnterpriseAIUsageByTokenType