---
title: "Change auto-refill, or turn it on or off. Turning on needs a saved card"
method: PATCH
path: "/api/v1/auto-refill"
tags: ["Account"]
---

# Change auto-refill, or turn it on or off. Turning on needs a saved card

`PATCH /api/v1/auto-refill`

## Request

- Base URL: `https://audo.ai`
- URL: `https://audo.ai/api/v1/auto-refill`
- Auth: API key in cookie `__Secure-audo.session_token`

Only for a person signed in on the website.

## Request body

- object
  - `enabled` boolean
  - `thresholdCents` integer
  - `amountCents` integer
  - `monthlyCapCents` integer

## Response `200`

OK

- object
  - `enabled` boolean, required
  - `thresholdCents` integer, required: Refill when the available balance drops below this, in US cents
  - `amountCents` integer, required: What each refill adds to the balance, in US cents (tax, if any, is charged on top)
  - `monthlyCapCents` integer, required: The most charged for refills in a calendar month (UTC), in US cents before tax
  - `spentThisMonthCents` integer, required: Charged for refills this calendar month, in US cents before tax
  - `card` object, nullable, required: The saved card, or null
    - `brand` string, nullable, required
    - `last4` string, nullable, required
  - `disabledReason` 'card_declined' | 'authentication_required' | 'payment_failed' | 'disputed', nullable, required: Why auto-refill turned itself off, or null: card_declined, authentication_required, payment_failed, or disputed
  - `setupUrl` string, required: Where a person turns auto-refill on or changes it

## Other responses

- `default`: An error, with what went wrong and what to do next

---

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