> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrip.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Tiers

> Ranked progression tracks with qualification, retention, and downgrade policies

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

<Note>
  For usage patterns and examples, see the [Tiers guide](/guides/tiers).
</Note>