---
title: "Billing Auto Top Up Put"
method: PUT
path: "/billing/auto-top-up"
---

# Billing Auto Top Up Put

`PUT /billing/auto-top-up`

## Request

- Base URL: `https://api.goodeye.dev/v1`
- URL: `https://api.goodeye.dev/v1/billing/auto-top-up`
- Auth: none declared

Turn on automatic credit top-ups and set (or update) their terms.

Requires a default payment method already on file: make a manual credit
purchase first to save one. Returns the resolved config block, the same
shape as the GET route. Errors: ``no_payment_method`` (409) when no
default payment method is on file, ``invalid_amount`` (400) when the
amount, threshold, or monthly cap falls outside the allowed range.
Re-running this also clears any previously failed automatic top-up
state, acting as a retry.

## Request body

- ConfigureAutoTopUpIn: Request body for ``PUT /billing/auto-top-up``.
  - `amount_usd` integer, required: Amount to add, in whole US dollars, each time your balance drops below the threshold.
  - `threshold_usd` integer, nullable: Balance, in whole US dollars, that triggers an automatic top-up. Defaults to the top-up amount when omitted.
  - `monthly_cap_usd` integer, nullable: Maximum total, in whole US dollars, automatic top-ups can spend in a calendar month. Defaults to four times the top-up amount when omitted.

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/goodeye/apis/goodeye-api.md) · [All operations](https://skmtc.dev/goodeye/apis/goodeye-api/llms.txt) · [OpenAPI document](https://skmtc.dev/goodeye/apis/goodeye-api/revisions/547cb8bb6ede?raw)