---
title: "Turn auto-recharge on"
method: PUT
path: "/v1/users/me/auto-recharge"
tags: ["Users"]
---

# Turn auto-recharge on

`PUT /v1/users/me/auto-recharge`

## Request

- Base URL: `https://api.naturali.ai`
- URL: `https://api.naturali.ai/v1/users/me/auto-recharge`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://api.naturali.ai/authorize`, token URL `https://api.naturali.ai/token`, scopes: `mcp:access`)

Top up `amount_usd` on the saved card whenever the credit balance falls below `below_usd`. Checked every 15 minutes, at most one charge an hour. A declined charge turns it off and emails the account.

## Request body

- AutoRechargeUpdate
  - `amount_usd` number, required: US dollars per recharge, in whole cents.
  - `below_usd` number, required: Recharge when the balance falls below this, in whole cents.

## Response `200`

The setting.

- AutoRecharge
  - `enabled` boolean, required
  - `amount_usd` number, nullable, required: What each recharge buys. `null` while off.
  - `below_usd` number, nullable, required: The balance under which a recharge is charged. `null` while off.
  - `last_attempted_at` string, date-time, nullable, required: When a recharge was last charged, whatever its outcome.

## Other responses

- `400`: The request was malformed or failed validation.
- `401`: Missing or invalid credentials.
- `409`: The account has no saved card (`payment_method_required`).

---

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