---
title: "Update Prepaid Subscription"
method: PATCH
path: "/subscriptions/{subscription_id}/update_prepaid_context/"
---

# Update Prepaid Subscription

`PATCH /subscriptions/{subscription_id}/update_prepaid_context/`

This endpoint will allow you to modify the number of orders remaining, the number of orders per billing, and the renewal behavior for a prepaid subscription at any time during the lifecycle of the prepaid subscription

## Path parameters

- `subscription_id` string, required

## Request body

- object
  - `orders_per_billing` integer — A number greater than 1
  - `orders_remaining` integer — A number greater than or equal to 0
  - `renewal_behavior` 'autorenew' | 'cancel' | 'downgrade'

## Response `200`

200

- object
  - `customer` string
  - `merchant` string
  - `product` string
  - `payment` string
  - `shipping_address` string
  - `offer` string
  - `subscription_type` string
  - `raw_subscription_type` string
  - `components` object[]
  - `extra_data` object
    - `shopify_contract_id` string
  - `public_id` string
  - `quantity` integer
  - `price` unknown
  - `frequency_days` integer
  - `reminder_days` integer
  - `every` integer
  - `every_period` integer
  - `start_date` string
  - `cancelled` unknown
  - `cancel_reason` unknown
  - `iteration` unknown
  - `sequence` unknown
  - `session_id` string
  - `merchant_order_id` string
  - `created` string
  - `updated` string
  - `live` boolean
  - `external_id` string
  - `product_attribute` unknown
  - `cancel_reason_code` unknown
  - `customer_rep` unknown
  - `club` unknown
  - `queued_actions` object[]
  - `prepaid_subscription_context` object
    - `prepaid_orders_remaining` integer
    - `prepaid_orders_per_billing` integer
    - `renewal_behavior` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/ordergroove/apis/ordergroove-restrpc.md) · [All operations](https://skmtc.net/ordergroove/apis/ordergroove-restrpc/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ordergroove/ordergroove-restrpc/versions/ba97e740d08c/schema)