Harness

Harness Budgets API

Manage Budgets in bulk

Documentation GitHub OpenAPI

Operations 20

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /ccm/api/budgets/bulk/adjust-budget-amount Adjust the amount of many budgets at once · Adjust Budget Amount in bulk #

Ask an LLM

“Can I raise several cloud cost budgets by a percentage in one request?”

“How do I bulk change the amount on a set of Harness budgets?”

Tell an agent

Increase budgets {budgetIds} by {adjustmentValue} using adjustment type {adjustBudgetBulkRequestType}.

Bulk adjust the amount of budgets {budgetIds} by {adjustmentValue}.

POST /ccm/api/budgets/bulk/clone Clone several budgets in bulk · Clone Budgets in bulk #

Ask an LLM

“Can I duplicate a batch of budgets and decide how their alerts are copied?”

“What suffix gets added to budgets I clone in bulk?”

Tell an agent

Clone budgets {budgetIds} in bulk with alert mode {alertMode}.

Bulk clone budgets {budgetIds}, add suffix {suffix} to the copies and handle alerts with {alertMode}.

POST /ccm/api/budgets/bulk/create-cost-bucket-budgets Create budgets for many cost buckets at once · Bulk create Cost Bucket Budgets #

Ask an LLM

“How do I create a budget for every cost bucket in a cost category in one call?”

“Can bulk cost bucket budgets be set up with a growth rate instead of a fixed amount?”

Tell an agent

Create {period} budgets of {budgetAmount} for cost buckets {costBucketIds} in cost category {costCategoryId}, type {type}.

Bulk create cost bucket budgets for category {costCategoryId} buckets {costBucketIds} with name prefix {namePrefix}, period {period}, type {type}.

POST /ccm/api/budgets/bulk/delete Delete several budgets at once · Delete Budgets in bulk #

Ask an LLM

“Can I delete a whole list of cost budgets in a single request?”

“What happens if I bulk delete budgets in Harness Cloud Cost Management?”

Tell an agent destructive · confirm first

Delete budgets {budgetIds} in bulk.

Remove all of these budgets at once: {budgetIds}.

GET /ccm/api/budgets/bulk/check-job-status Check the status of a bulk budget job · Check bulk budget update job status #

Ask an LLM

“Has my bulk budget update job finished yet?”

“Can I tell whether a bulk budget job is running, completed or failed?”

Tell an agent

Check whether the bulk budget update job in account {accountIdentifier} is still running.

Show the status of the latest bulk budget job.

POST /ccm/api/budgets/bulk/manage-alerts Manage alerts on many budgets at once · Manage Budget Alerts in bulk #

Ask an LLM

“Can I add or remove alert recipients across many budgets in one go?”

“How do I delete the alerts on a batch of budgets?”

Tell an agent

Apply alert action {action} to budgets {budgetIds}.

Add email recipients {emailRecipients} to the alerts on budgets {budgetIds} using action {action}.

GET /ccm/api/budgets/{id} Get a budget's details · Fetch Budget details #

Ask an LLM

“What amount, period and thresholds are set on one specific budget?”

“How can I look up a single cost budget by its ID?”

Tell an agent

Show the details of budget {id}.

Fetch budget {id} so I can review its configuration.

PUT /ccm/api/budgets/{id} Update an existing budget · Update an existing budget #

Ask an LLM

“How do I edit a budget I already created?”

“Can I change an existing budget's settings by its ID?”

Tell an agent

Update budget {id} with the new settings.

Save changes to existing budget {id}.

POST /ccm/api/budgets/{id} Clone a single budget under a new name · Clone a budget #

Ask an LLM

“Can I copy one budget and give the copy its own name?”

“How do I duplicate a single existing budget?”

Tell an agent

Clone budget {id} as {cloneName}.

Make a copy of budget {id} named {cloneName}.

DELETE /ccm/api/budgets/{id} Delete a single budget · Delete a budget #

Ask an LLM

“How do I remove one budget by its ID?”

“Is deleting a single budget permanent?”

Tell an agent destructive · confirm first

Delete budget {id}.

Remove the budget with ID {id}.

POST /ccm/api/budgets/filter-values Get the available filter values for budgets · Return the list of filter values for the Budgets #

Ask an LLM

“Which values can I filter my budget list by for a given column?”

“What filter options exist for budgets, like periods or creators?”

Tell an agent

List the filter values available for budget columns {columns}.

Show every value I can pick in the budget filters.

POST /ccm/api/budgets/v2/list Filter the budgets I have access to · Filter budgets with RBAC checks #

Ask an LLM

“Which of my budgets are over budget or at risk?”

“Can I search budgets by name and filter them by folder or amount range?”

Tell an agent

Find budgets with status {budgetStatus} that I can access.

Search the budgets I can see for names containing {searchKey}.

POST /ccm/api/budgets/v2/metrics Count total and over-budget budgets · Budget count metrics with RBAC checks #

Ask an LLM

“How many budgets do I have, and how many are over budget?”

“What's the over-budget count for budgets in a particular folder?”

Tell an agent

Count my budgets and how many are over budget.

Give me the total and over-budget counts for budgets in folders {folderIds}.

GET /ccm/api/budgets/{id}/costDetails Get the cost details of a budget · Fetch the cost details of a Budget #

Ask an LLM

“How much has been spent against a specific budget so far?”

“Can I see a budget's actual versus forecast cost month by month?”

Tell an agent

Show the cost details for budget {id}.

Break down budget {id} costs by {breakdown}.

GET /ccm/api/budgets/perspectiveBudgets List the budgets tied to a perspective · List all the Budgets associated with a Perspective #

Ask an LLM

“Which budgets are attached to a particular cost perspective?”

“Does this perspective have any budgets set on it?”

Tell an agent

List the budgets for perspective {perspectiveId}.

Show every budget linked to perspective {perspectiveId}.

GET /ccm/api/budgets List all budgets in the account · List all the Budgets #

Ask an LLM

“What cloud cost budgets are defined in my Harness account?”

“Can I sort the full budget list by a field and order?”

Tell an agent

List all my budgets.

List every budget sorted by {budgetSortType} in {sortOrder} order.

POST /ccm/api/budgets Create a cost budget with alerts · Create a Budget #

Ask an LLM

“How do I get alerted when cloud spend exceeds or is forecast to exceed a budget?”

“Can a new budget notify a user group or Slack when a threshold is crossed?”

Tell an agent

Create a {period} budget named {name} for {budgetAmount}.

Create budget {name} for account {accountId} and email {emailAddresses} when thresholds {alertThresholds} are hit.

GET /ccm/api/budgets/subscribe/list List the alert thresholds on a budget · List alert thresholds for a budget #

Ask an LLM

“What alert thresholds are configured on this budget?”

“At what percentages will a budget send me alerts?”

Tell an agent

List the alert thresholds for budget {budgetId}.

Show when budget {budgetId} will alert.

POST /ccm/api/budgets/moveBudgets Move budgets into another folder · Move budgets to a folder #

Ask an LLM

“Can I move budgets to a different folder than their perspective's?”

“How do I reorganize budgets into a new folder?”

Tell an agent

Move budgets {budgetIds} to folder {newFolderId}.

Put budgets {budgetIds} in folder {newFolderId}, overriding the perspective folder.

POST /ccm/api/budgets/subscribe Replace the alert thresholds on a budget · Update alert thresholds for a budget #

Ask an LLM

“How do I change the alert percentages on one budget?”

“Can I overwrite a budget's alert thresholds with a new list?”

Tell an agent

Update the alert thresholds on budget {budgetId}.

Set new alert thresholds for budget {budgetId}.

Harness Budgets API

Operations 20

Documentation

Specifications

Schemas & Data

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification