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}.
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}.
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}.
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.
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}.
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}.
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}.
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.
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.
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}.
Documentation
Documentation
https://apidocs.harness.io
APIReference
https://apidocs.harness.io
GettingStarted
https://developer.harness.io/docs/platform/automation/api/api-quickstart/
Authentication
https://artifacts.apis.io/harness/authentication/harness-authentication.yml
RateLimits
https://artifacts.apis.io/harness/rate-limits/harness-rate-limits.yml
Specifications
Schemas & Data
JSONSchema
https://artifacts.apis.io/harness/json-schema/harness-ccmbudget-filter-properties-schema.json
JSONSchema
https://artifacts.apis.io/harness/json-schema/harness-budget-schema.json
JSONSchema
https://artifacts.apis.io/harness/json-schema/harness-manage-budget-alerts-request-schema.json
JSONSchema
https://artifacts.apis.io/harness/json-schema/harness-clone-budget-request-schema.json
JSONSchema
https://artifacts.apis.io/harness/json-schema/harness-create-cost-bucket-budgets-request-schema.json
JSONSchema
https://artifacts.apis.io/harness/json-schema/harness-alert-threshold-schema.json
Other Resources
OAuthScopes
https://artifacts.apis.io/harness/scopes/harness-scopes.yml
ErrorCatalog
https://artifacts.apis.io/harness/errors/harness-error-codes.yml
Conventions
https://artifacts.apis.io/harness/conventions/harness-conventions.yml
Idempotency
https://artifacts.apis.io/harness/conventions/harness-conventions.yml