---
title: "Changes to Update promotion"
method: PATCH
path: "/api/v1/promotions/{id}"
---

# Changes to Update promotion

`PATCH /api/v1/promotions/{id}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 2 of 9 revisions.

- **2026-07-07** `a3b4750a505f` — 25 info
- **2026-07-07** `84194c31ab85` — 14 breaking, 11 warning

## Changes

- **2026-07-07** `a3b4750a505f` — 25 info
  - added the new optional request property `accumulation`
  - added the new optional request property `active`
  - added the new optional request property `benefit`
  - added the new optional request property `conditions`
  - added the new optional request property `description`
  - added the new optional request property `eligibility`
  - added the new optional request property `item_restrictions`
  - added the new optional request property `metadata`
  - added the new optional request property `name`
  - added the new optional request property `usage_limits`
  - added the new optional request property `validity`
  - added the required property `accumulation` to the response with the `200` status
  - added the required property `active` to the response with the `200` status
  - added the required property `benefit` to the response with the `200` status
  - added the required property `code` to the response with the `200` status
  - added the required property `conditions` to the response with the `200` status
  - added the required property `created_at` to the response with the `200` status
  - added the required property `description` to the response with the `200` status
  - added the required property `eligibility` to the response with the `200` status
  - added the required property `id` to the response with the `200` status
  - added the required property `item_restrictions` to the response with the `200` status
  - added the required property `name` to the response with the `200` status
  - added the required property `updated_at` to the response with the `200` status
  - added the required property `usage_limits` to the response with the `200` status
  - added the required property `validity` to the response with the `200` status
- **2026-07-07** `84194c31ab85` — 14 breaking, 11 warning
  - removed the required property `accumulation` from the response with the `200` status
  - removed the required property `active` from the response with the `200` status
  - removed the required property `benefit` from the response with the `200` status
  - removed the required property `code` from the response with the `200` status
  - removed the required property `conditions` from the response with the `200` status
  - removed the required property `created_at` from the response with the `200` status
  - removed the required property `description` from the response with the `200` status
  - removed the required property `eligibility` from the response with the `200` status
  - removed the required property `id` from the response with the `200` status
  - removed the required property `item_restrictions` from the response with the `200` status
  - removed the required property `name` from the response with the `200` status
  - removed the required property `updated_at` from the response with the `200` status
  - removed the required property `usage_limits` from the response with the `200` status
  - removed the required property `validity` from the response with the `200` status
  - removed the request property `accumulation`
  - removed the request property `active`
  - removed the request property `benefit`
  - removed the request property `conditions`
  - removed the request property `description`
  - removed the request property `eligibility`
  - removed the request property `item_restrictions`
  - removed the request property `metadata`
  - removed the request property `name`
  - removed the request property `usage_limits`
  - removed the request property `validity`

---

[Operation](https://skmtc.dev/kruzer-corp/apis/oms-api/docs/api/v1/promotions/:id/patch.md) · [API](https://skmtc.dev/kruzer-corp/apis/oms-api.md) · [Page](https://skmtc.dev/kruzer-corp/apis/oms-api/changes/api/v1/promotions/:id/patch)