Skip to navigation

Assign an AI budget (Beta)

View as Markdown

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.
assigneeobjectRequired
The user, team, or account type the budget applies to.
monthlyBudgetCentsintegerRequired

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.
assignmentIdstring
ID of the budget assignment.
assigneeobject
monthlyBudgetCentsinteger

Monthly AI spend limit per person, in US cents. A positive integer from 1 to 1844674407370 (for example, 2550 for $25.50).

createdAtdatetime
When the budget was assigned.
updatedAtdatetime
When the assigned budget was last updated.