Agent Loyalty (admin)

Global tier config, excluded agencies, and per-agency tier overrides.

📄️ List agencies excluded from the loyalty program

List agencies excluded from the loyalty program

📄️ Replace the full excluded-agencies set

Send the complete set of agentGroupIds that should be excluded. Ids omitted are un-excluded; new ids are excluded; ids unchanged keep their original audit fields. Fits a checklist-style admin UI where the whole set is re-selected and saved in one action.

📄️ Exclude an agency from the loyalty program

Exclude an agency from the loyalty program

📄️ List agent groups modified in loyalty (have at least one tier override)

Paginated. Agencies that currently deviate from the global tier ladder via a per-tier override, and which tiers are overridden for each. Excluded agencies are a separate concern — see GET /exclusions for those.

📄️ List the global tier ladder (4 rows: BRONZE/SILVER/GOLD/PLATINUM)

List the global tier ladder (4 rows: BRONZE/SILVER/GOLD/PLATINUM)

📄️ Replace the global tier ladder

All four tiers must be supplied together — thresholds are validated as a set (strictly increasing by rank). code and rank are never changed by this endpoint.

📄️ Get an agency's effective tier ladder and overrides

Effective ladder = global defaults merged with this agency's overrides. The raw override rows show exactly which fields are overridden vs inherited.

📄️ Upsert an agency's override for one tier

A field sent as null reverts that field to the global default for this agency. Rejected if the resulting effective ladder would not have strictly increasing thresholds by rank for this agency.

📄️ Remove an agency's override for one tier, reverting it fully to global

Remove an agency's override for one tier, reverting it fully to global

📄️ Remove an agency's exclusion

Remove an agency's exclusion