---
title: "Updates the user's auto top-up settings (Roles: user)"
method: PUT
path: "/payment/topup/auto"
tags: ["Payments"]
---

# Updates the user's auto top-up settings (Roles: user)

`PUT /payment/topup/auto`

## Request body

- AutoTopupPayload
  - `enabled` boolean, required
  - `threshold` number, float
  - `credits` integer

## Response `200`

Success

- AutoTopupSettings
  - `enabled` boolean
  - `threshold` number, float — When available credits (max + extra - current) drop below this, an automatic top-up is attempted
  - `credits` integer — Fixed credit amount to buy on each automatic top-up (TOPUP bracket pricing)
  - `armed` boolean — Hysteresis latch: true while the balance is above the threshold; consumed (set false) by the single attempt per below-threshold episode

## Other responses

- `400` — Error

---

[API](https://skmtc.net/ludo/apis/ludo-ai-api.md) · [All operations](https://skmtc.net/ludo/apis/ludo-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ludo/ludo-ai-api/revisions/3af866d68651/schema)