Skip to main content
PUT
/
v2
/
loyalties
/
tier-structures
/
{tierStructureId}
/
tiers
/
{tierId}
Error
A valid request URL is required to generate request examples
{
  "id": "<string>",
  "tier_structure_id": "<string>",
  "name": "<string>",
  "downgrade": {},
  "metadata": {},
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "object": "<string>",
  "qualification_rules": {
    "points": {
      "min_value": 123,
      "max_value": 123
    },
    "segment": {
      "id": "<string>"
    }
  }
}
{
"code": 123,
"key": "<string>",
"message": "<string>",
"details": "<string>",
"request_id": "<string>"
}
{
"code": 123,
"key": "<string>",
"message": "<string>",
"details": "<string>",
"request_id": "<string>"
}
{
"code": 123,
"key": "<string>",
"message": "<string>",
"details": "<string>",
"request_id": "<string>"
}
{
"code": 123,
"key": "<string>",
"message": "<string>",
"details": "<string>",
"request_id": "<string>"
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

X-App-Id
string
header
required
X-App-Token
string
header
required

Path Parameters

id
string
required

Unique tier structure identifier.

Pattern: ^lts_[a-f0-9]+$
tierId
string
required

Unique tier identifier.

Pattern: ^lt_[a-f0-9]+$

Body

application/json

Request body for updating a tier. All properties are optional; no additional properties are allowed. When the parent tier structure is not in DRAFT status, only name and metadata may be updated.

name
string

Display name of the tier.

Required string length: 1 - 200
qualification_rules
object | null

Rules determining which members qualify for this tier.

downgrade
object | null

Tier-level downgrade behavior.

metadata
object | null

Free-form key/value object holding custom attributes.

Response

The updated tier.

Tier resource.

id
string
required

Unique tier identifier.

Pattern: ^lt_[a-f0-9]+$
tier_structure_id
string
required

Identifier of the parent tier structure.

Pattern: ^lts_[a-f0-9]+$
name
string
required

Display name of the tier.

downgrade
object
required

Tier-level downgrade behavior. Always present; when the tier has no downgrade configured, an empty object (no type) is returned.

metadata
object
required

Free-form key/value object holding custom attributes. Defaults to {}.

created_at
string<date-time>
required

Creation timestamp (ISO 8601).

updated_at
string<date-time> | null
required

Last update timestamp (ISO 8601), or null if never updated.

object
string
required

Object type discriminator. Always tier.

Allowed value: "tier"
qualification_rules
object

Rules determining which members qualify for this tier.

Last modified on July 10, 2026