Create and manage user budgets
Create per-user AI spending budgets, configure approval tiers and enforcement rules, monitor usage across your team, and handle limit increase requests.
What you will learn from this topic
How to create a user budget and configure its scope, period, and spending limit
How to set up approval tiers so users can request limit increases
How to configure notification and block enforcement rules
How to monitor spend and user health across your team
How to review and approve limit increase requests
Before you begin
Harness Cloud & AI Cost Management must be enabled on your account.
The users you want to budget must belong to a Harness user group. Go to Create a user group if you need to set one up.
Make sure budget enforcement is enabled on the connector. Select AI Governance on your AWS connector for Amazon Bedrock, or Enforce AI user budgets on the provider's own connector (Cursor, Devin, GitHub Copilot, Claude Enterprise). Consult your administrator if you do not have access. Go to Enable AI Governance on your connector for steps.
Set up prerequisites
Enable AI Governance on your connector
AI Governance enables Harness to enforce user budgets by capping or revoking spend on a connected provider. Enable it when you set up the connector. The steps depend on the connector type.
Use the following steps for Cursor, Devin, GitHub Copilot, and Claude Enterprise.
OpenAI and Anthropic Platform are not supported.
On the left navigation bar, under Setup and integration, select Cloud Integration, then select the AI Providers tab.
Click + AI Provider, then select the provider.
Enter the connector details in Overview and click Continue. For Anthropic, select Anthropic Enterprise in the Product Type step. Anthropic (Platform) is not supported.
In Connector Details, under Permissions, keep View costs (required) selected and select Enforce AI user budgets.

Select Enforce AI user budgets on the Connector Details step In API Key, select a secret that holds an administrator key with read and write access. Enforcing budgets requires write access.
Click Continue, then complete the Connection Test.
Amazon Bedrock is enabled on the AWS cloud connector. Harness needs an IAM policy in your AWS account to block access, so the wizard asks for the Bedrock role and policy names.
On the left navigation bar, under Setup and integration, select Cloud Integration, then select the Cloud Accounts tab.
Click + New Cloud Account, then select AWS.
Enter the connector details in Overview, then complete the Cost and Usage Report step.
In Choose Requirements, select AI Governance. Harness adds the permissions to enforce AI budgets on AWS Bedrock and block access when a budget is breached.

Select AI Governance on the Choose Requirements step In AI Governance Permissions, enter the following fields. Harness includes these values in the CloudFormation template.
FieldDescriptionBedrock Target Role Name
The full name of the AWS IAM role that your Bedrock users use. For a role managed by AWS IAM Identity Center, include the
AWSReservedSSO_prefix and the suffix, for example,AWSReservedSSO_<permission-set-name>_<suffix>.AI Governance IAM Policy Name
The name of the IAM policy that Harness uses to block access. The default is
harness-aicost-governance.
AI Governance Permissions step in the AWS connector wizard In Create Cross Account Role, click Launch Template on AWS console and follow the instructions to create the cross-account role. Harness prefills the External ID.
Enter the Cross Account Role ARN, click Save and Continue, then complete the Connection Test.
Create a user group
You can create a user group directly from the Select user groups field in the budget wizard, without leaving the page.
Click + Create new to open the Add User Group panel.
Fill in the fields described in the following table.
Click Add to create the group. It appears immediately in the Select user groups drop-down menu.

Name
A display name for the group. Harness auto-generates an identifier from it.
Users
Click Select to add users from your account. Search by name or email and select one or more, then click Select to confirm.
Role Bindings
Assign a Role and Resource Group to the group. Click + Add to add more role bindings.
Metadata
Optional description and tags for the group.

For full user group management, go to Manage user groups.
Create a user budget
On the left navigation bar, select Cost Governance > User Budgets.
Click + Create budget to open the Create a new Budget wizard.
Step 1: Budget setup

Specify users to apply budget
Select Harness user groups to reuse an existing Harness user group.
Select user groups
Select one or more groups from the Select user groups drop-down menu. To create a new group, click + Create new. Go to Create a user group for steps.
Applies to
Select which AI providers this budget governs. You can select all providers, a single provider, or any combination:
All AI spend: Every connected AI provider, including new providers you connect in the future
Cursor: Spend from Cursor IDE
Devin: Spend from Devin
GitHub Copilot: Spend from GitHub Copilot
Claude Enterprise: Spend from Claude Enterprise
Amazon Bedrock: Spend from Amazon Bedrock
Budget name
Descriptive name for the budget (for example, CCM Team - Cursor)
Folder
Select a folder to organize the budget. The drop-down menu lists all existing folders with a search bar to filter by name. If no folder is selected, the budget is placed in the Default folder.
Budget period
Select the billing cycle:
Weekly
Monthly
Quarterly
Spend resets at the start of each new period; unused allowance does not roll over.
Start date
Use the date picker to select the start date for the first budget period.
Step 2: Enforcements and notifications
Configure the per-user spending limit, approval workflow, and notification rules. The step has three parts: Budget per user, Limit increase requests (with optional advanced settings), and Notification and block rules.

Budget per user
Enter the dollar amount that each user in the group can spend per period. The provider scope badge (for example, All AI spend) in the top-right reflects what you selected in Step 1.
Limit increase requests
Enable Allow users to request a higher limit so users can request an increase from their profile.
Set up at least one approval tier to define who approves requests and the maximum amount they can approve. Each tier has the fields described in the following table.
Click + Add approval tier to add multiple tiers.
Requests up to
The maximum amount this approver can approve. Harness sends the request to the approver whose tier ceiling matches or exceeds the requested amount.
Approved by
Who approves requests at this tier. Select Auto-approve to approve requests automatically without manual review. Otherwise, select one or more individual users or a user group.
The ceiling of the highest tier is the maximum amount any user can request.

Advanced limit increase settings (optional)
Expand Advanced settings to set limits on when users can request an increase and how much they can request:
Users can request an increase once spend reaches
The percentage of their current budget a user must consume before they can submit a request.
Maximum increase per request
The largest single-request increase allowed.

Notification and block rules
Click + Add percentage threshold to define when Harness should act.
Set the spend percentage in the When spend reaches field.
Select the action for the threshold:
Click + Notify to send an email to the affected user when the threshold is crossed. You can add more recipients.
Click + Block to revoke the user's access to the covered AI providers when the threshold is crossed.
For each threshold, you can notify the user, block their access, or both. Add multiple thresholds to trigger different actions at different spend levels.

Save the budget
Click Create to save the budget.
Monitor a user budget
From the User Budgets list, select a budget name to open its detail page.

Summary tiles
Budget per user
The per-user limit, provider scope, and total number of users in the budget
Total budget for period
Sum of all users' limits for the current period, with a breakdown of OK, At risk, and Exceeded users
Period-to-date spend
Aggregate spend so far, shown as a percentage of the total budget, and how much of the period has elapsed
Pending Requests
Number of outstanding limit increase requests
The Active Enforcements bar lists the notification and block rules applied to this budget. Each tag displays the action and the spend threshold that triggers it. For example, Notify at 80% sends an email when a user reaches 80% of their limit, and Block all access at 100% revokes their access when they hit the cap.
Per-user table
User
User email
Budget
The user's current per-period spending limit that may be higher than the default if a previous limit increase was approved
Status
OK (within limit), At risk (approaching the threshold), or Exceeded (over the limit)
Current spend
Dollar amount spent and percentage of their limit, shown as a progress bar
Enforcements
Active enforcement applied to this user
Request details
Details of any pending limit increase request for this user
Review limit increase requests
Harness routes each submitted request to the approver assigned to the matching approval tier. As an approver, you can approve directly without opening the review panel, or review the full request details before deciding.
Approve directly
Use the inline buttons next to the specific user in the Request details column to act without reviewing the request.
Click (✓) to approve the request.
Click (✗) to reject the request.
Review request through review panel
Click Review all in the Pending Requests tile to view all users who have submitted a limit increase request for this budget.
Alternatively, click Review ↗ next to a specific user in the Request details column to go directly to their request.

The review panel displays the following details for the selected request:
Current budget
The user's current per-period limit
WTD spend
How much the user has spent so far this period, and the percentage of their current limit
Requested upgrade
The transition from current to requested amount (for example, $125.00 → $130.00)
Approve for
The amount to approve. Defaults to the requested amount. You can change it to approve a lesser amount than the user requested.

The panel also includes two tabs:
Request history: Displays the user's past requests grouped by budget period.

Request history tab showing past requests by budget period Spend breakdown: Displays a bar chart of the user's daily AI spend. Click View on explorer to open the full Cost Explorer. Use the following drop-down menus to change the view:
By providers: By providers, By models, By accounts, By model family, or By token type
By days: By days, By weeks, or By months

Spend breakdown tab showing daily AI spend by provider
Take one of the following actions:
Approve: confirm the amount in the Approve for field and approve the request.
Reject: decline the request.
Skip for now: defer the decision and move to the next request.
Edit or delete a user budget
On the budget detail page, click Edit Budget to reopen the two-step wizard and change any setting.
Click More for additional options, including Delete.
Next steps
Go to Manage your AI budget to view what users experience: how to view their spend and submit a limit increase request.
Last updated
Was this helpful?