---
title: "Changes to Update Card Definition"
method: PUT
path: "/v2/loyalties/card-definitions/{cardDefinitionId}"
---

# Changes to Update Card Definition

`PUT /v2/loyalties/card-definitions/{cardDefinitionId}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 16 of 211 revisions.

- **2026-10-14** (v2) `d29b33490051`: 13 breaking, 14 warning, 1 info
- **2026-10-14** (v2) `be14b3318eb3`: 13 breaking, 5 warning, 10 info
- **2026-10-14** (v2) `6a418ac8b7b1`: 13 breaking, 14 warning, 1 info
- **2026-10-14** (v2) `ec801ade260d`: 17 breaking, 11 warning, 1 info
- **2026-10-13** (v2) `f95b50556c93`: 1 breaking, 1 warning, 27 info
- **2026-10-13** (v2) `9905dfce1d1e`: 17 breaking, 11 warning, 1 info
- **2026-10-13** (v2) `c59a345c733b`: 1 breaking, 1 warning, 27 info
- **2026-10-13** (v2) `4d4d694f1847`: 17 breaking, 11 warning, 1 info
- **2026-10-13** (v2) `84ad572f8dcb`: 1 breaking, 1 warning, 27 info
- **2026-10-13** (v2) `58624588b18c`: 17 breaking, 11 warning, 1 info
- **2026-10-13** (v2) `100ea5942966`: 1 breaking, 1 warning, 27 info
- **2026-10-13** (v2) `ed683aacf90a`: 17 breaking, 11 warning, 1 info
- **2026-10-07** (v2) `338a5e34004e`: 2 info
- **2026-10-06** (v2) `b50db1d1d5fe`: 1 breaking, 1 info
- **2026-10-01** (v2) `749b6d105462`: 1 breaking, 1 warning
- **2026-07-17** (v2) `4cbaee5a82d5`: 8 info

## Changes

- **2026-10-14** (v2) `d29b33490051`: 13 breaking, 14 warning, 1 info
  - added `#/components/schemas/CardDefinitionPeriodInput` to the `allOf[#/components/schemas/CardDefinitionUpdateRequest]/pending_points/oneOf[#/components/schemas/CardDefinitionPendingPointsInput]/event_based/oneOf[#/components/schemas/CardDefinitionPendingPointsEventBasedInput]/cancel_period` request property `allOf` list
  - added `#/components/schemas/CardDefinitionPeriodInput` to the `allOf[#/components/schemas/CardDefinitionUpdateRequest]/pending_points/oneOf[#/components/schemas/CardDefinitionPendingPointsInput]/period_based/oneOf[#/components/schemas/CardDefinitionPendingPointsPeriodBasedInput]/period` request property `allOf` list
  - added `#/components/schemas/CardDefinitionSlidingExpirationActivityBase, subschema #2` to the `allOf[#/components/schemas/CardDefinitionUpdateRequest]/points_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationInput]/sliding_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationSlidingExpirationInput]/` request property `allOf` list
  - added `#/components/schemas/CardDefinitionTimeBasedCurrentPeriodInput` to the `allOf[#/components/schemas/CardDefinitionUpdateRequest]/earning_limits/oneOf[#/components/schemas/CardDefinitionEarningLimitsInput]/global/limits/items/oneOf[subschema #2]/period/current_period/oneOf[#/components/schemas/CardDefinitionEarningLimitsGlobalTimeBasedCurrentPeriodInput]/` request property `allOf` list
  - added `#/components/schemas/CardDefinitionTimeBasedCurrentPeriodInput` to the `allOf[#/components/schemas/CardDefinitionUpdateRequest]/spending_limits/oneOf[#/components/schemas/CardDefinitionSpendingLimitsInput]/global/limits/items/oneOf[subschema #2]/period/current_period/oneOf[#/components/schemas/CardDefinitionSpendingLimitsGlobalTimeBasedCurrentPeriodInput]/` request property `allOf` list
  - the `allOf[#/components/schemas/CardDefinitionUpdateRequest]/earning_limits/oneOf[#/components/schemas/CardDefinitionEarningLimitsInput]/global/limits/items/oneOf[subschema #2]/period/current_period/oneOf[#/components/schemas/CardDefinitionEarningLimitsGlobalTimeBasedCurrentPeriodInput]/` request property type changed from `object` to no type
  - the `allOf[#/components/schemas/CardDefinitionUpdateRequest]/pending_points/oneOf[#/components/schemas/CardDefinitionPendingPointsInput]/event_based/oneOf[#/components/schemas/CardDefinitionPendingPointsEventBasedInput]/cancel_period` request property type changed from `object` to no type
  - the `allOf[#/components/schemas/CardDefinitionUpdateRequest]/pending_points/oneOf[#/components/schemas/CardDefinitionPendingPointsInput]/period_based/oneOf[#/components/schemas/CardDefinitionPendingPointsPeriodBasedInput]/period` request property type changed from `object` to no type
  - the `allOf[#/components/schemas/CardDefinitionUpdateRequest]/points_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationInput]/sliding_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationSlidingExpirationInput]/` request property type changed from `object` to no type
  - the `allOf[#/components/schemas/CardDefinitionUpdateRequest]/spending_limits/oneOf[#/components/schemas/CardDefinitionSpendingLimitsInput]/global/limits/items/oneOf[subschema #2]/period/current_period/oneOf[#/components/schemas/CardDefinitionSpendingLimitsGlobalTimeBasedCurrentPeriodInput]/` request property type changed from `object` to no type
  - the `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration` response's property type changed from `object` to no type for status `200`
  - removed the required property `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration/custom_activity_types` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration/period` from the response with the `200` status
  - removed the request property `allOf[#/components/schemas/CardDefinitionUpdateRequest]/earning_limits/oneOf[#/components/schemas/CardDefinitionEarningLimitsInput]/global/limits/items/oneOf[subschema #2]/period/current_period/oneOf[#/components/schemas/CardDefinitionEarningLimitsGlobalTimeBasedCurrentPeriodInput]/unit`
  - removed the request property `allOf[#/components/schemas/CardDefinitionUpdateRequest]/pending_points/oneOf[#/components/schemas/CardDefinitionPendingPointsInput]/event_based/oneOf[#/components/schemas/CardDefinitionPendingPointsEventBasedInput]/cancel_period/unit`
  - removed the request property `allOf[#/components/schemas/CardDefinitionUpdateRequest]/pending_points/oneOf[#/components/schemas/CardDefinitionPendingPointsInput]/event_based/oneOf[#/components/schemas/CardDefinitionPendingPointsEventBasedInput]/cancel_period/value`
  - removed the request property `allOf[#/components/schemas/CardDefinitionUpdateRequest]/pending_points/oneOf[#/components/schemas/CardDefinitionPendingPointsInput]/period_based/oneOf[#/components/schemas/CardDefinitionPendingPointsPeriodBasedInput]/period/unit`
  - removed the request property `allOf[#/components/schemas/CardDefinitionUpdateRequest]/pending_points/oneOf[#/components/schemas/CardDefinitionPendingPointsInput]/period_based/oneOf[#/components/schemas/CardDefinitionPendingPointsPeriodBasedInput]/period/value`
  - removed the request property `allOf[#/components/schemas/CardDefinitionUpdateRequest]/points_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationInput]/sliding_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationSlidingExpirationInput]/custom_activity`
  - removed the request property `allOf[#/components/schemas/CardDefinitionUpdateRequest]/points_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationInput]/sliding_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationSlidingExpirationInput]/custom_activity_types`
  - removed the request property `allOf[#/components/schemas/CardDefinitionUpdateRequest]/points_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationInput]/sliding_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationSlidingExpirationInput]/earning_activity`
  - removed the request property `allOf[#/components/schemas/CardDefinitionUpdateRequest]/points_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationInput]/sliding_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationSlidingExpirationInput]/period`
  - removed the request property `allOf[#/components/schemas/CardDefinitionUpdateRequest]/points_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationInput]/sliding_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationSlidingExpirationInput]/spending_activity`
  - removed the request property `allOf[#/components/schemas/CardDefinitionUpdateRequest]/spending_limits/oneOf[#/components/schemas/CardDefinitionSpendingLimitsInput]/global/limits/items/oneOf[subschema #2]/period/current_period/oneOf[#/components/schemas/CardDefinitionSpendingLimitsGlobalTimeBasedCurrentPeriodInput]/unit`
  - removed the optional property `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration/custom_activity` from the response with the `200` status
  - removed the optional property `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration/earning_activity` from the response with the `200` status
  - removed the optional property `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration/spending_activity` from the response with the `200` status
  - added `#/components/schemas/CardDefinitionSlidingExpirationActivityBase, subschema #2` to the `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration` response property `allOf` list for the response status `200`
- **2026-10-14** (v2) `be14b3318eb3`: 13 breaking, 5 warning, 10 info
  - added the new required request property `allOf[#/components/schemas/CardDefinitionUpdateRequest]/earning_limits/oneOf[#/components/schemas/CardDefinitionEarningLimitsInput]/global/limits/items/oneOf[subschema #2]/period/current_period/oneOf[#/components/schemas/CardDefinitionEarningLimitsGlobalTimeBasedCurrentPeriodInput]/unit`
  - added the new required request property `allOf[#/components/schemas/CardDefinitionUpdateRequest]/pending_points/oneOf[#/components/schemas/CardDefinitionPendingPointsInput]/event_based/oneOf[#/components/schemas/CardDefinitionPendingPointsEventBasedInput]/cancel_period/unit`
  - added the new required request property `allOf[#/components/schemas/CardDefinitionUpdateRequest]/pending_points/oneOf[#/components/schemas/CardDefinitionPendingPointsInput]/event_based/oneOf[#/components/schemas/CardDefinitionPendingPointsEventBasedInput]/cancel_period/value`
  - added the new required request property `allOf[#/components/schemas/CardDefinitionUpdateRequest]/pending_points/oneOf[#/components/schemas/CardDefinitionPendingPointsInput]/period_based/oneOf[#/components/schemas/CardDefinitionPendingPointsPeriodBasedInput]/period/unit`
  - added the new required request property `allOf[#/components/schemas/CardDefinitionUpdateRequest]/pending_points/oneOf[#/components/schemas/CardDefinitionPendingPointsInput]/period_based/oneOf[#/components/schemas/CardDefinitionPendingPointsPeriodBasedInput]/period/value`
  - added the new required request property `allOf[#/components/schemas/CardDefinitionUpdateRequest]/points_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationInput]/sliding_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationSlidingExpirationInput]/period`
  - added the new required request property `allOf[#/components/schemas/CardDefinitionUpdateRequest]/spending_limits/oneOf[#/components/schemas/CardDefinitionSpendingLimitsInput]/global/limits/items/oneOf[subschema #2]/period/current_period/oneOf[#/components/schemas/CardDefinitionSpendingLimitsGlobalTimeBasedCurrentPeriodInput]/unit`
  - the `allOf[#/components/schemas/CardDefinitionUpdateRequest]/earning_limits/oneOf[#/components/schemas/CardDefinitionEarningLimitsInput]/global/limits/items/oneOf[subschema #2]/period/current_period/oneOf[#/components/schemas/CardDefinitionEarningLimitsGlobalTimeBasedCurrentPeriodInput]/` request property type changed from no type to `object`
  - the `allOf[#/components/schemas/CardDefinitionUpdateRequest]/pending_points/oneOf[#/components/schemas/CardDefinitionPendingPointsInput]/event_based/oneOf[#/components/schemas/CardDefinitionPendingPointsEventBasedInput]/cancel_period` request property type changed from no type to `object`
  - the `allOf[#/components/schemas/CardDefinitionUpdateRequest]/pending_points/oneOf[#/components/schemas/CardDefinitionPendingPointsInput]/period_based/oneOf[#/components/schemas/CardDefinitionPendingPointsPeriodBasedInput]/period` request property type changed from no type to `object`
  - the `allOf[#/components/schemas/CardDefinitionUpdateRequest]/points_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationInput]/sliding_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationSlidingExpirationInput]/` request property type changed from no type to `object`
  - the `allOf[#/components/schemas/CardDefinitionUpdateRequest]/spending_limits/oneOf[#/components/schemas/CardDefinitionSpendingLimitsInput]/global/limits/items/oneOf[subschema #2]/period/current_period/oneOf[#/components/schemas/CardDefinitionSpendingLimitsGlobalTimeBasedCurrentPeriodInput]/` request property type changed from no type to `object`
  - the `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration` response's property type changed from no type to `object` for status `200`
  - removed `#/components/schemas/CardDefinitionPeriodInput` from the `allOf[#/components/schemas/CardDefinitionUpdateRequest]/pending_points/oneOf[#/components/schemas/CardDefinitionPendingPointsInput]/event_based/oneOf[#/components/schemas/CardDefinitionPendingPointsEventBasedInput]/cancel_period` request property `allOf` list
  - removed `#/components/schemas/CardDefinitionPeriodInput` from the `allOf[#/components/schemas/CardDefinitionUpdateRequest]/pending_points/oneOf[#/components/schemas/CardDefinitionPendingPointsInput]/period_based/oneOf[#/components/schemas/CardDefinitionPendingPointsPeriodBasedInput]/period` request property `allOf` list
  - removed `#/components/schemas/CardDefinitionSlidingExpirationActivityBase, subschema #2` from the `allOf[#/components/schemas/CardDefinitionUpdateRequest]/points_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationInput]/sliding_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationSlidingExpirationInput]/` request property `allOf` list
  - removed `#/components/schemas/CardDefinitionTimeBasedCurrentPeriodInput` from the `allOf[#/components/schemas/CardDefinitionUpdateRequest]/earning_limits/oneOf[#/components/schemas/CardDefinitionEarningLimitsInput]/global/limits/items/oneOf[subschema #2]/period/current_period/oneOf[#/components/schemas/CardDefinitionEarningLimitsGlobalTimeBasedCurrentPeriodInput]/` request property `allOf` list
  - removed `#/components/schemas/CardDefinitionTimeBasedCurrentPeriodInput` from the `allOf[#/components/schemas/CardDefinitionUpdateRequest]/spending_limits/oneOf[#/components/schemas/CardDefinitionSpendingLimitsInput]/global/limits/items/oneOf[subschema #2]/period/current_period/oneOf[#/components/schemas/CardDefinitionSpendingLimitsGlobalTimeBasedCurrentPeriodInput]/` request property `allOf` list
  - added the new optional request property `allOf[#/components/schemas/CardDefinitionUpdateRequest]/points_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationInput]/sliding_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationSlidingExpirationInput]/custom_activity`
  - added the new optional request property `allOf[#/components/schemas/CardDefinitionUpdateRequest]/points_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationInput]/sliding_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationSlidingExpirationInput]/custom_activity_types`
  - added the new optional request property `allOf[#/components/schemas/CardDefinitionUpdateRequest]/points_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationInput]/sliding_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationSlidingExpirationInput]/earning_activity`
  - added the new optional request property `allOf[#/components/schemas/CardDefinitionUpdateRequest]/points_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationInput]/sliding_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationSlidingExpirationInput]/spending_activity`
  - added the optional property `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration/custom_activity` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration/earning_activity` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration/spending_activity` to the response with the `200` status
  - removed `#/components/schemas/CardDefinitionSlidingExpirationActivityBase, subschema #2` from the `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration` response property `allOf` list for the response status `200`
  - added the required property `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration/custom_activity_types` to the response with the `200` status
  - added the required property `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration/period` to the response with the `200` status
- **2026-10-14** (v2) `6a418ac8b7b1`: 13 breaking, 14 warning, 1 info
  - added `#/components/schemas/CardDefinitionPeriodInput` to the `allOf[#/components/schemas/CardDefinitionUpdateRequest]/pending_points/oneOf[#/components/schemas/CardDefinitionPendingPointsInput]/event_based/oneOf[#/components/schemas/CardDefinitionPendingPointsEventBasedInput]/cancel_period` request property `allOf` list
  - added `#/components/schemas/CardDefinitionPeriodInput` to the `allOf[#/components/schemas/CardDefinitionUpdateRequest]/pending_points/oneOf[#/components/schemas/CardDefinitionPendingPointsInput]/period_based/oneOf[#/components/schemas/CardDefinitionPendingPointsPeriodBasedInput]/period` request property `allOf` list
  - added `#/components/schemas/CardDefinitionSlidingExpirationActivityBase, subschema #2` to the `allOf[#/components/schemas/CardDefinitionUpdateRequest]/points_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationInput]/sliding_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationSlidingExpirationInput]/` request property `allOf` list
  - added `#/components/schemas/CardDefinitionTimeBasedCurrentPeriodInput` to the `allOf[#/components/schemas/CardDefinitionUpdateRequest]/earning_limits/oneOf[#/components/schemas/CardDefinitionEarningLimitsInput]/global/limits/items/oneOf[subschema #2]/period/current_period/oneOf[#/components/schemas/CardDefinitionEarningLimitsGlobalTimeBasedCurrentPeriodInput]/` request property `allOf` list
  - added `#/components/schemas/CardDefinitionTimeBasedCurrentPeriodInput` to the `allOf[#/components/schemas/CardDefinitionUpdateRequest]/spending_limits/oneOf[#/components/schemas/CardDefinitionSpendingLimitsInput]/global/limits/items/oneOf[subschema #2]/period/current_period/oneOf[#/components/schemas/CardDefinitionSpendingLimitsGlobalTimeBasedCurrentPeriodInput]/` request property `allOf` list
  - the `allOf[#/components/schemas/CardDefinitionUpdateRequest]/earning_limits/oneOf[#/components/schemas/CardDefinitionEarningLimitsInput]/global/limits/items/oneOf[subschema #2]/period/current_period/oneOf[#/components/schemas/CardDefinitionEarningLimitsGlobalTimeBasedCurrentPeriodInput]/` request property type changed from `object` to no type
  - the `allOf[#/components/schemas/CardDefinitionUpdateRequest]/pending_points/oneOf[#/components/schemas/CardDefinitionPendingPointsInput]/event_based/oneOf[#/components/schemas/CardDefinitionPendingPointsEventBasedInput]/cancel_period` request property type changed from `object` to no type
  - the `allOf[#/components/schemas/CardDefinitionUpdateRequest]/pending_points/oneOf[#/components/schemas/CardDefinitionPendingPointsInput]/period_based/oneOf[#/components/schemas/CardDefinitionPendingPointsPeriodBasedInput]/period` request property type changed from `object` to no type
  - the `allOf[#/components/schemas/CardDefinitionUpdateRequest]/points_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationInput]/sliding_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationSlidingExpirationInput]/` request property type changed from `object` to no type
  - the `allOf[#/components/schemas/CardDefinitionUpdateRequest]/spending_limits/oneOf[#/components/schemas/CardDefinitionSpendingLimitsInput]/global/limits/items/oneOf[subschema #2]/period/current_period/oneOf[#/components/schemas/CardDefinitionSpendingLimitsGlobalTimeBasedCurrentPeriodInput]/` request property type changed from `object` to no type
  - the `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration` response's property type changed from `object` to no type for status `200`
  - removed the required property `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration/custom_activity_types` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration/period` from the response with the `200` status
  - removed the request property `allOf[#/components/schemas/CardDefinitionUpdateRequest]/earning_limits/oneOf[#/components/schemas/CardDefinitionEarningLimitsInput]/global/limits/items/oneOf[subschema #2]/period/current_period/oneOf[#/components/schemas/CardDefinitionEarningLimitsGlobalTimeBasedCurrentPeriodInput]/unit`
  - removed the request property `allOf[#/components/schemas/CardDefinitionUpdateRequest]/pending_points/oneOf[#/components/schemas/CardDefinitionPendingPointsInput]/event_based/oneOf[#/components/schemas/CardDefinitionPendingPointsEventBasedInput]/cancel_period/unit`
  - removed the request property `allOf[#/components/schemas/CardDefinitionUpdateRequest]/pending_points/oneOf[#/components/schemas/CardDefinitionPendingPointsInput]/event_based/oneOf[#/components/schemas/CardDefinitionPendingPointsEventBasedInput]/cancel_period/value`
  - removed the request property `allOf[#/components/schemas/CardDefinitionUpdateRequest]/pending_points/oneOf[#/components/schemas/CardDefinitionPendingPointsInput]/period_based/oneOf[#/components/schemas/CardDefinitionPendingPointsPeriodBasedInput]/period/unit`
  - removed the request property `allOf[#/components/schemas/CardDefinitionUpdateRequest]/pending_points/oneOf[#/components/schemas/CardDefinitionPendingPointsInput]/period_based/oneOf[#/components/schemas/CardDefinitionPendingPointsPeriodBasedInput]/period/value`
  - removed the request property `allOf[#/components/schemas/CardDefinitionUpdateRequest]/points_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationInput]/sliding_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationSlidingExpirationInput]/custom_activity`
  - removed the request property `allOf[#/components/schemas/CardDefinitionUpdateRequest]/points_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationInput]/sliding_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationSlidingExpirationInput]/custom_activity_types`
  - removed the request property `allOf[#/components/schemas/CardDefinitionUpdateRequest]/points_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationInput]/sliding_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationSlidingExpirationInput]/earning_activity`
  - removed the request property `allOf[#/components/schemas/CardDefinitionUpdateRequest]/points_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationInput]/sliding_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationSlidingExpirationInput]/period`
  - removed the request property `allOf[#/components/schemas/CardDefinitionUpdateRequest]/points_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationInput]/sliding_expiration/oneOf[#/components/schemas/CardDefinitionPointsExpirationSlidingExpirationInput]/spending_activity`
  - removed the request property `allOf[#/components/schemas/CardDefinitionUpdateRequest]/spending_limits/oneOf[#/components/schemas/CardDefinitionSpendingLimitsInput]/global/limits/items/oneOf[subschema #2]/period/current_period/oneOf[#/components/schemas/CardDefinitionSpendingLimitsGlobalTimeBasedCurrentPeriodInput]/unit`
  - removed the optional property `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration/custom_activity` from the response with the `200` status
  - removed the optional property `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration/earning_activity` from the response with the `200` status
  - removed the optional property `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration/spending_activity` from the response with the `200` status
  - added `#/components/schemas/CardDefinitionSlidingExpirationActivityBase, subschema #2` to the `allOf[#/components/schemas/CardDefinition]/points_expiration/sliding_expiration` response property `allOf` list for the response status `200`
- **2026-10-14** (v2) `ec801ade260d`: 17 breaking, 11 warning, 1 info
  - added `#/components/schemas/CardDefinitionUpdateRequest` to the request body `allOf` list
  - removed the required property `balance_settings` from the response with the `200` status
  - removed the required property `code_config` from the response with the `200` status
  - removed the required property `created_at` from the response with the `200` status
  - removed the required property `earning_limits` from the response with the `200` status
  - removed the required property `id` from the response with the `200` status
  - removed the required property `metadata` from the response with the `200` status
  - removed the required property `name` from the response with the `200` status
  - removed the required property `object` from the response with the `200` status
  - removed the required property `pay_with_points` from the response with the `200` status
  - removed the required property `pending_points` from the response with the `200` status
  - removed the required property `points_expiration` from the response with the `200` status
  - removed the required property `refunds` from the response with the `200` status
  - removed the required property `spending_limits` from the response with the `200` status
  - removed the required property `status` from the response with the `200` status
  - removed the required property `type` from the response with the `200` status
  - removed the required property `updated_at` from the response with the `200` status
  - deleted the `path` request parameter `cardDefinitionId`
  - removed the request property `balance_settings`
  - removed the request property `code_config`
  - removed the request property `earning_limits`
  - removed the request property `metadata`
  - removed the request property `name`
  - removed the request property `pay_with_points`
  - removed the request property `pending_points`
  - removed the request property `points_expiration`
  - removed the request property `refunds`
  - removed the request property `spending_limits`
  - added `#/components/schemas/CardDefinition` to the response body `allOf` list for the response status `200`
- **2026-10-13** (v2) `f95b50556c93`: 1 breaking, 1 warning, 27 info
  - added the new path request parameter `cardDefinitionId`
  - removed `#/components/schemas/CardDefinitionUpdateRequest` from the request body `allOf` list
  - added the new optional request property `balance_settings`
  - added the new optional request property `code_config`
  - added the new optional request property `earning_limits`
  - added the new optional request property `metadata`
  - added the new optional request property `name`
  - added the new optional request property `pay_with_points`
  - added the new optional request property `pending_points`
  - added the new optional request property `points_expiration`
  - added the new optional request property `refunds`
  - added the new optional request property `spending_limits`
  - removed `#/components/schemas/CardDefinition` from the response body `allOf` list for the response status `200`
  - added the required property `balance_settings` to the response with the `200` status
  - added the required property `code_config` to the response with the `200` status
  - added the required property `created_at` to the response with the `200` status
  - added the required property `earning_limits` to the response with the `200` status
  - added the required property `id` to the response with the `200` status
  - added the required property `metadata` to the response with the `200` status
  - added the required property `name` to the response with the `200` status
  - added the required property `object` to the response with the `200` status
  - added the required property `pay_with_points` to the response with the `200` status
  - added the required property `pending_points` to the response with the `200` status
  - added the required property `points_expiration` to the response with the `200` status
  - added the required property `refunds` to the response with the `200` status
  - added the required property `spending_limits` to the response with the `200` status
  - added the required property `status` to the response with the `200` status
  - added the required property `type` to the response with the `200` status
  - added the required property `updated_at` to the response with the `200` status
- **2026-10-13** (v2) `9905dfce1d1e`: 17 breaking, 11 warning, 1 info
  - added `#/components/schemas/CardDefinitionUpdateRequest` to the request body `allOf` list
  - removed the required property `balance_settings` from the response with the `200` status
  - removed the required property `code_config` from the response with the `200` status
  - removed the required property `created_at` from the response with the `200` status
  - removed the required property `earning_limits` from the response with the `200` status
  - removed the required property `id` from the response with the `200` status
  - removed the required property `metadata` from the response with the `200` status
  - removed the required property `name` from the response with the `200` status
  - removed the required property `object` from the response with the `200` status
  - removed the required property `pay_with_points` from the response with the `200` status
  - removed the required property `pending_points` from the response with the `200` status
  - removed the required property `points_expiration` from the response with the `200` status
  - removed the required property `refunds` from the response with the `200` status
  - removed the required property `spending_limits` from the response with the `200` status
  - removed the required property `status` from the response with the `200` status
  - removed the required property `type` from the response with the `200` status
  - removed the required property `updated_at` from the response with the `200` status
  - deleted the `path` request parameter `cardDefinitionId`
  - removed the request property `balance_settings`
  - removed the request property `code_config`
  - removed the request property `earning_limits`
  - removed the request property `metadata`
  - removed the request property `name`
  - removed the request property `pay_with_points`
  - removed the request property `pending_points`
  - removed the request property `points_expiration`
  - removed the request property `refunds`
  - removed the request property `spending_limits`
  - added `#/components/schemas/CardDefinition` to the response body `allOf` list for the response status `200`
- **2026-10-13** (v2) `c59a345c733b`: 1 breaking, 1 warning, 27 info
  - added the new path request parameter `cardDefinitionId`
  - removed `#/components/schemas/CardDefinitionUpdateRequest` from the request body `allOf` list
  - added the new optional request property `balance_settings`
  - added the new optional request property `code_config`
  - added the new optional request property `earning_limits`
  - added the new optional request property `metadata`
  - added the new optional request property `name`
  - added the new optional request property `pay_with_points`
  - added the new optional request property `pending_points`
  - added the new optional request property `points_expiration`
  - added the new optional request property `refunds`
  - added the new optional request property `spending_limits`
  - removed `#/components/schemas/CardDefinition` from the response body `allOf` list for the response status `200`
  - added the required property `balance_settings` to the response with the `200` status
  - added the required property `code_config` to the response with the `200` status
  - added the required property `created_at` to the response with the `200` status
  - added the required property `earning_limits` to the response with the `200` status
  - added the required property `id` to the response with the `200` status
  - added the required property `metadata` to the response with the `200` status
  - added the required property `name` to the response with the `200` status
  - added the required property `object` to the response with the `200` status
  - added the required property `pay_with_points` to the response with the `200` status
  - added the required property `pending_points` to the response with the `200` status
  - added the required property `points_expiration` to the response with the `200` status
  - added the required property `refunds` to the response with the `200` status
  - added the required property `spending_limits` to the response with the `200` status
  - added the required property `status` to the response with the `200` status
  - added the required property `type` to the response with the `200` status
  - added the required property `updated_at` to the response with the `200` status
- **2026-10-13** (v2) `4d4d694f1847`: 17 breaking, 11 warning, 1 info
  - added `#/components/schemas/CardDefinitionUpdateRequest` to the request body `allOf` list
  - removed the required property `balance_settings` from the response with the `200` status
  - removed the required property `code_config` from the response with the `200` status
  - removed the required property `created_at` from the response with the `200` status
  - removed the required property `earning_limits` from the response with the `200` status
  - removed the required property `id` from the response with the `200` status
  - removed the required property `metadata` from the response with the `200` status
  - removed the required property `name` from the response with the `200` status
  - removed the required property `object` from the response with the `200` status
  - removed the required property `pay_with_points` from the response with the `200` status
  - removed the required property `pending_points` from the response with the `200` status
  - removed the required property `points_expiration` from the response with the `200` status
  - removed the required property `refunds` from the response with the `200` status
  - removed the required property `spending_limits` from the response with the `200` status
  - removed the required property `status` from the response with the `200` status
  - removed the required property `type` from the response with the `200` status
  - removed the required property `updated_at` from the response with the `200` status
  - deleted the `path` request parameter `cardDefinitionId`
  - removed the request property `balance_settings`
  - removed the request property `code_config`
  - removed the request property `earning_limits`
  - removed the request property `metadata`
  - removed the request property `name`
  - removed the request property `pay_with_points`
  - removed the request property `pending_points`
  - removed the request property `points_expiration`
  - removed the request property `refunds`
  - removed the request property `spending_limits`
  - added `#/components/schemas/CardDefinition` to the response body `allOf` list for the response status `200`
- **2026-10-13** (v2) `84ad572f8dcb`: 1 breaking, 1 warning, 27 info
  - added the new path request parameter `cardDefinitionId`
  - removed `#/components/schemas/CardDefinitionUpdateRequest` from the request body `allOf` list
  - added the new optional request property `balance_settings`
  - added the new optional request property `code_config`
  - added the new optional request property `earning_limits`
  - added the new optional request property `metadata`
  - added the new optional request property `name`
  - added the new optional request property `pay_with_points`
  - added the new optional request property `pending_points`
  - added the new optional request property `points_expiration`
  - added the new optional request property `refunds`
  - added the new optional request property `spending_limits`
  - removed `#/components/schemas/CardDefinition` from the response body `allOf` list for the response status `200`
  - added the required property `balance_settings` to the response with the `200` status
  - added the required property `code_config` to the response with the `200` status
  - added the required property `created_at` to the response with the `200` status
  - added the required property `earning_limits` to the response with the `200` status
  - added the required property `id` to the response with the `200` status
  - added the required property `metadata` to the response with the `200` status
  - added the required property `name` to the response with the `200` status
  - added the required property `object` to the response with the `200` status
  - added the required property `pay_with_points` to the response with the `200` status
  - added the required property `pending_points` to the response with the `200` status
  - added the required property `points_expiration` to the response with the `200` status
  - added the required property `refunds` to the response with the `200` status
  - added the required property `spending_limits` to the response with the `200` status
  - added the required property `status` to the response with the `200` status
  - added the required property `type` to the response with the `200` status
  - added the required property `updated_at` to the response with the `200` status
- **2026-10-13** (v2) `58624588b18c`: 17 breaking, 11 warning, 1 info
  - added `#/components/schemas/CardDefinitionUpdateRequest` to the request body `allOf` list
  - removed the required property `balance_settings` from the response with the `200` status
  - removed the required property `code_config` from the response with the `200` status
  - removed the required property `created_at` from the response with the `200` status
  - removed the required property `earning_limits` from the response with the `200` status
  - removed the required property `id` from the response with the `200` status
  - removed the required property `metadata` from the response with the `200` status
  - removed the required property `name` from the response with the `200` status
  - removed the required property `object` from the response with the `200` status
  - removed the required property `pay_with_points` from the response with the `200` status
  - removed the required property `pending_points` from the response with the `200` status
  - removed the required property `points_expiration` from the response with the `200` status
  - removed the required property `refunds` from the response with the `200` status
  - removed the required property `spending_limits` from the response with the `200` status
  - removed the required property `status` from the response with the `200` status
  - removed the required property `type` from the response with the `200` status
  - removed the required property `updated_at` from the response with the `200` status
  - deleted the `path` request parameter `cardDefinitionId`
  - removed the request property `balance_settings`
  - removed the request property `code_config`
  - removed the request property `earning_limits`
  - removed the request property `metadata`
  - removed the request property `name`
  - removed the request property `pay_with_points`
  - removed the request property `pending_points`
  - removed the request property `points_expiration`
  - removed the request property `refunds`
  - removed the request property `spending_limits`
  - added `#/components/schemas/CardDefinition` to the response body `allOf` list for the response status `200`
- **2026-10-13** (v2) `100ea5942966`: 1 breaking, 1 warning, 27 info
  - added the new path request parameter `cardDefinitionId`
  - removed `#/components/schemas/CardDefinitionUpdateRequest` from the request body `allOf` list
  - added the new optional request property `balance_settings`
  - added the new optional request property `code_config`
  - added the new optional request property `earning_limits`
  - added the new optional request property `metadata`
  - added the new optional request property `name`
  - added the new optional request property `pay_with_points`
  - added the new optional request property `pending_points`
  - added the new optional request property `points_expiration`
  - added the new optional request property `refunds`
  - added the new optional request property `spending_limits`
  - removed `#/components/schemas/CardDefinition` from the response body `allOf` list for the response status `200`
  - added the required property `balance_settings` to the response with the `200` status
  - added the required property `code_config` to the response with the `200` status
  - added the required property `created_at` to the response with the `200` status
  - added the required property `earning_limits` to the response with the `200` status
  - added the required property `id` to the response with the `200` status
  - added the required property `metadata` to the response with the `200` status
  - added the required property `name` to the response with the `200` status
  - added the required property `object` to the response with the `200` status
  - added the required property `pay_with_points` to the response with the `200` status
  - added the required property `pending_points` to the response with the `200` status
  - added the required property `points_expiration` to the response with the `200` status
  - added the required property `refunds` to the response with the `200` status
  - added the required property `spending_limits` to the response with the `200` status
  - added the required property `status` to the response with the `200` status
  - added the required property `type` to the response with the `200` status
  - added the required property `updated_at` to the response with the `200` status
- **2026-10-13** (v2) `ed683aacf90a`: 17 breaking, 11 warning, 1 info
  - added `#/components/schemas/CardDefinitionUpdateRequest` to the request body `allOf` list
  - removed the required property `balance_settings` from the response with the `200` status
  - removed the required property `code_config` from the response with the `200` status
  - removed the required property `created_at` from the response with the `200` status
  - removed the required property `earning_limits` from the response with the `200` status
  - removed the required property `id` from the response with the `200` status
  - removed the required property `metadata` from the response with the `200` status
  - removed the required property `name` from the response with the `200` status
  - removed the required property `object` from the response with the `200` status
  - removed the required property `pay_with_points` from the response with the `200` status
  - removed the required property `pending_points` from the response with the `200` status
  - removed the required property `points_expiration` from the response with the `200` status
  - removed the required property `refunds` from the response with the `200` status
  - removed the required property `spending_limits` from the response with the `200` status
  - removed the required property `status` from the response with the `200` status
  - removed the required property `type` from the response with the `200` status
  - removed the required property `updated_at` from the response with the `200` status
  - deleted the `path` request parameter `cardDefinitionId`
  - removed the request property `balance_settings`
  - removed the request property `code_config`
  - removed the request property `earning_limits`
  - removed the request property `metadata`
  - removed the request property `name`
  - removed the request property `pay_with_points`
  - removed the request property `pending_points`
  - removed the request property `points_expiration`
  - removed the request property `refunds`
  - removed the request property `spending_limits`
  - added `#/components/schemas/CardDefinition` to the response body `allOf` list for the response status `200`
- **2026-10-07** (v2) `338a5e34004e`: 2 info
  - the endpoint scheme security `X-App-Id AND X-App-Token` was added to the API
  - the endpoint scheme security `bearerAuth` was added to the API
- **2026-10-06** (v2) `b50db1d1d5fe`: 1 breaking, 1 info
  - added `#/components/schemas/LoyaltyV2ActivityCardDefinitionPointsExpirationRollingExpirationRounding` to the `points_expiration/rolling_expiration/rounding` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/CardDefinitionPointsExpirationRollingExpirationRounding` from the `points_expiration/rolling_expiration/rounding` response property `oneOf` list for the response status `200`
- **2026-10-01** (v2) `749b6d105462`: 1 breaking, 1 warning
  - added the new path request parameter `cardDefinitionId`
  - deleted the `path` request parameter `id`
- **2026-07-17** (v2) `4cbaee5a82d5`: 8 info
  - added the optional property `resource_id` to the response with the `400` status
  - added the optional property `resource_id` to the response with the `404` status
  - added the optional property `resource_id` to the response with the `409` status
  - added the optional property `resource_id` to the response with the `500` status
  - added the optional property `resource_type` to the response with the `400` status
  - added the optional property `resource_type` to the response with the `404` status
  - added the optional property `resource_type` to the response with the `409` status
  - added the optional property `resource_type` to the response with the `500` status

---

[Operation](https://skmtc.dev/voucherifyio/apis/voucherify-loyalty-v2-api/docs/v2/loyalties/card-definitions/:cardDefinitionId/put.md) - [API](https://skmtc.dev/voucherifyio/apis/voucherify-loyalty-v2-api.md) - [Page](https://skmtc.dev/voucherifyio/apis/voucherify-loyalty-v2-api/changes/v2/loyalties/card-definitions/:cardDefinitionId/put)
