v1

latestOpenAPI 3.1.0AGPL-3.0-only2026-07-1773264353.7 KB

Subscriptions

Update subscription

Update subscription settings like payment configuration, billing options, etc.

patch/api/v1/subscriptions/{subscription_id}

subscription_idstring MeteroidId required

Example:sub_7n42DGM5Tflk9n8mt7Fhc7

Subscription ID

auto_advance_invoicesboolean nullable

If false, invoices will stay in Draft until manually reviewed and finalized.

charge_automaticallyboolean nullable

Automatically try to charge the customer's configured payment method on finalize.

invoice_memostring nullable

Default memo for invoices

net_termsinteger nullable

Payment terms in days (0 = due on issue)

purchase_orderstring nullable

Purchase order number

{
  "payment_methods_config": {
    "account_id": "ba_7n42DGM5Tflk9n8mt7Fhc7"
  }
}

Subscription updated