---
title: "Update wallet settings"
method: PUT
path: "/v1/wallet-settings"
tags: ["WalletSetting"]
---

# Update wallet settings

`PUT /v1/wallet-settings`

Updates wallet settings for a user wallet

## Request body

- object
  - `data` object, required
    - `autoReloadEnabled` boolean, required
    - `autoReloadMode` 'threshold' | 'prediction' — Rule used to decide when and how much to top up: `threshold` charges the fixed amount as soon as the balance reaches the threshold, `prediction` covers the next 7 days of projected spend. Defaults to `prediction` on create when omitted; left unchanged on update.
    - `autoReloadThreshold` number — USD credit balance at or below which an automatic top-up is triggered (minimum 10, maximum 10000). Defaults are applied on create when omitted.
    - `autoReloadAmount` number — USD amount charged on each automatic top-up (minimum 25, maximum 10000). Defaults are applied on create when omitted.

## Response `200`

Wallet settings updated successfully

- object
  - `data` object, required
    - `autoReloadEnabled` boolean, required
    - `autoReloadMode` 'threshold' | 'prediction', required — Rule used to decide when and how much to top up.
    - `autoReloadThreshold` number, required — USD credit balance at or below which an automatic top-up is triggered.
    - `autoReloadAmount` number, required — USD amount charged to the default payment method on each automatic top-up.

## Other responses

- `404` — UserWallet Not Found

## Changes

- **2026-08-26** `77a0df47eb74` — 2 breaking
  - the `data/autoReloadAmount` request property's min was increased to `25.00`
  - the `data/autoReloadThreshold` request property's min was increased to `10.00`
- **2026-08-20** `5ba174935de9` — 2 info
  - added the new optional request property `data/autoReloadMode`
  - added the required property `data/autoReloadMode` to the response with the `200` status
- **2026-08-07** `bb0b68662ba3` — 4 info
  - added the new optional request property `data/autoReloadAmount`
  - added the new optional request property `data/autoReloadThreshold`
  - added the required property `data/autoReloadAmount` to the response with the `200` status
  - added the required property `data/autoReloadThreshold` to the response with the `200` status
- **2026-07-20** `c3b0e234fc13` — 1 info
  - api operation id `updateWalletSettings` was added

[Change history](https://skmtc.dev/akash-network/apis/akash-network-console-api/changes/v1/wallet-settings/put.md)

---

[API](https://skmtc.dev/akash-network/apis/akash-network-console-api.md) · [All operations](https://skmtc.dev/akash-network/apis/akash-network-console-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/akash-network/akash-network-console-api/revisions/77a0df47eb74/schema)