Enable or disable explicitly authorized auto-recharge

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.

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

Path parameters

organization_idstring required

Headers

X-Request-Idstring

Optional caller-provided correlation identifier.

Idempotency-Keystring required

Identifies one mutation and its canonical request payload.

Request body

enabledboolean required
monthly_limit_minorinteger 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.

revisioninteger required

Response

Saved policy and optional Stripe card setup.

organization_idstring required
portal_availableboolean required

An existing customer in this billing account is ready for a hosted billing-portal handoff; this does not imply a paid subscription.

enabledboolean required
revisioninteger required
status'off' | 'setup_required' | 'on' | 'payment_required' | 'monthly_limit' | 'needs_reconciliation' | 'tax_required' required
monthly_limit_minorinteger required
spent_minorinteger required
currency'usd' required
amount_minor900 required
credits1000 required
threshold_credits100 required
setup_urlstring uri nullable required
invoice_urlstring uri nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.