latestSwagger 2.02026-08-109450223.9 KB

94acb422c07d

Reseller

Update Reseller Subscription

Updates a subscription associated with the current reseller's managed accounts.

For approved subscriptions: updates minimum, billing_interval, and purchase_order.

For active subscriptions: toggles auto_renew and/or adds units via additional_units (with optional purchase_order).

patch/v1/reseller/subscriptions/{id}

Path parameters

idinteger required

Request body

minimuminteger

Minimum usage commitment (must be greater than zero)

purchase_orderstring

Purchase order number

billing_interval'monthly' | 'annual'

Billing interval

additional_unitsinteger

Units to add (active subscriptions only)

auto_renewboolean

Set auto-renew (active subscriptions only)

Response

Update Reseller Subscription

Example response

{
  "subscription": {
    "id": 1,
    "account": {
      "id": 1,
      "name": "Little Bobby's Table Emporium"
    },
    "product": "edr",
    "status": "active",
    "minimum_usage": 50,
    "terminal_minimum_usage": 100,
    "billing_interval": "monthly",
    "effective_date": "2024-01-01T00:00:00Z",
    "renewal_date": "2025-01-01T00:00:00Z",
    "auto_renew": true,
    "schedules": [
      {
        "id": 1,
        "minimum": 100,
        "maximum": 500,
        "status": "active",
        "target_price": 200,
        "months": 12,
        "promo_units": 0,
        "starts_at": "2024-01-01T00:00:00Z",
        "ends_at": "2025-01-01T00:00:00Z"
      }
    ]
  }
}