v18

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-014211,6201.8 MB

gitpod.v1.BillingService

CreateTeamCreditAllocation

Creates a credit allocation (budget) for a team.

Allocations are soft budgets for reporting and alerting — not enforced at usage time. Over-allocation (sum of team budgets > org grant) is allowed.

Create a team allocation:

organizationId: "b0e12f6c-4c67-429d-a4a6-d9838b5da047"
teamId: "d2c94c27-3b76-4a42-b88c-95a85e392c68"
creditBudget: "500"

Requires billing:create permission on the organization.

post/gitpod.v1.BillingService/CreateTeamCreditAllocation

costBudgetCurrency'BILLING_CURRENCY_UNSPECIFIED' | 'BILLING_CURRENCY_USD' | 'BILLING_CURRENCY_EUR' | 'BILLING_CURRENCY_GBP'

costBudgetMicrounitsstring nullable

cost_budget_microunits is the BYOK cost budget in micro-units of the currency.

creditBudgetstring

credit_budget is the allocated credit budget in whole credits.

organizationIdstring uuid required

teamIdstring uuid required

Success