Skip to main content
A tier defines a ranked progression track within a program. Each tier contains ordered levels (e.g., Silver, Gold, Platinum), where participants hold exactly one level at a time. Levels can advance automatically when counter thresholds are met, be set explicitly through SET_TIER rule actions, or be managed directly via the API. The optional lifecycle configuration controls how tiers behave over time: retention mode, qualification periods, downgrade policies, and counter rollover. Without a lifecycle, tiers operate in rules-only mode where all changes come from rules or API calls.

​
Endpoints

  • Create a tier with levels, qualification criteria, and lifecycle config
  • List and get tier definitions within a program
  • Update a tier’s display name, lifecycle, and levels
  • Get and set a participant’s current tier level
  • Remove a participant’s tier assignment
For usage patterns and examples, see the Tiers guide.