Skip to main content

setAppSpendCaps

Sets per-app hourly/daily spend caps (in cents) and returns the re-evaluated runtime state. Pass null for a limit to clear that cap. Exceeding a cap denies the app's runtime (runtimeDenialReason = spend_cap). Requires the 'manage_billing' permission on the app's org.

setAppSpendCaps(
  appId: BigInt!
  hourlyLimitCents: BigInt
  dailyLimitCents: BigInt
): AppRuntimeState!

Arguments​

setAppSpendCaps.appId ● BigInt! non-null scalar​

App id (BigInt) to set spend caps on.

setAppSpendCaps.hourlyLimitCents ● BigInt scalar​

Hourly spend cap in cents. Null clears the hourly cap.

setAppSpendCaps.dailyLimitCents ● BigInt scalar​

Daily spend cap in cents. Null clears the daily cap.

Type​

AppRuntimeState object​

The shared-environment runtime gate + current billing-window usage for an app.