---
title: "Set auto top-up's three figures and turn it on or leave it off."
method: PUT
path: "/v1/billing/auto-top-up"
tags: ["billing"]
---

# Set auto top-up's three figures and turn it on or leave it off.

`PUT /v1/billing/auto-top-up`

## Request

- Base URL: `https://api.withruntime.com`
- URL: `https://api.withruntime.com/v1/billing/auto-top-up`
- Auth: HTTP bearer

When the account's credit falls below `below`, its saved card is charged `amount` plus tax, at most once at a time and at most `monthlyLimit` a calendar month. Each automatic top-up that clears adds 5% more as credit. While it is on the account may run 200 sandboxes at once instead of 100. A declined charge, or one the bank wants its holder to confirm, turns it off; it never stops a running sandbox. A person saves the card at saveCardAt. Owners, admins and billing members, and keys they made; not a read-only key.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `enabled` boolean, required: true to turn on (once a card is saved), false to keep it off.
  - `below` number: Charge when credit falls below this, in whole cents: $10 at least. Left out, it keeps the one saved, or $10.
  - `amount` number: Dollars to add each time, before tax: $20 to $10,000, and at most $500 in an account's first week. Left out, it keeps the one saved, or $20.
  - `monthlyLimit` number: The most to add in one calendar month (UTC), before tax: $100 at least, and at least amount. Left out, it keeps the one saved, or $500.

## Response `200`

Success

- object
  - `enabled` boolean, required: Charging now.
  - `waitingForCard` boolean, required: Asked to turn on; turns on once a card is saved at saveCardAt.
  - `below` number, nullable, required: Charge when credit falls below these dollars.
  - `amount` number, nullable, required: Dollars added each time, before tax.
  - `monthlyLimit` number, nullable, required: The most added in one calendar month (UTC), in dollars before tax.
  - `thisMonth` number, required: Dollars added this month, a charge in flight included.
  - `card` boolean, required: A card is saved for auto top-up.
  - `offReason` string, nullable, required: Why it turned itself off: declined, authentication_required (the bank wanted the holder), card_removed, no_address (no billing address for tax), blocked, failed. Null while on.
  - `offAt` string, date-time, nullable
  - `saveCardAt` string, nullable: Where a person saves the card, when none is saved. Null once one is.

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/withruntime/apis/runtime-cloud-api.md) · [All operations](https://skmtc.dev/withruntime/apis/runtime-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/withruntime/apis/runtime-cloud-api/revisions/6f4012286988?raw)