---
title: "Changes to Delete tier"
method: DELETE
path: "/v2/loyalties/tier-structures/{tierStructureId}/tiers/{tierId}"
---

# Changes to Delete tier

`DELETE /v2/loyalties/tier-structures/{tierStructureId}/tiers/{tierId}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 15 of 211 revisions.

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

## Changes

- **2026-10-14** (v2) `d29b33490051`: 9 breaking, 1 warning, 1 info
  - the `allOf[#/components/schemas/Tier]/` response's property type changed from `object` to no type for status `200`
  - removed the required property `allOf[#/components/schemas/Tier]/created_at` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/Tier]/downgrade` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/Tier]/id` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/Tier]/metadata` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/Tier]/name` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/Tier]/object` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/Tier]/tier_structure_id` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/Tier]/updated_at` from the response with the `200` status
  - removed the optional property `allOf[#/components/schemas/Tier]/qualification_rules` from the response with the `200` status
  - added `#/components/schemas/TierMetadataBase, subschema #2` to the `allOf[#/components/schemas/Tier]/` response property `allOf` list for the response status `200`
- **2026-10-14** (v2) `be14b3318eb3`: 1 breaking, 10 info
  - the `allOf[#/components/schemas/Tier]/` response's property type changed from no type to `object` for status `200`
  - added the optional property `allOf[#/components/schemas/Tier]/qualification_rules` to the response with the `200` status
  - removed `#/components/schemas/TierMetadataBase, subschema #2` from the `allOf[#/components/schemas/Tier]/` response property `allOf` list for the response status `200`
  - added the required property `allOf[#/components/schemas/Tier]/created_at` to the response with the `200` status
  - added the required property `allOf[#/components/schemas/Tier]/downgrade` to the response with the `200` status
  - added the required property `allOf[#/components/schemas/Tier]/id` to the response with the `200` status
  - added the required property `allOf[#/components/schemas/Tier]/metadata` to the response with the `200` status
  - added the required property `allOf[#/components/schemas/Tier]/name` to the response with the `200` status
  - added the required property `allOf[#/components/schemas/Tier]/object` to the response with the `200` status
  - added the required property `allOf[#/components/schemas/Tier]/tier_structure_id` to the response with the `200` status
  - added the required property `allOf[#/components/schemas/Tier]/updated_at` to the response with the `200` status
- **2026-10-14** (v2) `6a418ac8b7b1`: 9 breaking, 1 warning, 1 info
  - the `allOf[#/components/schemas/Tier]/` response's property type changed from `object` to no type for status `200`
  - removed the required property `allOf[#/components/schemas/Tier]/created_at` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/Tier]/downgrade` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/Tier]/id` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/Tier]/metadata` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/Tier]/name` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/Tier]/object` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/Tier]/tier_structure_id` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/Tier]/updated_at` from the response with the `200` status
  - removed the optional property `allOf[#/components/schemas/Tier]/qualification_rules` from the response with the `200` status
  - added `#/components/schemas/TierMetadataBase, subschema #2` to the `allOf[#/components/schemas/Tier]/` response property `allOf` list for the response status `200`
- **2026-10-14** (v2) `ec801ade260d`: 8 breaking, 3 warning, 2 info
  - removed the required property `created_at` from the response with the `200` status
  - removed the required property `downgrade` 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 `tier_structure_id` 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 `tierId`
  - deleted the `path` request parameter `tierStructureId`
  - removed the optional property `qualification_rules` from the response with the `200` status
  - added `#/components/schemas/Tier` to the response body `allOf` list for the response status `200`
  - removed the non-success response with the status `409`
- **2026-10-13** (v2) `f95b50556c93`: 2 breaking, 11 info
  - added the new path request parameter `tierId`
  - added the new path request parameter `tierStructureId`
  - removed `#/components/schemas/Tier` from the response body `allOf` list for the response status `200`
  - added the non-success response with the status `409`
  - added the optional property `qualification_rules` to the response with the `200` status
  - added the required property `created_at` to the response with the `200` status
  - added the required property `downgrade` 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 `tier_structure_id` 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`: 8 breaking, 3 warning, 2 info
  - removed the required property `created_at` from the response with the `200` status
  - removed the required property `downgrade` 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 `tier_structure_id` 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 `tierId`
  - deleted the `path` request parameter `tierStructureId`
  - removed the optional property `qualification_rules` from the response with the `200` status
  - added `#/components/schemas/Tier` to the response body `allOf` list for the response status `200`
  - removed the non-success response with the status `409`
- **2026-10-13** (v2) `c59a345c733b`: 2 breaking, 11 info
  - added the new path request parameter `tierId`
  - added the new path request parameter `tierStructureId`
  - removed `#/components/schemas/Tier` from the response body `allOf` list for the response status `200`
  - added the non-success response with the status `409`
  - added the optional property `qualification_rules` to the response with the `200` status
  - added the required property `created_at` to the response with the `200` status
  - added the required property `downgrade` 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 `tier_structure_id` 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`: 8 breaking, 3 warning, 2 info
  - removed the required property `created_at` from the response with the `200` status
  - removed the required property `downgrade` 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 `tier_structure_id` 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 `tierId`
  - deleted the `path` request parameter `tierStructureId`
  - removed the optional property `qualification_rules` from the response with the `200` status
  - added `#/components/schemas/Tier` to the response body `allOf` list for the response status `200`
  - removed the non-success response with the status `409`
- **2026-10-13** (v2) `84ad572f8dcb`: 2 breaking, 11 info
  - added the new path request parameter `tierId`
  - added the new path request parameter `tierStructureId`
  - removed `#/components/schemas/Tier` from the response body `allOf` list for the response status `200`
  - added the non-success response with the status `409`
  - added the optional property `qualification_rules` to the response with the `200` status
  - added the required property `created_at` to the response with the `200` status
  - added the required property `downgrade` 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 `tier_structure_id` 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`: 8 breaking, 3 warning, 2 info
  - removed the required property `created_at` from the response with the `200` status
  - removed the required property `downgrade` 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 `tier_structure_id` 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 `tierId`
  - deleted the `path` request parameter `tierStructureId`
  - removed the optional property `qualification_rules` from the response with the `200` status
  - added `#/components/schemas/Tier` to the response body `allOf` list for the response status `200`
  - removed the non-success response with the status `409`
- **2026-10-13** (v2) `100ea5942966`: 2 breaking, 11 info
  - added the new path request parameter `tierId`
  - added the new path request parameter `tierStructureId`
  - removed `#/components/schemas/Tier` from the response body `allOf` list for the response status `200`
  - added the non-success response with the status `409`
  - added the optional property `qualification_rules` to the response with the `200` status
  - added the required property `created_at` to the response with the `200` status
  - added the required property `downgrade` 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 `tier_structure_id` 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`: 8 breaking, 3 warning, 2 info
  - removed the required property `created_at` from the response with the `200` status
  - removed the required property `downgrade` 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 `tier_structure_id` 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 `tierId`
  - deleted the `path` request parameter `tierStructureId`
  - removed the optional property `qualification_rules` from the response with the `200` status
  - added `#/components/schemas/Tier` to the response body `allOf` list for the response status `200`
  - removed the non-success response with the status `409`
- **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-01** (v2) `749b6d105462`: 1 breaking, 1 warning
  - added the new path request parameter `tierStructureId`
  - 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/tier-structures/:tierStructureId/tiers/:tierId/delete.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/tier-structures/:tierStructureId/tiers/:tierId/delete)
