---
title: "Changes to PUT /offers/{offer_id}/plans/{id}"
method: PUT
path: "/offers/{offer_id}/plans/{id}"
---

# Changes to PUT /offers/{offer_id}/plans/{id}

`PUT /offers/{offer_id}/plans/{id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 12 revisions.

- **2026-03-10** `ed203419a9a7`: 3 breaking, 7 warning, 13 info
- **2025-05-17** `2de715cbd1f3`: 2 breaking, 9 info
- **2023-12-01** `22a697bcb678`: 6 breaking, 9 warning, 1 info
- **2022-12-08** `86adefb0bb29`: 5 breaking, 11 info
- **2022-06-30** `6118e3620603`: 1 info
- **2021-09-27** `690ac65fe824`: 5 breaking, 9 warning, 1 info

## Changes

- **2026-03-10** `ed203419a9a7`: 3 breaking, 7 warning, 13 info
  - added the new required request property `color`
  - added the new required request property `name`
  - added the new required request property `periods`
  - removed the request property `countries`
  - removed the request property `form`
  - removed the request property `preset`
  - removed the optional property `countries` from the response with the `200` status
  - removed the optional property `form` from the response with the `200` status
  - removed the optional property `preset` from the response with the `200` status
  - removed the optional property `status` from the response with the `200` status
  - added the new optional request property `commitments`
  - added the new optional request property `description`
  - added the new optional request property `external_id`
  - added the new optional request property `gravity`
  - added the optional property `commitments` to the response with the `200` status
  - added the optional property `description` to the response with the `200` status
  - added the optional property `events` to the response with the `200` status
  - added the optional property `external_id` to the response with the `200` status
  - added the optional property `position` to the response with the `200` status
  - added the optional write-only property `gravity` to the response with the `200` status
  - added the required property `color` to the response with the `200` status
  - added the required property `name` to the response with the `200` status
  - added the required property `periods` to the response with the `200` status
- **2025-05-17** `2de715cbd1f3`: 2 breaking, 9 info
  - the request's body type changed from no type to `object`
  - the response's body type changed from no type to `object` for status `200`
  - added the new optional request property `countries`
  - added the new optional request property `form`
  - added the new optional request property `preset`
  - added the media type `application/json` for the response with the status `400`
  - added the optional property `countries` to the response with the `200` status
  - added the optional property `form` to the response with the `200` status
  - added the optional property `id` to the response with the `200` status
  - added the optional property `preset` to the response with the `200` status
  - added the optional property `status` to the response with the `200` status
- **2023-12-01** `22a697bcb678`: 6 breaking, 9 warning, 1 info
  - the request's body type changed from `object` to no type
  - the response's body type changed from `object` to no type for status `200`
  - removed the media type `application/json` for the response with the status `400`
  - removed the required property `color` from the response with the `200` status
  - removed the required property `name` from the response with the `200` status
  - removed the required property `periods` from the response with the `200` status
  - removed the request property `color`
  - removed the request property `description`
  - removed the request property `gravity`
  - removed the request property `name`
  - removed the request property `periods`
  - removed the optional property `description` from the response with the `200` status
  - removed the optional property `events` from the response with the `200` status
  - removed the optional property `id` from the response with the `200` status
  - removed the optional property `position` from the response with the `200` status
  - removed the optional write-only property `gravity` from the response with the `200` status
- **2022-12-08** `86adefb0bb29`: 5 breaking, 11 info
  - added the new required request property `color`
  - added the new required request property `name`
  - added the new required request property `periods`
  - the request's body type changed from no type to `object`
  - the response's body type changed from no type to `object` for status `200`
  - added the new optional request property `description`
  - added the new optional request property `gravity`
  - added the media type `application/json` for the response with the status `400`
  - added the optional property `description` to the response with the `200` status
  - added the optional property `events` to the response with the `200` status
  - added the optional property `id` to the response with the `200` status
  - added the optional property `position` to the response with the `200` status
  - added the optional write-only property `gravity` to the response with the `200` status
  - added the required property `color` to the response with the `200` status
  - added the required property `name` to the response with the `200` status
  - added the required property `periods` to the response with the `200` status
- **2022-06-30** `6118e3620603`: 1 info
  - api operation id `offers_plans_detail_updatePlanVersion` removed and replaced with `offers_offers_plans_detail_updatePlanVersion`
- **2021-09-27** `690ac65fe824`: 5 breaking, 9 warning, 1 info
  - the request's body type changed from `object` to no type
  - the response's body type changed from `object` to no type for status `200`
  - removed the required property `color` from the response with the `200` status
  - removed the required property `name` from the response with the `200` status
  - removed the required property `periods` from the response with the `200` status
  - removed the request property `color`
  - removed the request property `description`
  - removed the request property `gravity`
  - removed the request property `name`
  - removed the request property `periods`
  - removed the optional property `description` from the response with the `200` status
  - removed the optional property `events` from the response with the `200` status
  - removed the optional property `id` from the response with the `200` status
  - removed the optional property `position` from the response with the `200` status
  - removed the optional write-only property `gravity` from the response with the `200` status

---

[Operation](https://skmtc.dev/cloudblue/apis/cloudblue-connect-api/docs/offers/:offer_id/plans/:id/put.md) - [API](https://skmtc.dev/cloudblue/apis/cloudblue-connect-api.md) - [Page](https://skmtc.dev/cloudblue/apis/cloudblue-connect-api/changes/offers/:offer_id/plans/:id/put)
