Tiers

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.

​

Tier definition 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
• Archive a tier to end its lifecycle and stop new assignment

​

Participant tier endpoints

• List a participant’s current tier levels for a program
• Get a participant’s level for a single tier
• Set a participant’s tier level directly, with optional expiration
• Remove a participant’s tier assignment