Skip to main content

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.

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
For usage patterns and examples, see the Tiers guide.