Assign an AI budget (Beta)
Assign a monthly AI budget to a user, team, or account type. If the assignee already has an assigned budget, it is replaced.
Beta: This documentation describes a public beta feature and is subject to the Beta features disclaimer.
Usage notes
- To perform this operation, you must use API credentials owned by a user assigned the Admin account type.
- Retrieve the memberId by calling the /v2/members endpoint.
- Retrieve the teamId by calling the /v2/teams endpoint.
- Retrieve the accountTypeId by calling the /v2/accountTypes endpoint.
- Retrieve the assignee.position.assignmentId by calling the /v2/organizations/settings/aiBudgets/assignments endpoint.
- A member’s budget comes from the most specific assignment that applies to them: a member assignment, then a team assignment, then an account type assignment, then the organization’s default budget. When a member belongs to several teams with assignments, the team assignment with the highest precedence applies.
Usage scenarios
- Automated budget management: Keep AI budgets in sync with an identity provider or infrastructure-as-code, rather than editing them in the administration portal.
Authentication
AuthorizationBearer
OAuth authentication of the form <token>.
Request
The request body.
assignee
The user, team, or account type the budget applies to.
monthlyBudgetCents
Monthly AI spend limit per person, in US cents. A positive integer from 1 to 1844674407370 (for example, 2550 for $25.50).
Response
The response body.
assignmentId
ID of the budget assignment.
assignee
monthlyBudgetCents
Monthly AI spend limit per person, in US cents. A positive integer from 1 to 1844674407370 (for example, 2550 for $25.50).
createdAt
When the budget was assigned.
updatedAt
When the assigned budget was last updated.

