billing

Set, change, or turn off the automatic top-up rule [admin or billing role]

Set, change, or turn off the automatic top-up rule (admin or billing role): when the available balance falls below threshold_usd, the card on file is charged amount_usd (defaults: below $20, add $100). It is what keeps a prepaid organization running unattended - at zero compute stops and every disk is kept, and the rule buys the credit before that. Bounds: threshold $1 to $10,000, amount $10 to $10,000, whole cents; the rule runs at most 25 times per rolling 24 hours, within daily_limit_usd when you set one (0 clears it) and the platform's daily ceiling. A card must be on file: with none, buy_credits(amount_usd) answers with a payment link, and that one payment adds credit and saves the card. disable: true turns the rule off. Audited as a standing authorization to charge the card.

put/preview/billing/auto-topup

Request

  • Base URL: https://autoresearch.sfcompute.com
  • URL: https://autoresearch.sfcompute.com/preview/billing/auto-topup
  • Auth: HTTP bearer

Query parameters

workspacestring

Act in this workspace (its slug). Omitted: the token's bound workspace, then the organization's default. Never ambient - there is no switch-workspace mutation on this door.

Request body

amount_usdnumber double nullable

Dollars to add each time: $10 to $10,000, whole cents. Default 100.

daily_limit_usdnumber double nullable

Your ceiling on automatic charges per rolling 24 hours, in dollars (at least the amount). Omit to keep the current ceiling, 0 to clear it. The platform bound (25 attempts and its own daily ceiling) applies regardless.

disableboolean

Turn the rule off (every other field is ignored).

orgstring nullable

Organization (uuid or name); omitted = your active org.

threshold_usdnumber double nullable

Buy credit when the available balance falls below this many dollars: $1 to $10,000, whole cents. Default 20.

Response

The capability's JSON result.

objectstring

The resource type, when the result is one resource.

Changes

No recorded changes to this operation across all 1 revision of this API.