Create budget

Create a new budget to track cloud spending.

Budgets monitor actual spend against a target amount and notify subscribers when configurable thresholds are breached. Three amount types are supported:

  • Specified amount — A fixed dollar value for each period.
  • Variable amount — Different amounts per period, set via periods.
  • Hierarchical amount — Dimension-level allocations within the total.

Returns the budgetID of the newly created budget.

Body Params
uuid
required
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

A unique identifier for an organization

number | null

Dollar value of the budget

hierarchicalAmount
object
boolean

Consistent recurring amount every month

string
required
length ≥ 1

Budget measure

string
required
length ≥ 1

Budget name

periods
array of objects

Period versions

periods
scopes
array of objects
required
length ≥ 1
scopes*
slackChannelIDs
array of strings

Slack channel IDs to receive budget notifications

slackChannelIDs
subscribers
object
required
thresholds
array of objects
required
thresholds*
Responses

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json