---
title: "Set Auto Recharge"
method: PUT
path: "/me/billing/auto-recharge"
tags: ["User API"]
---

# Set Auto Recharge

`PUT /me/billing/auto-recharge`

## Request

- Base URL: `https://api.toolhouse.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.toolhouse.ai/me/billing/auto-recharge`
- Auth: HTTP bearer

Set the user's auto-recharge settings.

## Request body

- UpdateAutoRechargeRequest: Update auto-recharge settings. "Top up to a target balance when it drops to a threshold" — same mechanic as OpenAI's billing settings. `monthly_limit_dollars` caps auto-recharge spend specifically for the calendar month; `None` means no limit.
  - `enabled` boolean, required
  - `threshold_dollars` union, required
    - number
    - string
  - `target_dollars` union, required
    - number
    - string
  - `monthly_limit_dollars` union
    - number
    - string
  - `currency` 'usd' | 'eur', nullable

## Response `200`

Successfully updated auto-recharge settings

- BillingInformationSubscription: Billing Information Response
  - `user_id` string, required
  - `stripe_customer_id` string, required
  - `plan_type` 'trial' | 'trial_ended' | 'pay_as_you_go' | 'subscription', required
  - `has_payment_method` boolean
  - `currency` 'usd' | 'eur'
  - `auto_recharge_enabled` boolean
  - `auto_recharge_threshold_dollars` string
  - `auto_recharge_target_dollars` string
  - `auto_recharge_monthly_limit_dollars` string, nullable
  - `subscription_period_start` string, date-time, nullable
  - `subscription_period_end` string, date-time, nullable
  - `subscription_status` 'incomplete' | 'incomplete_expired' | 'trialing' | 'active' | 'past_due' | 'canceled' | 'unpaid' | 'paused', nullable
  - `interval` 'day' | 'week' | 'month' | 'year', nullable
  - `cancel_at_period_end` boolean, nullable
  - `price_id` string, nullable
  - `is_member_of_paid_organisation` boolean

## Other responses

- `404`: Billing information not found
- `422`: Validation Error
- `500`: Internal server error

## Changes

- **2026-10-05** `28d9c9649f65`: 2 info
  - added the new optional request property `currency`
  - added the optional property `currency` to the response with the `200` status
- **2026-10-01** `54dfd970c41f`: 1 info
  - added the optional property `is_member_of_paid_organisation` to the response with the `200` status
- **2026-09-30** `9dc55a5522bb`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/toolhouse/apis/toolhouse-api/changes/me/billing/auto-recharge/put.md)

---

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