Skip to main content
POST
Create Budget

Authorizations

gateway_session
string
cookie
required

Secure same-origin browser session cookie.

Body

application/json
scope
enum<string>
required
Available options:
organization,
project,
team,
user,
api_key
interval
enum<string>
required
Available options:
daily,
weekly,
monthly,
lifetime
limit_usd
number
required
target_id
string | null
warning_threshold_percent
number
default:80
Required range: 0 <= x <= 100
enforcement
enum<string>
default:monitor
Available options:
monitor,
hard
allocation
enum<string>
default:shared

A shared total or an independent allowance for each user. Per-user allocation supports organization and project scopes and automatically applies to new users.

Available options:
shared,
per_user

Response

Successful Response

id
string
required
scope
string
required
target_id
string | null
required
target_name
string
required
interval
string
required
limit_usd
string | null
required
warning_threshold_percent
integer
required
enforcement
string
required
allocation
enum<string>
required
Available options:
shared,
per_user
created_at
string
required
updated_at
string
required
object
string
default:cost.budget
Allowed value: "cost.budget"