---
title: "Replace Tier"
method: PUT
path: "/tier/{id}"
tags: ["Tiers"]
deprecated: true
---

# Replace Tier

`PUT /tier/{id}`

> **Deprecated.**

This endpoint is deprecated - See /tiers/{id} This method allows the calling application to update a Loyalty Tier.

## Path parameters

- `id` string, Int64, required

## Headers

- `X-EES-AUTH-CLIENT-ID` string, string, required
- `X-EES-AUTH-HASH` string, string, required
- `Accept-Encoding` '' | 'gzip' | 'deflate' | 'gzip,deflate'
- `X-EES-TRANSACTION-ID` string, string
- `X-EES-RETRY` string, string

## Request body

- TierPutRequestEntity
  - `type` Type, required — unresolved $ref
  - `status` Status, required — unresolved $ref
  - `details` Details, required — unresolved $ref
  - `settings` TierSettings
    - `schemeOverrides` TierSchemeOverrides
      - `earnRates` object, nullable — Points spend rates for the Tier. The property keys of this object are the unit safe name for the default/parent unit and the incoming identifiers for any child units.
      - `expiryPoints` object
        - `enabled` boolean
        - `rule` object
          - `type` 'NEVEREXPIRE', required
    - `promotion` object
      - `promotionTierId` string, nullable — The ID of the Loyalty Tier the current Tier promotes to.
      - `ruleSets` TierRuleSets[] — The sets of rules which allow promotion to another Loyalty Tier.
        - `rules` TierRule[] — The Rules which must all be satisfied for this Ruleset to qualify for promotion.
          - `amount` integer
          - `balanceType` 'POINTS' | 'SPEND' | 'TRANSACTIONS'
    - `demotion` object
      - `demotionTierId` string, nullable — The ID of the Loyalty Tier the current Tier demotes to.
      - `balanceResetPeriod` TierResetPeriod
        - `periodOffset` object, nullable — The amount of time between Tier periods.
          - `periods` integer, required
          - `periodType` 'DAY' | 'WEEK' | 'MONTH' | 'YEAR', required
        - `roundingRule` 'endOfMonth' | 'endOfQuarter' | 'endOfHalf' | 'endOfYear', nullable — The rounding rule to follow when calculating Tier periods.
      - `membershipExpiryPeriod` TierResetPeriod
        - `periodOffset` object, nullable — The amount of time between Tier periods.
          - `periods` integer, required
          - `periodType` 'DAY' | 'WEEK' | 'MONTH' | 'YEAR', required
        - `roundingRule` 'endOfMonth' | 'endOfQuarter' | 'endOfHalf' | 'endOfYear', nullable — The rounding rule to follow when calculating Tier periods.
      - `reevaluateTierOnBalanceDebit` ReevaluateTierOnBalanceDebit — Configuration for whether a customer's Tier should be re-evaluated following a membership balance debit. If ommitted, this setting will be `enabled=false` by default.
        - `enabled` boolean — If enabled then a customer's Tier will be demoted if a refund takes their membership balance below all of the promotion Rulesets of their current Tier.

## Response `200`

OK.

- TierResponseEntity
  - `id` Id — unresolved $ref
  - `type` Type — unresolved $ref
  - `status` Status — unresolved $ref
  - `reference` Reference — unresolved $ref
  - `details` Details — unresolved $ref
  - `settings` TierSettings
    - `schemeOverrides` TierSchemeOverrides
      - `earnRates` object, nullable — Points spend rates for the Tier. The property keys of this object are the unit safe name for the default/parent unit and the incoming identifiers for any child units.
      - `expiryPoints` object
        - `enabled` boolean
        - `rule` object
          - `type` 'NEVEREXPIRE', required
    - `promotion` object
      - `promotionTierId` string, nullable — The ID of the Loyalty Tier the current Tier promotes to.
      - `ruleSets` TierRuleSets[] — The sets of rules which allow promotion to another Loyalty Tier.
        - `rules` TierRule[] — The Rules which must all be satisfied for this Ruleset to qualify for promotion.
          - `amount` integer
          - `balanceType` 'POINTS' | 'SPEND' | 'TRANSACTIONS'
    - `demotion` object
      - `demotionTierId` string, nullable — The ID of the Loyalty Tier the current Tier demotes to.
      - `balanceResetPeriod` TierResetPeriod
        - `periodOffset` object, nullable — The amount of time between Tier periods.
          - `periods` integer, required
          - `periodType` 'DAY' | 'WEEK' | 'MONTH' | 'YEAR', required
        - `roundingRule` 'endOfMonth' | 'endOfQuarter' | 'endOfHalf' | 'endOfYear', nullable — The rounding rule to follow when calculating Tier periods.
      - `membershipExpiryPeriod` TierResetPeriod
        - `periodOffset` object, nullable — The amount of time between Tier periods.
          - `periods` integer, required
          - `periodType` 'DAY' | 'WEEK' | 'MONTH' | 'YEAR', required
        - `roundingRule` 'endOfMonth' | 'endOfQuarter' | 'endOfHalf' | 'endOfYear', nullable — The rounding rule to follow when calculating Tier periods.
      - `reevaluateTierOnBalanceDebit` ReevaluateTierOnBalanceDebit — Configuration for whether a customer's Tier should be re-evaluated following a membership balance debit. If ommitted, this setting will be `enabled=false` by default.
        - `enabled` boolean — If enabled then a customer's Tier will be demoted if a refund takes their membership balance below all of the promotion Rulesets of their current Tier.
  - `dateCreated` DateCreated — unresolved $ref
  - `lastUpdated` LastUpdated — unresolved $ref

## Other responses

- `400` — Bad Request.
- `401` — Unauthorized.
- `403` — Forbidden.
- `404` — Not Found.
- `405` — Method Not Allowed.
- `429` — Too Many Requests
- `500` — Server Error
- `501` — Not Implemented
- `502` — Bad Gateway
- `503` — Service Unavailable
- `504` — Gateway Timeout

---

[API](https://skmtc.dev/eagleeye/apis/wallet-api.md) · [All operations](https://skmtc.dev/eagleeye/apis/wallet-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/eagleeye/wallet-api/revisions/90a122bb14cc/schema)