Skip to main content
POST
Create Budget
Create a new infrastructure budget for tracking spending

Request Parameters

string
required
Budget name.Minimum: 1 character
Maximum: 200 characters
string
Budget description.Maximum: 1000 characters
object
required
Budget scope definition.Scope Types:
  • overall - Track all infrastructure spending
  • cloud_provider - Track spending for a specific cloud provider (requires cloud_provider field)
  • environment - Track spending for a specific environment (requires environment_name field)
Examples:
  • Overall: {"type": "overall"}
  • Cloud Provider: {"type": "cloud_provider", "cloud_provider": "aws"}
  • Environment: {"type": "environment", "environment_name": "production"}
  • Combined: {"type": "environment", "cloud_provider": "aws", "environment_name": "production"}
number
required
Monthly budget limit in USD.Minimum: Greater than 0
number
Alert threshold percentage. Alerts are sent when spending reaches this percentage of the budget.Default: 80.0
Minimum: 0
Maximum: 100
number
Critical alert threshold percentage. Critical alerts are sent when spending reaches this percentage.Default: 95.0
Minimum: 0
Maximum: 100
string
Budget enforcement mode.Options: alert, warn, block
Default: alert
string
Organization ID if budget is shared within an organization.

Response