Skip to main content
POST
Create llm gateway budget

Authorizations

Authorization
string
header
required

Enter a Forge service-account token or delegated OAuth access token. Mintlify adds the Bearer prefix.

Headers

X-Forge-Reason
string
required
Minimum string length: 1
Idempotency-Key
string
required
Minimum string length: 1
X-Forge-Confirm
enum<boolean>
required
Available options:
true

Path Parameters

organizationId
string
required

Body

application/json

Independent optional limit. All matching budgets apply cumulatively across providers and keys. Access assignments do not create budgets.

accessProfileId
string

Optional profile filter; omission applies across access profiles.

tokenId
string
subjectKind
enum<string>
Available options:
user,
group,
app,
agent,
service_account,
customer_tenant
subjectId
string
budgetWindow
enum<string>
Available options:
daily,
weekly,
monthly,
rolling_24h,
rolling_7d,
rolling_30d
amountUsd
number<double>
Required range: 0.000001 <= x < 1000000000000
inputTokenLimit
integer<int64>
Required range: x >= 1
outputTokenLimit
integer<int64>
Required range: x >= 1
totalTokenLimit
integer<int64>
Required range: x >= 1
action
enum<string>
Available options:
block
metadata
object

Accepted budget settings. Unknown keys are rejected. Server-owned fields may be returned unchanged on update; use allowanceUsd to change allowances.

Response

Gateway budget response.

budget
object
required