---
uuid: d9380750-97c7-4e6c-8d84-e5e851dfb721
date_created: 2025-07-05T08:07:46.695Z
date_updated: 2026-03-11T09:25:53.710Z
outdated: true
end_of_support_date: 2025-09-01
routes: 
  - PATCH /v0/subscriptions/{subscription_id}
---

# Migration of the endpoint PATCH /v0/subscriptions/{subscription\_id} to PATCH /v1/subscriptions/{subscription\_id}

## Context

Upgrade from **PATCH** - `/v0/subscriptions/{subscription_id}` to **PATCH** - `/v1/subscriptions/{subscription_id}`

⭐ **Key benefit :**

* Complete revamp of the endpoint to make it easier to use

## Impacts

Route to call :

* **PATCH** - `/v1/subscriptions/{subscription_id}`

**Input became**

In order to make it easier to use, we changed this endpoint to now only allow two operations : subscribe & unsubscribe.

**unsubscribe**
Input example :

```
{
  "operation": "unsubscribe"
}
```

There is only one possible input to unsubscribe

***

**subscribe**
Input example :

```
{
  "operation": "subscribe",
  "parameters": {
    "newsletter_subscriptions": [
      "CLUBMED"
    ],
    "origin_code": "CUSTOMER_ACCOUNT"
  }
}
```

`parameters.newsletter_subscriptions` is mandatory and must contain at least 1 item.
`parameters.origin_code` is optional

You can subscribe only if you previously unsubscribed for this subscription\_id.
For new subscription you may use the endpoint **POST /v1/subscriptions**