---
title: "Deactivate Subscription Items"
method: POST
path: "/subscription/deactivatesubscriptionitems"
tags: ["Subscription API"]
---

# Deactivate Subscription Items

`POST /subscription/deactivatesubscriptionitems`

Deactivates one or more subscription items in a subscription.<br /><b>Important:</b> We do not recommend using this endpoint to cancel the only item of a single-item subscription or the last active item of a multi-item subscription. Use the [Update Subscription Renewal Type](https://dev.cleverbridge.com/reference/updatesubscriptionrenewaltype) endpoint to turn off the automatic renewal for the entire subscription instead. For XML examples and schemas, see the [Additional Examples - Deactivate Subscription Items](https://dev.cleverbridge.com/page/additional-examples-deactivate-subscription-items). For more information about managing subscriptions, see [Subscription Management 1.0 and 2.0](https://docs.cleverbridge.com/public/all/using-the-platform/subscription-management-1.0-and-2.0.htm).

## Headers

- `Accept` 'application/json' | 'application/xml'
- `Content-Type` 'application/json' | 'application/xml'

## Request body

- CleverbridgeBackEndRestApiSubscriptionClassesDeactivateSubscriptionItemsRequest
  - `AllowReinstate` boolean — Set to <code>true</code> if you want to be able to reinstate items at a later date. If set to <code>false</code>, the item status changes to <code>Finished</code>. If set to <code>false</code>, <code>GenerateMail</code> must also be set to <code>false</code>.
  - `GenerateMail` boolean — Set to <code>false</code> if you want to suppress the automatically generated email that informs the customer about the subscription update. Important: If set to <code>false</code>, you must send the email yourself. For more information, see [Best Practices: Obtaining Customer Consent](https://docs.cleverbridge.com/public/all/using-the-platform/best-practices-obtain-customer-consent.htm?utm_source=developer-docs&amp;utm_medium=api-reference).
  - `Items` integer[], required — Running numbers of the subscription items you want to deactivate.
  - `SubscriptionId` string, required — Unique ID of the subscription, with or without an initial 'S'.

## Response `200`

OK

- CleverbridgeBackEndRestApiSubscriptionClassesDeactivateSubscriptionItemsResponse
  - `ResultMessage` string — Optional result or error message.

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `500` — Internal Server Error

---

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