---
title: "Update Auto Recharge"
method: PUT
path: "/v0/billing/auto-recharge"
tags: ["Billing"]
---

# Update Auto Recharge

`PUT /v0/billing/auto-recharge`

Update auto-recharge settings atomically.

- ``enabled`` (required) – enable or disable auto-recharge.
- ``threshold`` (optional) – the credit balance that triggers a top-up.
- ``qty`` (optional) – the amount of credits to add per top-up.

When *enabling*, the account must have met the minimum spending
threshold (fraud-prevention measure).  ``qty`` must be ≥ $25.

Context (personal vs org) is derived from the API key.
Returns the updated settings + eligibility (same shape as GET).

## Request body

- AutoRechargeUpdateRequest — Request body for ``PUT /billing/auto-recharge``. Only ``enabled`` is required. ``threshold`` and ``qty`` are optional so callers can toggle the feature on/off without re-sending the amounts.
  - `enabled` boolean, required
  - `threshold` number, nullable
  - `qty` number, nullable

## Response `200`

Auto-recharge settings updated

- AutoRechargeResponse — Combined auto-recharge settings and eligibility. Returned by ``GET /billing/auto-recharge``.
  - `enabled` boolean
  - `threshold` number
  - `qty` number
  - `min_recharge_amount` number
  - `eligible` boolean
  - `total_spending` number
  - `minimum_spend_required` number
  - `remaining_spend_needed` number
  - `has_payment_method` boolean
  - `blocked_reason` string, nullable

## Other responses

- `400` — Validation error or eligibility not met
- `422` — Validation Error

---

[API](https://skmtc.net/unify/apis/unifyai-http-api-reference.md) · [All operations](https://skmtc.net/unify/apis/unifyai-http-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unify/unifyai-http-api-reference/revisions/900377f918b6/schema)