setAppBudget
Creates or updates an app's monthly spend cap (idempotent upsert keyed by org + app) and returns the resulting budget. This only records the cap used to monitor/limit overspend; it does not move money, charge a card, or alter the wallet balance. Requires the 'manage_billing' app permission.
setAppBudget(
orgId: BigInt!
appId: BigInt!
monthlyLimitCents: BigInt!
idempotencyKey: String
): AppBudget!
Arguments
setAppBudget.orgId ● BigInt! non-null scalar
Organization id (BigInt as a decimal string) that owns the app.
setAppBudget.appId ● BigInt! non-null scalar
App id (BigInt as a decimal string) whose budget to set.
setAppBudget.monthlyLimitCents ● BigInt! non-null scalar
Monthly spend cap in minor currency units (cents) of the wallet currency, as a BigInt decimal string. The cap resets each calendar month.
setAppBudget.idempotencyKey ● String scalar
Optional idempotency key. Recommended for retries: replaying with the same key and identical arguments returns the first result instead of re-applying; the same key with different arguments returns IDEMPOTENCY_CONFLICT. Keys expire after 24h.