- You need to verify which brand the key resolved to before acting (e.g. an autonomous agent’s preflight check).
- get_brand_context returned something unexpected (wrong planTier, wrong workspace) and you want the authoritative id/slug.
activeBrandId echoes the brand resolved by the auth context; an empty brands array means the key owner’s membership on that brand has lapsed. planTier is the internal plan key; show the user planName (e.g. “Optimize”) instead. planName is null for a workspace billed through a service provider, which is not shown a plan name.
Takes no arguments — resolved entirely from the auth context.