---
title: "Enable or disable explicitly authorized auto-recharge"
method: PUT
path: "/v1/organizations/{organization_id}/billing/recharge"
---

# Enable or disable explicitly authorized auto-recharge

`PUT /v1/organizations/{organization_id}/billing/recharge`

## Request

- Base URL: `https://app.ohmyho.st`
- URL: `https://app.ohmyho.st/v1/organizations/{organization_id}/billing/recharge`
- Auth: HTTP bearer

Owner-only. An agent must obtain explicit approval for off-session charges and the gross monthly spending cap before enabling. Each refill costs USD 9 before tax for 1000 top-up credits when available credits fall below 100. Active Paid access is required to enable recharge and initiate a payment; remaining refill credits expire on downgrade to Free. A saved Stripe card is required; follow setup_url if returned. Current revision prevents stale edits; retry the original Idempotency-Key and payload after uncertainty. Disable prevents new charge initiation; already initiated payments may complete. No subscription or Paid features are created.

## Path parameters

- `organization_id` string, required

## Headers

- `X-Request-Id` string
- `Idempotency-Key` string, required

## Request body

- object
  - `enabled` boolean, required
  - `monthly_limit_minor` integer, required: Gross USD cents per UTC calendar month including tax.
  - `consent` 'off_session_v1' | 'null', nullable, required: Explicit Owner consent when enabling; null when disabling.
  - `revision` integer, required

## Response `200`

Saved policy and optional Stripe card setup.

- BillingRecharge
  - `organization_id` string, required
  - `portal_available` boolean, required: An existing customer in this billing account is ready for a hosted billing-portal handoff; this does not imply a paid subscription.
  - `enabled` boolean, required
  - `revision` integer, required
  - `status` 'off' | 'setup_required' | 'on' | 'payment_required' | 'monthly_limit' | 'needs_reconciliation' | 'tax_required', required
  - `monthly_limit_minor` integer, required
  - `spent_minor` integer, required
  - `currency` 'usd', required
  - `amount_minor` 900, required
  - `credits` 1000, required
  - `threshold_credits` 100, required
  - `setup_url` string, uri, nullable, required
  - `invoice_url` string, uri, nullable, required
  - `billing_issue` BillingTaxIssue, nullable, required: Verified issue on an existing Stripe invoice; no new purchase is needed.
    - `code` 'billing_tax_location_required' | 'billing_tax_calculation_failed' | 'billing_tax_configuration_required', required
    - `invoice_id` string, required
    - `observed_at` string, date-time, required
    - `required_action` 'open_billing_portal' | 'contact_support', required

## Other responses

- `400`: The request failed.
- `401`: The request failed.
- `402`: The request failed.
- `404`: The resource does not exist or is not visible to the authenticated principal.
- `409`: The request failed.
- `413`: The request failed.
- `429`: The request failed.
- `503`: The request failed.

---

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