---
title: "Turn auto top-up off and/or change its threshold; turning it on or changing its amount requires POST .../setup instead"
method: PATCH
path: "/v1/credit/auto-topup"
---

# Turn auto top-up off and/or change its threshold; turning it on or changing its amount requires POST .../setup instead

`PATCH /v1/credit/auto-topup`

## Request

- Base URL: `https://volai.cz`
- URL: `https://volai.cz/v1/credit/auto-topup`
- Auth: HTTP bearer

EXCLUSIVELY turning it off (`{"enabled": false}`) and/or changing the threshold (`{"thresholdHal": ...}`) - turning it on or changing the amount only goes through `POST .../setup` (Stripe Checkout), never a direct write, so a plain `enabled: true` can never trigger charging on a saved card without a human at it.

## Request body

- object
  - `enabled` false: Only false is accepted here, to turn auto top-up off. Enable it via POST /v1/credit/auto-topup/setup.
  - `thresholdHal` integer: Balance threshold that triggers an automatic top-up, in integer halere excluding VAT. Changing only this value does not charge the card.

## Response `200`

Updated auto top-up state

- object
  - `autoTopup` object, required
    - `enabled` boolean, required
    - `thresholdHal` number, nullable, required
    - `amountHal` number, nullable, required
    - `card` object, nullable, required
      - `brand` string, required
      - `last4` string, required
    - `spentThisMonthHal` number, required
    - `monthlyCapHal` number, required
    - `disabledReason` 'card_declined' | 'authentication_required' | 'monthly_cap' | 'daily_cap', nullable, required

## Other responses

- `400`: Error codes: validation (request), autotopup_not_configured (account), invalid_amount (request).
- `401`: Error codes: unauthorized (request).
- `403`: Error codes: account_suspended (account).
- `429`: Error codes: rate_limited (busy).
- `500`: Error codes: internal_error (service).

---

[API](https://skmtc.dev/volai/apis/volai-rest-api.md) · [All operations](https://skmtc.dev/volai/apis/volai-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/volai/apis/volai-rest-api/revisions/12029b05e2fa?raw)