---
title: "Update"
method: PATCH
path: "/subscriptions/{subscription_id}/update/"
---

# Update

`PATCH /subscriptions/{subscription_id}/update/`

Updates the "extra_data", "price", "components", "offer", and "cancel_reason" fields.

## Path parameters

- `subscription_id` string, required

## Request body

- object
  - `extra_data` string, json — JSON object that should be JSON.parse() as key/value store for any extra information.
  - `price` string — Price, must be in decimal form ex: 10.00
  - `components` unknown[] — Array of JSON objects to set product IDs that are the legacy bundle components. For example: "components": [ {"product":"123"}, {"product":"456"}, {"product":"789"} ],
    - unknown
  - `offer` string — Public ID of the new offer.
  - `cancel_reason` string — Pipe-delimited cancel reason code and cancel reason details, e.g. "4|Overstocked"

## Response `200`

200

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

## Other responses

- `400` — 400
- `403` — 403
- `404` — 404
- `423` — 423

---

[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)