---
title: "Update auto-recharge settings"
method: PUT
path: "/billing/auto-recharge"
tags: ["billing"]
---

# Update auto-recharge settings

`PUT /billing/auto-recharge`

Configures automatic balance top-up: when the balance drops below the threshold, a one-off invoice charges the saved payment method to restore it to the target. Requires an admin-role caller: an API key carries its creator's organization role, so the key must belong to an org admin. This only tunes when the saved payment method is charged — adding funds or payment methods stays in the dashboard.

## Request body

- SubscriptionAutoRechargeSettings — Auto-recharge configuration: top up the balance automatically when it drops below a threshold.
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `enabled` boolean, required — Whether auto-recharge is active.
  - `target_cents` integer, required — Balance the recharge restores to, in cents (minimum 500 = $5.00). The charge is target minus current balance.
  - `threshold_cents` integer, required — Recharge when the balance drops below this amount, in cents.

## Response `200`

OK

- SubscriptionAutoRechargeSettingsResponse — The org's auto-recharge configuration and status.
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `disabled_reason` 'payment_failed' — Why auto-recharge turned itself off (payment_failed), if it did. Re-enabling clears it.
  - `enabled` boolean, required — Whether auto-recharge is active.
  - `target_cents` integer, required — Balance the recharge restores to, in cents (minimum 500 = $5.00). The charge is target minus current balance.
  - `threshold_cents` integer, required — Recharge when the balance drops below this amount, in cents.

## Other responses

- `default` — Error

---

[API](https://skmtc.dev/axilioai/apis/axilio-api.md) · [All operations](https://skmtc.dev/axilioai/apis/axilio-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/axilioai/axilio-api/revisions/8a66f81813b3/schema)