---
title: "Patch subscription add-ons"
method: PATCH
path: "/subscriptions/{subscriptionId}/add-ons"
tags: ["Subscriptions"]
---

# Patch subscription add-ons

`PATCH /subscriptions/{subscriptionId}/add-ons`

Partially update the quantity of one or more add-ons applied to the target subscription.
The add-ons specified must support editing of quantity for the designated quantity to be saved.

## Path parameters

- `subscriptionId` integer, required

## Headers

- `api-token` string, required

## Request body

- SubscriptionAddOnPatchReq
  - `addOns` SubscriptionAddOnPatch[]
    - `addOnId` integer, required — The id of the add-on applied to the subscription
    - `quantity` integer, required — The number of duplicates of the indicated add-on to apply to the target subscription. The add-on must support quantity editing to apply the specified quantity.

## Response `200`

Successful subscription add-on patch. The response body contains the data representation of all updated  subscription add-ons.

- SubscriptionAddOnPatchRes
  - `data` BaseSubscriptionAddOn[]
    - `addOnId` integer
    - `name` string
    - `description` string
    - `amount` number, float
    - `firstProcessedNumber` integer
    - `lastProcessedNumber` integer
    - `isActive` string
    - `frequency` string
    - `quantity` integer

## Other responses

- `400` — You are initiating a request with invalid parameter and/or body values.
- `401` — You are not authorized to access this resource. Please ensure that you are authenticated, and that you are using the `api-token` header
- `403` — You do not have permission to access this resource. Please ensure you are both authenticated and that you have the required roles/permissions active.
- `500` — Helcim internal server error encountered.

---

[API](https://skmtc.net/helcim/apis/the-helcim-api.md) · [All operations](https://skmtc.net/helcim/apis/the-helcim-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/helcim/the-helcim-api/versions/345052ca6578/schema)