Overrides
An override gives one Customer a different value of one feature: a trial of a higher limit, a negotiated exception, a design partner’s allowance. It needs no new plan.
- A time window:
starts_at(included) toexpires_at(excluded). With noexpires_atit lasts until revoked. It can start in the future. - Typed: the value must match the feature’s type, for example
"unlimited"for a number feature. - No overlaps: two overrides of the same feature for the same Customer can’t overlap in time (
409). - Created or revoked, never edited. To change one, revoke it and create another. Both are recorded in the audit log.
Overrides never bypass eligibility
Section titled “Overrides never bypass eligibility”An override replaces the plan’s value only while the Customer’s subscription is eligible. A paused, expired or lapsed subscription grants nothing, override or not.
Seeing it in a result
Section titled “Seeing it in a result”When an override decides the value, the result says so:
{ "feature_key": "max_projects", "granted": true, "value": "unlimited", "source": "override", "reason": "customer_override", "override_id": "a1b2c3d4-…", "valid_until": "2026-12-01T00:00:00Z"}valid_until includes the override’s expiry, and the start of a future override, because the answer changes at those instants with no write.
Trials without a trialing plan
Section titled “Trials without a trialing plan”A common pattern is a time-boxed taste of a higher plan on a Free subscription: overrides with Pro’s values that expire after 14 days. When they expire, the Customer is back on Free values, with nothing to undo.