Fired when a customer’s plans change — activated, scheduled, updated, or expired. Each event carries a plan_changes array describing what happened and a tags array (e.g. trial_ended, phase_changed) describing why.
The lifecycle action applied to this plan: activated (newly active on the customer), scheduled (queued for a future start), updated (mutated in place), expired (ended), or paused (set aside until a revert trial ends).
object
The subscription as it stands after this change. Present when the plan is billed as a recurring subscription.
Show properties
string
required
The ID of the customer plan.
'active' | 'scheduled' | 'expired'
required
The current status of the subscription on the customer.
boolean
required
Whether the subscription has overdue payments.
number | null
required
When the subscription started, in milliseconds since the Unix epoch.
number | null
required
When the subscription was canceled, in milliseconds since the Unix epoch, or null if not canceled.
number | null
required
When the subscription ends, in milliseconds since the Unix epoch, or null if no expiry is set.
number | null
required
When the trial ends, in milliseconds since the Unix epoch. Null when not actively trialing.
number | null
required
Start of the current billing period, or null if not applicable.
number | null
required
End of the current billing period, or null if not applicable.
object
The purchase as it stands after this change. Present when the plan is a one-off purchase.
Show properties
string
required
The ID of the customer plan.
'active' | 'scheduled' | 'expired'
required
The current status of the purchase on the customer.
number | null
required
When the purchase ends, in milliseconds since the Unix epoch, or null if no expiry is set.
object | null
required
Sparse map of lifecycle scalar fields whose values changed, holding their previous values. Null when the plan is newly activated or scheduled, or when no lifecycle field changed.
Show properties
'active' | 'scheduled' | 'expired'
The current status of the subscription on the customer.
boolean
Whether the subscription has overdue payments.
number | null
When the subscription was canceled, in milliseconds since the Unix epoch, or null if not canceled.
number | null
When the subscription ends, in milliseconds since the Unix epoch, or null if no expiry is set.
number | null
When the trial ends, in milliseconds since the Unix epoch. Null when not actively trialing.
object
Content-level change to the plan definition for this customer plan (items, base price, free trial).
Show properties
object
The plan after the change. Omitted unless the caller expands it.
Show properties
string
required
Unique identifier for the plan.
string
required
Display name of the plan.
string | null
required
Optional description of the plan.
string | null
required
Group identifier for organizing related plans. Plans in the same group are mutually exclusive.
number
required
Version number of the plan. Incremented when plan configuration changes.
string | null
User-facing version identity. Defaults to v{n} when the version is minted.
boolean
Whether this is the active version of the plan. At most one version is active.
boolean
required
Whether this is an add-on plan that can be attached alongside a main plan.
boolean
required
If true, this plan is automatically attached when a customer is created. Used for free plans.
object | null
required
Base recurring price for the plan. Null for free plans or usage-only plans.
Show properties
number
required
Base price amount for the plan, in major currency units (e.g. dollars).
object[]
Base price amounts in additional currencies. The base ‘amount’ is in the org’s default currency.
The interval at which the feature balance resets (e.g. ‘month’, ‘year’). For consumable features, usage resets to 0 and included units are restored.
number
Number of intervals between resets. Defaults to 1.
object | null
required
Pricing configuration for usage beyond included units. Null if feature is entirely free.
Show properties
number
Price per billing_units after included usage is consumed. Mutually exclusive with tiers.
object[]
Amounts in additional currencies for this flat price. The base ‘amount’ is in the org’s default currency. Only valid with ‘amount’, not ‘tiers’ (tiered prices carry per-currency amounts on each tier).
Flat amount for this tier in this currency, if the tier uses one.
'graduated' | 'volume'
How tiers price usage. ‘graduated’ (default) charges each unit at the rate of the tier it falls in. ‘volume’ picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier’s rate plus its flat_amount.
Billing interval for this price. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.
number
Number of intervals per billing cycle. Defaults to 1.
number
required
Number of units per price increment. Usage is rounded UP to the nearest billing_units when billed (e.g. billing_units=100 means 101 usage rounds to 200).
'prepaid' | 'usage_based'
required
‘prepaid’ for features like seats where customers pay upfront, ‘usage_based’ for pay-as-you-go after included usage.
number | null
required
Maximum units a customer can purchase beyond included. E.g. if included=100 and max_purchase=300, customer can use up to 400 total before usage is capped. Null for no limit.
object
Payment processors this item price is connected to. Omitted when unset.
Show properties
object | null
Show properties
string
required
Stripe price ID. For prepaid with included > 0 this is the V2 price.
object
Display text for showing this item in pricing pages.
Show properties
string
required
Main display text (e.g. ‘$10’ or ‘100 messages’).
string
Secondary display text (e.g. ‘per month’ or ‘then $0.5 per 100’).
object
Rollover configuration for unused units. If set, unused included units roll over to the next period.
Show properties
number | null
required
Maximum rollover units. Null for unlimited rollover.
number | null
Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.
'month' | 'forever'
required
When rolled over units expire.
number
Number of periods before expiry.
object | null
Purchased units expire this long after each purchase. One-off prepaid consumable items only.
Show properties
'day' | 'week' | 'month' | 'year'
required
number
required
object
Overrides fields of this item’s feature for customers on this plan (e.g. a credit system’s credit_schema).
Show properties
object | object | object[]
For credit system features: merges into the feature’s credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with excluded: true removes it, and unlisted features keep the credit system’s rate.
Show properties
string
ID of the metered feature that draws from this credit system.
number
Number of metered-feature units priced together. Defaults to one when omitted.
object
Named rates chosen by event properties. The most specific match sets the rate; with no match the item’s own rate applies.
Show properties
string
required
Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
integer
Breaks ties between dimensions that match the same number of keys. Higher wins.
string
required
object[]
required
Show properties
number
required
Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.
number
required
Credits consumed per billing-unit group within this tier.
object
Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.
Show properties
string
required
Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
number
Multiplies the matched rate. All matching multipliers stack.
number
Added to the rate after every factor is applied, in credits per billing-unit group.
string
object[]
Show properties
number
required
Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.
number
required
Credits consumed per billing-unit group within this tier.
number
Credits consumed per billing-unit group.
true
Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
object
For AI credit system features: replaces the feature’s markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature’s.
Show properties
number
Default percentage markup for customers on this plan. Use -100 to make usage free.
object | null
Per-provider markup percentages for customers on this plan.
Show properties
number
required
object | null
Per-model markup overrides for customers on this plan.
Show properties
number
number
number
object
Payment processors this plan is connected to. Omitted when unset.
Show properties
object | null
Show properties
string
required
Stripe product ID this plan is billed under.
string[]
Extra Stripe product IDs aliased to this plan.
object | null
Show properties
object[]
required
Every RevenueCat product that maps to this plan. Replaces the current set.
Show properties
string
required
RevenueCat product ID that grants this plan when purchased.
object[]
Prepaid quantities granted when this specific RevenueCat product is purchased, in feature units.
Show properties
string
required
number
object
Free trial configuration. If set, new customers can try this plan before being charged.
Show properties
number
required
Number of duration_type periods the trial lasts.
'day' | 'month' | 'year'
required
Unit of time for the trial duration (‘day’, ‘month’, ‘year’).
boolean
required
Whether a payment method is required to start the trial. If true, customer will be charged after trial ends.
'bill' | 'revert'
Behavior when the trial ends. ‘bill’ charges the customer (default). ‘revert’ expires the trial and restores the customer’s previous plan.
number
required
Unix timestamp (ms) when the plan was created.
'sandbox' | 'live'
required
Environment this plan belongs to (‘sandbox’ or ‘live’).
boolean
required
Whether the plan is archived. Archived plans cannot be attached to new customers.
object
required
Miscellaneous plan-level configuration flags.
Show properties
boolean
required
If true, entitlements attached to this plan will still reset on schedule even when the customer’s product is in a past_due state.
boolean
object
Plan-level billing controls used as customer defaults.
Show properties
object[]
List of auto top-up configurations per feature.
Show properties
string
required
The ID of the feature (credit balance) to auto top-up.
boolean
required
Whether auto top-up is enabled.
number
required
When the balance drops below this threshold, an auto top-up will be purchased.
number
required
Amount of credits to add per auto top-up.
object
Optional limit on auto top-ups per window, by number of top-ups or amount charged.
Show properties
'count' | 'amount'
What limit caps: the number of auto top-ups (count, default) or the total amount charged for them, in the customer’s currency (amount).
'hour' | 'day' | 'week' | 'month'
required
The time interval for the purchase limit window.
number
required
Number of intervals in the purchase limit window.
number
required
Maximum allowed within the interval: a number of auto top-ups when limit_type is count, or a total charge (e.g. 500 for $500, pre-tax) when limit_type is amount.
boolean
When true, auto top-up creates a send_invoice invoice instead of auto-charging.
object[]
List of overage spend limits per feature (caps overage spend).
Show properties
string
Optional feature ID this spend limit applies to.
boolean
required
Whether the overage spend limit is enabled.
'absolute' | 'usage_percentage'
How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
number
Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
boolean
When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.
object[]
List of hard usage caps per feature (max units per interval).
Show properties
string
required
The feature this usage limit applies to.
boolean
required
Whether this usage limit is enabled.
number
required
Maximum units allowed per interval.
'day' | 'week' | 'month' | 'year'
required
Interval for the cap, aligned to the customer’s billing cycle.
'billing_cycle' | 'utc'
Window alignment. ‘billing_cycle’ phases the interval to the customer’s renewal time; ‘utc’ aligns to the UTC calendar.
object
When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
Show properties
string
required
object[]
List of usage alert configurations per feature.
Show properties
string
The feature ID this alert applies to.
boolean
required
Whether this usage alert is enabled.
number
required
The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage. remaining and remaining_percentage accept negative values with basis balance, to alert once the balance is overdrawn.
What 100% means. balance: every grant on the feature. included: the plan allowance only. recurring: grants that reset. usage_limit: the cap of the usage limit with the same feature and filter.
object
Only valid with basis usage_limit. Points the alert at the usage limit carrying the same filter.
Show properties
string
required
string
Optional user-defined label to distinguish multiple alerts on the same feature.
object[]
List of overage allowed controls per feature. When enabled, usage can exceed balance.
Show properties
string
required
The feature ID this overage allowed control applies to.
boolean
required
Whether overage is allowed for this feature.
object
required
Arbitrary key-value metadata defined by you for your own use. Shared across all versions of the plan.
object
Show properties
boolean
Whether the trial on this plan is available to this customer. For example, if the customer used the trial in the past, this will be false.
'active' | 'scheduled'
The customer’s current status with this plan. ‘active’ if attached, ‘scheduled’ if pending activation.
boolean
Whether the customer’s active instance of this plan is set to cancel.
boolean
Whether the customer is currently on a free trial of this plan.
Flat amount for this tier in this currency, if the tier uses one.
'graduated' | 'volume'
How tiers price usage. ‘graduated’ (default) charges each unit at the rate of the tier it falls in. ‘volume’ picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier’s rate plus its flat_amount.
Billing interval. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.
number
Number of intervals per billing cycle. Defaults to 1.
number
Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).
'prepaid' | 'usage_based'
required
‘prepaid’ for upfront payment (seats), ‘usage_based’ for pay-as-you-go.
number | null
Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.
object
Proration settings for prepaid features. Controls mid-cycle quantity change billing.
Credit behavior when quantity decreases mid-cycle.
object
Rollover config for unused units. If set, unused included units carry over.
Show properties
number
Max rollover units. Omit for unlimited rollover.
number
Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.
'month' | 'forever'
required
When rolled over units expire.
number
Number of periods before expiry.
object
Purchased units expire this long after each purchase. One-off prepaid consumable items only.
Show properties
'day' | 'week' | 'month' | 'year'
required
number
required
object
Overrides fields of this item’s feature for customers on this plan (e.g. a credit system’s credit_schema).
Show properties
object | object | object[]
For credit system features: merges into the feature’s credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with excluded: true removes it, and unlisted features keep the credit system’s rate.
Show properties
string
ID of the metered feature that draws from this credit system.
number
Number of metered-feature units priced together. Defaults to one when omitted.
object
Named rates chosen by event properties. The most specific match sets the rate; with no match the item’s own rate applies.
Show properties
string
required
Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
integer
Breaks ties between dimensions that match the same number of keys. Higher wins.
string
required
object[]
required
Show properties
number
required
Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.
number
required
Credits consumed per billing-unit group within this tier.
object
Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.
Show properties
string
required
Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
number
Multiplies the matched rate. All matching multipliers stack.
number
Added to the rate after every factor is applied, in credits per billing-unit group.
string
object[]
Show properties
number
required
Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.
number
required
Credits consumed per billing-unit group within this tier.
number
Credits consumed per billing-unit group.
true
Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
object
For AI credit system features: replaces the feature’s markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature’s.
Show properties
number
Default percentage markup for customers on this plan. Use -100 to make usage free.
object | null
Per-provider markup percentages for customers on this plan.
Show properties
number
required
object | null
Per-model markup overrides for customers on this plan.
Show properties
number
number
number
object[]
Filters selecting items to remove from the plan.
Show properties
string
Match items linked to this feature.
'prepaid' | 'usage_based'
Match items with this billing method (prepaid or usage_based).
Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.
integer
Match items with this interval_count. Disambiguates between items that share an interval but differ in count.
number
Match items whose grant equals this included usage. Omitted is a wildcard.
object | null
Free trial configuration for a plan.
Show properties
number
required
Number of duration_type periods the trial lasts.
'day' | 'month' | 'year'
required
Unit of time for the trial (‘day’, ‘month’, ‘year’).
boolean
required
If true, a payment method is required to start the trial and the customer is charged when it ends. Defaults to false.
'bill' | 'revert'
object
Override the plan’s billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
Show properties
object[]
Show properties
string
required
The ID of the feature (credit balance) to auto top-up.
boolean
required
Whether auto top-up is enabled.
number
required
When the balance drops below this threshold, an auto top-up will be purchased.
number
required
Amount of credits to add per auto top-up.
object
Optional rate limit to cap how often auto top-ups occur. Pass count or amount to set the current window’s consumed top-ups or charged amount.
Show properties
'count' | 'amount'
What limit caps: the number of auto top-ups (count, default) or the total amount charged for them, in the customer’s currency (amount).
'hour' | 'day' | 'week' | 'month'
required
The time interval for the purchase limit window.
number
required
Number of intervals in the purchase limit window.
number
required
Maximum allowed within the interval: a number of auto top-ups when limit_type is count, or a total charge (e.g. 500 for $500, pre-tax) when limit_type is amount.
number
Set the current window’s consumed auto top-up count. Omit to leave runtime state unchanged.
number
Set the amount already charged by auto top-ups in the current window. Omit to leave runtime state unchanged.
boolean
When true, auto top-up creates a send_invoice invoice instead of auto-charging.
object[]
Show properties
string
Optional feature ID this spend limit applies to.
boolean
required
Whether the overage spend limit is enabled.
'absolute' | 'usage_percentage'
How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
number
Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
boolean
When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.
object[]
Show properties
string
required
The feature this usage limit applies to.
boolean
required
Whether this usage limit is enabled.
number
required
Maximum units allowed per interval.
'day' | 'week' | 'month' | 'year'
required
Interval for the cap, aligned to the customer’s billing cycle.
'billing_cycle' | 'utc'
Window alignment. ‘billing_cycle’ phases the interval to the customer’s renewal time; ‘utc’ aligns to the UTC calendar.
object
When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
Show properties
string
required
object[]
Show properties
string
The feature ID this alert applies to.
boolean
required
Whether this usage alert is enabled.
number
required
The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage. remaining and remaining_percentage accept negative values with basis balance, to alert once the balance is overdrawn.
What 100% means. balance: every grant on the feature. included: the plan allowance only. recurring: grants that reset. usage_limit: the cap of the usage limit with the same feature and filter.
object
Only valid with basis usage_limit. Points the alert at the usage limit carrying the same filter.
Show properties
string
required
string
Optional user-defined label to distinguish multiple alerts on the same feature.
object[]
Show properties
string
required
The feature ID this overage allowed control applies to.
boolean
required
Whether overage is allowed for this feature.
object[]
License links to add or override for this customer, keyed by license_plan_id. Omitted fields inherit the plan catalog link (included defaults to 1 when the license is not in the catalog). A bare entry restores the license to pure catalog inheritance.
Show properties
string
required
string
integer
boolean
object | null
Show properties
object | null
Base price configuration for a plan.
Show properties
number
required
Base price amount for the plan, in major currency units (e.g. dollars).
Flat amount for this tier in this currency, if the tier uses one.
'graduated' | 'volume'
How tiers price usage. ‘graduated’ (default) charges each unit at the rate of the tier it falls in. ‘volume’ picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier’s rate plus its flat_amount.
Billing interval. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.
number
Number of intervals per billing cycle. Defaults to 1.
number
Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).
'prepaid' | 'usage_based'
required
‘prepaid’ for upfront payment (seats), ‘usage_based’ for pay-as-you-go.
number | null
Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.
object
Proration settings for prepaid features. Controls mid-cycle quantity change billing.
Credit behavior when quantity decreases mid-cycle.
object
Rollover config for unused units. If set, unused included units carry over.
Show properties
number
Max rollover units. Omit for unlimited rollover.
number
Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.
'month' | 'forever'
required
When rolled over units expire.
number
Number of periods before expiry.
object
Purchased units expire this long after each purchase. One-off prepaid consumable items only.
Show properties
'day' | 'week' | 'month' | 'year'
required
number
required
object
Overrides fields of this item’s feature for customers on this plan (e.g. a credit system’s credit_schema).
Show properties
object | object | object[]
For credit system features: merges into the feature’s credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with excluded: true removes it, and unlisted features keep the credit system’s rate.
Show properties
string
ID of the metered feature that draws from this credit system.
number
Number of metered-feature units priced together. Defaults to one when omitted.
object
Named rates chosen by event properties. The most specific match sets the rate; with no match the item’s own rate applies.
Show properties
string
required
Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
integer
Breaks ties between dimensions that match the same number of keys. Higher wins.
string
required
object[]
required
Show properties
number
required
Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.
number
required
Credits consumed per billing-unit group within this tier.
object
Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.
Show properties
string
required
Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
number
Multiplies the matched rate. All matching multipliers stack.
number
Added to the rate after every factor is applied, in credits per billing-unit group.
string
object[]
Show properties
number
required
Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.
number
required
Credits consumed per billing-unit group within this tier.
number
Credits consumed per billing-unit group.
true
Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
object
For AI credit system features: replaces the feature’s markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature’s.
Show properties
number
Default percentage markup for customers on this plan. Use -100 to make usage free.
object | null
Per-provider markup percentages for customers on this plan.
Show properties
number
required
object | null
Per-model markup overrides for customers on this plan.
Show properties
number
number
number
object[]
Show properties
string
Match items linked to this feature.
'prepaid' | 'usage_based'
Match items with this billing method (prepaid or usage_based).
Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.
integer
Match items with this interval_count. Disambiguates between items that share an interval but differ in count.
number
Match items whose grant equals this included usage. Omitted is a wildcard.
object
object[]
License links to drop, keyed by license_plan_id. Parallel to remove_items.
Show properties
string
required
object | null
required
Sparse map of scalar plan fields that changed, holding their previous values. Null when the plan is new.
Show properties
string | null
Unique identifier for the plan.
string | null
Display name of the plan.
string | null | null
Optional description of the plan.
string | null | null
Group identifier for organizing related plans. Plans in the same group are mutually exclusive.
boolean | null
Whether this is an add-on plan that can be attached alongside a main plan.
boolean | null
If true, this plan is automatically attached when a customer is created. Used for free plans.
object | null
Miscellaneous plan-level configuration flags.
Show properties
boolean
required
If true, entitlements attached to this plan will still reset on schedule even when the customer’s product is in a past_due state.
boolean
boolean | null
Whether this is the active version of the plan. At most one version is active.
boolean | null
Whether the plan is archived. Archived plans cannot be attached to new customers.
object | null
Arbitrary key-value metadata defined by you for your own use. Shared across all versions of the plan.
object | null
Previous payment processors when they changed. Null when the plan had none.
Show properties
object | null
Show properties
string
required
Stripe product ID this plan is billed under.
string[]
Extra Stripe product IDs aliased to this plan.
object | null
Show properties
object[]
required
Every RevenueCat product that maps to this plan. Replaces the current set.
Show properties
string
required
RevenueCat product ID that grants this plan when purchased.
object[]
Prepaid quantities granted when this specific RevenueCat product is purchased, in feature units.
Show properties
string
required
number
string | null
The base plan this variant pointed at before this update re-anchored it. Null when it was standalone.
integer | null
The base row version this variant pointed at before this update. Null when it was standalone.
string | null
The base row version slug this variant pointed at before this update. Null when it was standalone.
object | null
Previous free trial when it changed. Null when the plan had none.
Show properties
number
required
Number of duration_type periods the trial lasts.
'day' | 'month' | 'year'
required
Unit of time for the trial duration (‘day’, ‘month’, ‘year’).
boolean
required
Whether a payment method is required to start the trial. If true, customer will be charged after trial ends.
'bill' | 'revert'
Behavior when the trial ends. ‘bill’ charges the customer (default). ‘revert’ expires the trial and restores the customer’s previous plan.
object | null
Sparse previous billing_controls — only keys that changed. Null when unset; a null lane was unset before.
Show properties
object[] | null
List of auto top-up configurations per feature.
Show properties
string
required
The ID of the feature (credit balance) to auto top-up.
boolean
required
Whether auto top-up is enabled.
number
required
When the balance drops below this threshold, an auto top-up will be purchased.
number
required
Amount of credits to add per auto top-up.
object
Optional limit on auto top-ups per window, by number of top-ups or amount charged.
Show properties
'count' | 'amount'
What limit caps: the number of auto top-ups (count, default) or the total amount charged for them, in the customer’s currency (amount).
'hour' | 'day' | 'week' | 'month'
required
The time interval for the purchase limit window.
number
required
Number of intervals in the purchase limit window.
number
required
Maximum allowed within the interval: a number of auto top-ups when limit_type is count, or a total charge (e.g. 500 for $500, pre-tax) when limit_type is amount.
boolean
When true, auto top-up creates a send_invoice invoice instead of auto-charging.
object[] | null
List of overage spend limits per feature (caps overage spend).
Show properties
string
Optional feature ID this spend limit applies to.
boolean
required
Whether the overage spend limit is enabled.
'absolute' | 'usage_percentage'
How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
number
Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
boolean
When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.
object[] | null
List of hard usage caps per feature (max units per interval).
Show properties
string
required
The feature this usage limit applies to.
boolean
required
Whether this usage limit is enabled.
number
required
Maximum units allowed per interval.
'day' | 'week' | 'month' | 'year'
required
Interval for the cap, aligned to the customer’s billing cycle.
'billing_cycle' | 'utc'
Window alignment. ‘billing_cycle’ phases the interval to the customer’s renewal time; ‘utc’ aligns to the UTC calendar.
object
When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
Show properties
string
required
object[] | null
List of usage alert configurations per feature.
Show properties
string
The feature ID this alert applies to.
boolean
required
Whether this usage alert is enabled.
number
required
The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage. remaining and remaining_percentage accept negative values with basis balance, to alert once the balance is overdrawn.
What 100% means. balance: every grant on the feature. included: the plan allowance only. recurring: grants that reset. usage_limit: the cap of the usage limit with the same feature and filter.
object
Only valid with basis usage_limit. Points the alert at the usage limit carrying the same filter.
Show properties
string
required
string
Optional user-defined label to distinguish multiple alerts on the same feature.
object[] | null
List of overage allowed controls per feature. When enabled, usage can exceed balance.
Show properties
string
required
The feature ID this overage allowed control applies to.
boolean
required
Whether overage is allowed for this feature.
object
Present when the plan’s price changed.
Show properties
object | null | null
required
Base recurring price for the plan. Null for free plans or usage-only plans.
Show properties
number
required
Base price amount for the plan, in major currency units (e.g. dollars).
object[]
Base price amounts in additional currencies. The base ‘amount’ is in the org’s default currency.
The interval at which the feature balance resets (e.g. ‘month’, ‘year’). For consumable features, usage resets to 0 and included units are restored.
number
Number of intervals between resets. Defaults to 1.
object | null
required
Pricing configuration for usage beyond included units. Null if feature is entirely free.
Show properties
number
Price per billing_units after included usage is consumed. Mutually exclusive with tiers.
object[]
Amounts in additional currencies for this flat price. The base ‘amount’ is in the org’s default currency. Only valid with ‘amount’, not ‘tiers’ (tiered prices carry per-currency amounts on each tier).
Flat amount for this tier in this currency, if the tier uses one.
'graduated' | 'volume'
How tiers price usage. ‘graduated’ (default) charges each unit at the rate of the tier it falls in. ‘volume’ picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier’s rate plus its flat_amount.
Billing interval for this price. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.
number
Number of intervals per billing cycle. Defaults to 1.
number
required
Number of units per price increment. Usage is rounded UP to the nearest billing_units when billed (e.g. billing_units=100 means 101 usage rounds to 200).
'prepaid' | 'usage_based'
required
‘prepaid’ for features like seats where customers pay upfront, ‘usage_based’ for pay-as-you-go after included usage.
number | null
required
Maximum units a customer can purchase beyond included. E.g. if included=100 and max_purchase=300, customer can use up to 400 total before usage is capped. Null for no limit.
object
Payment processors this item price is connected to. Omitted when unset.
Show properties
object | null
Show properties
string
required
Stripe price ID. For prepaid with included > 0 this is the V2 price.
object
Display text for showing this item in pricing pages.
Show properties
string
required
Main display text (e.g. ‘$10’ or ‘100 messages’).
string
Secondary display text (e.g. ‘per month’ or ‘then $0.5 per 100’).
object
Rollover configuration for unused units. If set, unused included units roll over to the next period.
Show properties
number | null
required
Maximum rollover units. Null for unlimited rollover.
number | null
Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.
'month' | 'forever'
required
When rolled over units expire.
number
Number of periods before expiry.
object | null
Purchased units expire this long after each purchase. One-off prepaid consumable items only.
Show properties
'day' | 'week' | 'month' | 'year'
required
number
required
object
Overrides fields of this item’s feature for customers on this plan (e.g. a credit system’s credit_schema).
Show properties
object | object | object[]
For credit system features: merges into the feature’s credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with excluded: true removes it, and unlisted features keep the credit system’s rate.
Show properties
string
ID of the metered feature that draws from this credit system.
number
Number of metered-feature units priced together. Defaults to one when omitted.
object
Named rates chosen by event properties. The most specific match sets the rate; with no match the item’s own rate applies.
Show properties
string
required
Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
integer
Breaks ties between dimensions that match the same number of keys. Higher wins.
string
required
object[]
required
Show properties
number
required
Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.
number
required
Credits consumed per billing-unit group within this tier.
object
Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.
Show properties
string
required
Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
number
Multiplies the matched rate. All matching multipliers stack.
number
Added to the rate after every factor is applied, in credits per billing-unit group.
string
object[]
Show properties
number
required
Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.
number
required
Credits consumed per billing-unit group within this tier.
number
Credits consumed per billing-unit group.
true
Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
object
For AI credit system features: replaces the feature’s markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature’s.
Show properties
number
Default percentage markup for customers on this plan. Use -100 to make usage free.
object | null
Per-provider markup percentages for customers on this plan.
Show properties
number
required
object | null
Per-model markup overrides for customers on this plan.
Show properties
number
number
number
object
Params that would transform the previous plan into the current one, including license upserts/removes.
Show properties
object | null
Base price configuration for a plan.
Show properties
number
required
Base price amount for the plan, in major currency units (e.g. dollars).
Flat amount for this tier in this currency, if the tier uses one.
'graduated' | 'volume'
How tiers price usage. ‘graduated’ (default) charges each unit at the rate of the tier it falls in. ‘volume’ picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier’s rate plus its flat_amount.
Billing interval. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.
number
Number of intervals per billing cycle. Defaults to 1.
number
Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).
'prepaid' | 'usage_based'
required
‘prepaid’ for upfront payment (seats), ‘usage_based’ for pay-as-you-go.
number | null
Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.
object
Proration settings for prepaid features. Controls mid-cycle quantity change billing.
Credit behavior when quantity decreases mid-cycle.
object
Rollover config for unused units. If set, unused included units carry over.
Show properties
number
Max rollover units. Omit for unlimited rollover.
number
Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.
'month' | 'forever'
required
When rolled over units expire.
number
Number of periods before expiry.
object
Purchased units expire this long after each purchase. One-off prepaid consumable items only.
Show properties
'day' | 'week' | 'month' | 'year'
required
number
required
object
Overrides fields of this item’s feature for customers on this plan (e.g. a credit system’s credit_schema).
Show properties
object | object | object[]
For credit system features: merges into the feature’s credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with excluded: true removes it, and unlisted features keep the credit system’s rate.
Show properties
string
ID of the metered feature that draws from this credit system.
number
Number of metered-feature units priced together. Defaults to one when omitted.
object
Named rates chosen by event properties. The most specific match sets the rate; with no match the item’s own rate applies.
Show properties
string
required
Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
integer
Breaks ties between dimensions that match the same number of keys. Higher wins.
string
required
object[]
required
Show properties
number
required
Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.
number
required
Credits consumed per billing-unit group within this tier.
object
Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.
Show properties
string
required
Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
number
Multiplies the matched rate. All matching multipliers stack.
number
Added to the rate after every factor is applied, in credits per billing-unit group.
string
object[]
Show properties
number
required
Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.
number
required
Credits consumed per billing-unit group within this tier.
number
Credits consumed per billing-unit group.
true
Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
object
For AI credit system features: replaces the feature’s markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature’s.
Show properties
number
Default percentage markup for customers on this plan. Use -100 to make usage free.
object | null
Per-provider markup percentages for customers on this plan.
Show properties
number
required
object | null
Per-model markup overrides for customers on this plan.
Show properties
number
number
number
object[]
Filters selecting items to remove from the plan.
Show properties
string
Match items linked to this feature.
'prepaid' | 'usage_based'
Match items with this billing method (prepaid or usage_based).
Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.
integer
Match items with this interval_count. Disambiguates between items that share an interval but differ in count.
number
Match items whose grant equals this included usage. Omitted is a wildcard.
object | null
Free trial configuration for a plan.
Show properties
number
required
Number of duration_type periods the trial lasts.
'day' | 'month' | 'year'
required
Unit of time for the trial (‘day’, ‘month’, ‘year’).
boolean
required
If true, a payment method is required to start the trial and the customer is charged when it ends. Defaults to false.
'bill' | 'revert'
object
Override the plan’s billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
Show properties
object[]
Show properties
string
required
The ID of the feature (credit balance) to auto top-up.
boolean
required
Whether auto top-up is enabled.
number
required
When the balance drops below this threshold, an auto top-up will be purchased.
number
required
Amount of credits to add per auto top-up.
object
Optional rate limit to cap how often auto top-ups occur. Pass count or amount to set the current window’s consumed top-ups or charged amount.
Show properties
'count' | 'amount'
What limit caps: the number of auto top-ups (count, default) or the total amount charged for them, in the customer’s currency (amount).
'hour' | 'day' | 'week' | 'month'
required
The time interval for the purchase limit window.
number
required
Number of intervals in the purchase limit window.
number
required
Maximum allowed within the interval: a number of auto top-ups when limit_type is count, or a total charge (e.g. 500 for $500, pre-tax) when limit_type is amount.
number
Set the current window’s consumed auto top-up count. Omit to leave runtime state unchanged.
number
Set the amount already charged by auto top-ups in the current window. Omit to leave runtime state unchanged.
boolean
When true, auto top-up creates a send_invoice invoice instead of auto-charging.
object[]
Show properties
string
Optional feature ID this spend limit applies to.
boolean
required
Whether the overage spend limit is enabled.
'absolute' | 'usage_percentage'
How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
number
Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
boolean
When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.
object[]
Show properties
string
required
The feature this usage limit applies to.
boolean
required
Whether this usage limit is enabled.
number
required
Maximum units allowed per interval.
'day' | 'week' | 'month' | 'year'
required
Interval for the cap, aligned to the customer’s billing cycle.
'billing_cycle' | 'utc'
Window alignment. ‘billing_cycle’ phases the interval to the customer’s renewal time; ‘utc’ aligns to the UTC calendar.
object
When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
Show properties
string
required
object[]
Show properties
string
The feature ID this alert applies to.
boolean
required
Whether this usage alert is enabled.
number
required
The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage. remaining and remaining_percentage accept negative values with basis balance, to alert once the balance is overdrawn.
What 100% means. balance: every grant on the feature. included: the plan allowance only. recurring: grants that reset. usage_limit: the cap of the usage limit with the same feature and filter.
object
Only valid with basis usage_limit. Points the alert at the usage limit carrying the same filter.
Show properties
string
required
string
Optional user-defined label to distinguish multiple alerts on the same feature.
object[]
Show properties
string
required
The feature ID this overage allowed control applies to.
boolean
required
Whether overage is allowed for this feature.
object[]
planLicenses created or overridden. Same shape as customize.upsert_licenses / licenses[] entries.
Show properties
string
required
string
integer
boolean
object | null
Show properties
object | null
Base price configuration for a plan.
Show properties
number
required
Base price amount for the plan, in major currency units (e.g. dollars).
Flat amount for this tier in this currency, if the tier uses one.
'graduated' | 'volume'
How tiers price usage. ‘graduated’ (default) charges each unit at the rate of the tier it falls in. ‘volume’ picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier’s rate plus its flat_amount.
Billing interval. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.
number
Number of intervals per billing cycle. Defaults to 1.
number
Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).
'prepaid' | 'usage_based'
required
‘prepaid’ for upfront payment (seats), ‘usage_based’ for pay-as-you-go.
number | null
Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.
object
Proration settings for prepaid features. Controls mid-cycle quantity change billing.
Credit behavior when quantity decreases mid-cycle.
object
Rollover config for unused units. If set, unused included units carry over.
Show properties
number
Max rollover units. Omit for unlimited rollover.
number
Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.
'month' | 'forever'
required
When rolled over units expire.
number
Number of periods before expiry.
object
Purchased units expire this long after each purchase. One-off prepaid consumable items only.
Show properties
'day' | 'week' | 'month' | 'year'
required
number
required
object
Overrides fields of this item’s feature for customers on this plan (e.g. a credit system’s credit_schema).
Show properties
object | object | object[]
For credit system features: merges into the feature’s credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with excluded: true removes it, and unlisted features keep the credit system’s rate.
Show properties
string
ID of the metered feature that draws from this credit system.
number
Number of metered-feature units priced together. Defaults to one when omitted.
object
Named rates chosen by event properties. The most specific match sets the rate; with no match the item’s own rate applies.
Show properties
string
required
Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
integer
Breaks ties between dimensions that match the same number of keys. Higher wins.
string
required
object[]
required
Show properties
number
required
Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.
number
required
Credits consumed per billing-unit group within this tier.
object
Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.
Show properties
string
required
Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
number
Multiplies the matched rate. All matching multipliers stack.
number
Added to the rate after every factor is applied, in credits per billing-unit group.
string
object[]
Show properties
number
required
Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.
number
required
Credits consumed per billing-unit group within this tier.
number
Credits consumed per billing-unit group.
true
Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
object
For AI credit system features: replaces the feature’s markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature’s.
Show properties
number
Default percentage markup for customers on this plan. Use -100 to make usage free.
object | null
Per-provider markup percentages for customers on this plan.
Show properties
number
required
object | null
Per-model markup overrides for customers on this plan.
Show properties
number
number
number
object[]
Show properties
string
Match items linked to this feature.
'prepaid' | 'usage_based'
Match items with this billing method (prepaid or usage_based).
Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.
integer
Match items with this interval_count. Disambiguates between items that share an interval but differ in count.
number
Match items whose grant equals this included usage. Omitted is a wildcard.
object
object[]
planLicenses dropped from this plan.
Show properties
string
required
object[]
planLicenses created, updated, or removed on this plan. Omitted when none. Nested plan_change is core-only.
Show properties
string
required
The plan offered as a license under this plan.
integer
required
The exact license-plan version pinned by this link.
string
Version slug of the license-plan row this link points at.
number
required
Number of license assignments included with this plan for free.
object
Arbitrary key-value metadata defined by you on this link.
object
The effective plan for this license link — the pinned version, with the link’s customize applied. Present when license plans are expanded.
Show properties
string
required
Unique identifier for the plan.
string
required
Display name of the plan.
string | null
required
Optional description of the plan.
string | null
required
Group identifier for organizing related plans. Plans in the same group are mutually exclusive.
number
required
Version number of the plan. Incremented when plan configuration changes.
string | null
User-facing version identity. Defaults to v{n} when the version is minted.
boolean
Whether this is the active version of the plan. At most one version is active.
boolean
required
Whether this is an add-on plan that can be attached alongside a main plan.
boolean
required
If true, this plan is automatically attached when a customer is created. Used for free plans.
object | null
required
Base recurring price for the plan. Null for free plans or usage-only plans.
Show properties
number
required
Base price amount for the plan, in major currency units (e.g. dollars).
object[]
Base price amounts in additional currencies. The base ‘amount’ is in the org’s default currency.
The interval at which the feature balance resets (e.g. ‘month’, ‘year’). For consumable features, usage resets to 0 and included units are restored.
number
Number of intervals between resets. Defaults to 1.
object | null
required
Pricing configuration for usage beyond included units. Null if feature is entirely free.
Show properties
number
Price per billing_units after included usage is consumed. Mutually exclusive with tiers.
object[]
Amounts in additional currencies for this flat price. The base ‘amount’ is in the org’s default currency. Only valid with ‘amount’, not ‘tiers’ (tiered prices carry per-currency amounts on each tier).
Flat amount for this tier in this currency, if the tier uses one.
'graduated' | 'volume'
How tiers price usage. ‘graduated’ (default) charges each unit at the rate of the tier it falls in. ‘volume’ picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier’s rate plus its flat_amount.
Billing interval for this price. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.
number
Number of intervals per billing cycle. Defaults to 1.
number
required
Number of units per price increment. Usage is rounded UP to the nearest billing_units when billed (e.g. billing_units=100 means 101 usage rounds to 200).
'prepaid' | 'usage_based'
required
‘prepaid’ for features like seats where customers pay upfront, ‘usage_based’ for pay-as-you-go after included usage.
number | null
required
Maximum units a customer can purchase beyond included. E.g. if included=100 and max_purchase=300, customer can use up to 400 total before usage is capped. Null for no limit.
object
Payment processors this item price is connected to. Omitted when unset.
Show properties
object | null
Show properties
string
required
Stripe price ID. For prepaid with included > 0 this is the V2 price.
object
Display text for showing this item in pricing pages.
Show properties
string
required
Main display text (e.g. ‘$10’ or ‘100 messages’).
string
Secondary display text (e.g. ‘per month’ or ‘then $0.5 per 100’).
object
Rollover configuration for unused units. If set, unused included units roll over to the next period.
Show properties
number | null
required
Maximum rollover units. Null for unlimited rollover.
number | null
Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.
'month' | 'forever'
required
When rolled over units expire.
number
Number of periods before expiry.
object | null
Purchased units expire this long after each purchase. One-off prepaid consumable items only.
Show properties
'day' | 'week' | 'month' | 'year'
required
number
required
object
Overrides fields of this item’s feature for customers on this plan (e.g. a credit system’s credit_schema).
Show properties
object | object | object[]
For credit system features: merges into the feature’s credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with excluded: true removes it, and unlisted features keep the credit system’s rate.
Show properties
string
ID of the metered feature that draws from this credit system.
number
Number of metered-feature units priced together. Defaults to one when omitted.
object
Named rates chosen by event properties. The most specific match sets the rate; with no match the item’s own rate applies.
Show properties
string
required
Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
integer
Breaks ties between dimensions that match the same number of keys. Higher wins.
string
required
object[]
required
Show properties
number
required
Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.
number
required
Credits consumed per billing-unit group within this tier.
object
Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.
Show properties
string
required
Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
number
Multiplies the matched rate. All matching multipliers stack.
number
Added to the rate after every factor is applied, in credits per billing-unit group.
string
object[]
Show properties
number
required
Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.
number
required
Credits consumed per billing-unit group within this tier.
number
Credits consumed per billing-unit group.
true
Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
object
For AI credit system features: replaces the feature’s markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature’s.
Show properties
number
Default percentage markup for customers on this plan. Use -100 to make usage free.
object | null
Per-provider markup percentages for customers on this plan.
Show properties
number
required
object | null
Per-model markup overrides for customers on this plan.
Show properties
number
number
number
object
Payment processors this plan is connected to. Omitted when unset.
Show properties
object | null
Show properties
string
required
Stripe product ID this plan is billed under.
string[]
Extra Stripe product IDs aliased to this plan.
object | null
Show properties
object[]
required
Every RevenueCat product that maps to this plan. Replaces the current set.
Show properties
string
required
RevenueCat product ID that grants this plan when purchased.
object[]
Prepaid quantities granted when this specific RevenueCat product is purchased, in feature units.
Show properties
string
required
number
object
Free trial configuration. If set, new customers can try this plan before being charged.
Show properties
number
required
Number of duration_type periods the trial lasts.
'day' | 'month' | 'year'
required
Unit of time for the trial duration (‘day’, ‘month’, ‘year’).
boolean
required
Whether a payment method is required to start the trial. If true, customer will be charged after trial ends.
'bill' | 'revert'
Behavior when the trial ends. ‘bill’ charges the customer (default). ‘revert’ expires the trial and restores the customer’s previous plan.
number
required
Unix timestamp (ms) when the plan was created.
'sandbox' | 'live'
required
Environment this plan belongs to (‘sandbox’ or ‘live’).
boolean
required
Whether the plan is archived. Archived plans cannot be attached to new customers.
object
required
Miscellaneous plan-level configuration flags.
Show properties
boolean
required
If true, entitlements attached to this plan will still reset on schedule even when the customer’s product is in a past_due state.
boolean
object
Plan-level billing controls used as customer defaults.
Show properties
object[]
List of auto top-up configurations per feature.
Show properties
string
required
The ID of the feature (credit balance) to auto top-up.
boolean
required
Whether auto top-up is enabled.
number
required
When the balance drops below this threshold, an auto top-up will be purchased.
number
required
Amount of credits to add per auto top-up.
object
Optional limit on auto top-ups per window, by number of top-ups or amount charged.
Show properties
'count' | 'amount'
What limit caps: the number of auto top-ups (count, default) or the total amount charged for them, in the customer’s currency (amount).
'hour' | 'day' | 'week' | 'month'
required
The time interval for the purchase limit window.
number
required
Number of intervals in the purchase limit window.
number
required
Maximum allowed within the interval: a number of auto top-ups when limit_type is count, or a total charge (e.g. 500 for $500, pre-tax) when limit_type is amount.
boolean
When true, auto top-up creates a send_invoice invoice instead of auto-charging.
object[]
List of overage spend limits per feature (caps overage spend).
Show properties
string
Optional feature ID this spend limit applies to.
boolean
required
Whether the overage spend limit is enabled.
'absolute' | 'usage_percentage'
How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
number
Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
boolean
When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.
object[]
List of hard usage caps per feature (max units per interval).
Show properties
string
required
The feature this usage limit applies to.
boolean
required
Whether this usage limit is enabled.
number
required
Maximum units allowed per interval.
'day' | 'week' | 'month' | 'year'
required
Interval for the cap, aligned to the customer’s billing cycle.
'billing_cycle' | 'utc'
Window alignment. ‘billing_cycle’ phases the interval to the customer’s renewal time; ‘utc’ aligns to the UTC calendar.
object
When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
Show properties
string
required
object[]
List of usage alert configurations per feature.
Show properties
string
The feature ID this alert applies to.
boolean
required
Whether this usage alert is enabled.
number
required
The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage. remaining and remaining_percentage accept negative values with basis balance, to alert once the balance is overdrawn.
What 100% means. balance: every grant on the feature. included: the plan allowance only. recurring: grants that reset. usage_limit: the cap of the usage limit with the same feature and filter.
object
Only valid with basis usage_limit. Points the alert at the usage limit carrying the same filter.
Show properties
string
required
string
Optional user-defined label to distinguish multiple alerts on the same feature.
object[]
List of overage allowed controls per feature. When enabled, usage can exceed balance.
Show properties
string
required
The feature ID this overage allowed control applies to.
boolean
required
Whether overage is allowed for this feature.
object
required
Arbitrary key-value metadata defined by you for your own use. Shared across all versions of the plan.
object
Show properties
boolean
Whether the trial on this plan is available to this customer. For example, if the customer used the trial in the past, this will be false.
'active' | 'scheduled'
The customer’s current status with this plan. ‘active’ if attached, ‘scheduled’ if pending activation.
boolean
Whether the customer’s active instance of this plan is set to cancel.
boolean
Whether the customer is currently on a free trial of this plan.
Flat amount for this tier in this currency, if the tier uses one.
'graduated' | 'volume'
How tiers price usage. ‘graduated’ (default) charges each unit at the rate of the tier it falls in. ‘volume’ picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier’s rate plus its flat_amount.
Billing interval. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.
number
Number of intervals per billing cycle. Defaults to 1.
number
Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).
'prepaid' | 'usage_based'
required
‘prepaid’ for upfront payment (seats), ‘usage_based’ for pay-as-you-go.
number | null
Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.
object
Proration settings for prepaid features. Controls mid-cycle quantity change billing.
Credit behavior when quantity decreases mid-cycle.
object
Rollover config for unused units. If set, unused included units carry over.
Show properties
number
Max rollover units. Omit for unlimited rollover.
number
Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.
'month' | 'forever'
required
When rolled over units expire.
number
Number of periods before expiry.
object
Purchased units expire this long after each purchase. One-off prepaid consumable items only.
Show properties
'day' | 'week' | 'month' | 'year'
required
number
required
object
Overrides fields of this item’s feature for customers on this plan (e.g. a credit system’s credit_schema).
Show properties
object | object | object[]
For credit system features: merges into the feature’s credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with excluded: true removes it, and unlisted features keep the credit system’s rate.
Show properties
string
ID of the metered feature that draws from this credit system.
number
Number of metered-feature units priced together. Defaults to one when omitted.
object
Named rates chosen by event properties. The most specific match sets the rate; with no match the item’s own rate applies.
Show properties
string
required
Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
integer
Breaks ties between dimensions that match the same number of keys. Higher wins.
string
required
object[]
required
Show properties
number
required
Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.
number
required
Credits consumed per billing-unit group within this tier.
object
Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.
Show properties
string
required
Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
number
Multiplies the matched rate. All matching multipliers stack.
number
Added to the rate after every factor is applied, in credits per billing-unit group.
string
object[]
Show properties
number
required
Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.
number
required
Credits consumed per billing-unit group within this tier.
number
Credits consumed per billing-unit group.
true
Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
object
For AI credit system features: replaces the feature’s markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature’s.
Show properties
number
Default percentage markup for customers on this plan. Use -100 to make usage free.
object | null
Per-provider markup percentages for customers on this plan.
Show properties
number
required
object | null
Per-model markup overrides for customers on this plan.
Show properties
number
number
number
object[]
Filters selecting items to remove from the plan.
Show properties
string
Match items linked to this feature.
'prepaid' | 'usage_based'
Match items with this billing method (prepaid or usage_based).
Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.
integer
Match items with this interval_count. Disambiguates between items that share an interval but differ in count.
number
Match items whose grant equals this included usage. Omitted is a wildcard.
object | null
Free trial configuration for a plan.
Show properties
number
required
Number of duration_type periods the trial lasts.
'day' | 'month' | 'year'
required
Unit of time for the trial (‘day’, ‘month’, ‘year’).
boolean
required
If true, a payment method is required to start the trial and the customer is charged when it ends. Defaults to false.
'bill' | 'revert'
object
Override the plan’s billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
Show properties
object[]
Show properties
string
required
The ID of the feature (credit balance) to auto top-up.
boolean
required
Whether auto top-up is enabled.
number
required
When the balance drops below this threshold, an auto top-up will be purchased.
number
required
Amount of credits to add per auto top-up.
object
Optional rate limit to cap how often auto top-ups occur. Pass count or amount to set the current window’s consumed top-ups or charged amount.
Show properties
'count' | 'amount'
What limit caps: the number of auto top-ups (count, default) or the total amount charged for them, in the customer’s currency (amount).
'hour' | 'day' | 'week' | 'month'
required
The time interval for the purchase limit window.
number
required
Number of intervals in the purchase limit window.
number
required
Maximum allowed within the interval: a number of auto top-ups when limit_type is count, or a total charge (e.g. 500 for $500, pre-tax) when limit_type is amount.
number
Set the current window’s consumed auto top-up count. Omit to leave runtime state unchanged.
number
Set the amount already charged by auto top-ups in the current window. Omit to leave runtime state unchanged.
boolean
When true, auto top-up creates a send_invoice invoice instead of auto-charging.
object[]
Show properties
string
Optional feature ID this spend limit applies to.
boolean
required
Whether the overage spend limit is enabled.
'absolute' | 'usage_percentage'
How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
number
Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
boolean
When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.
object[]
Show properties
string
required
The feature this usage limit applies to.
boolean
required
Whether this usage limit is enabled.
number
required
Maximum units allowed per interval.
'day' | 'week' | 'month' | 'year'
required
Interval for the cap, aligned to the customer’s billing cycle.
'billing_cycle' | 'utc'
Window alignment. ‘billing_cycle’ phases the interval to the customer’s renewal time; ‘utc’ aligns to the UTC calendar.
object
When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
Show properties
string
required
object[]
Show properties
string
The feature ID this alert applies to.
boolean
required
Whether this usage alert is enabled.
number
required
The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage. remaining and remaining_percentage accept negative values with basis balance, to alert once the balance is overdrawn.
What 100% means. balance: every grant on the feature. included: the plan allowance only. recurring: grants that reset. usage_limit: the cap of the usage limit with the same feature and filter.
object
Only valid with basis usage_limit. Points the alert at the usage limit carrying the same filter.
Show properties
string
required
string
Optional user-defined label to distinguish multiple alerts on the same feature.
object[]
Show properties
string
required
The feature ID this overage allowed control applies to.
boolean
required
Whether overage is allowed for this feature.
object[]
License links to add or override for this customer, keyed by license_plan_id. Omitted fields inherit the plan catalog link (included defaults to 1 when the license is not in the catalog). A bare entry restores the license to pure catalog inheritance.
Show properties
string
required
string
integer
boolean
object | null
Show properties
object | null
Base price configuration for a plan.
Show properties
number
required
Base price amount for the plan, in major currency units (e.g. dollars).
Flat amount for this tier in this currency, if the tier uses one.
'graduated' | 'volume'
How tiers price usage. ‘graduated’ (default) charges each unit at the rate of the tier it falls in. ‘volume’ picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier’s rate plus its flat_amount.
Billing interval. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.
number
Number of intervals per billing cycle. Defaults to 1.
number
Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).
'prepaid' | 'usage_based'
required
‘prepaid’ for upfront payment (seats), ‘usage_based’ for pay-as-you-go.
number | null
Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.
object
Proration settings for prepaid features. Controls mid-cycle quantity change billing.
Credit behavior when quantity decreases mid-cycle.
object
Rollover config for unused units. If set, unused included units carry over.
Show properties
number
Max rollover units. Omit for unlimited rollover.
number
Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.
'month' | 'forever'
required
When rolled over units expire.
number
Number of periods before expiry.
object
Purchased units expire this long after each purchase. One-off prepaid consumable items only.
Show properties
'day' | 'week' | 'month' | 'year'
required
number
required
object
Overrides fields of this item’s feature for customers on this plan (e.g. a credit system’s credit_schema).
Show properties
object | object | object[]
For credit system features: merges into the feature’s credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with excluded: true removes it, and unlisted features keep the credit system’s rate.
Show properties
string
ID of the metered feature that draws from this credit system.
number
Number of metered-feature units priced together. Defaults to one when omitted.
object
Named rates chosen by event properties. The most specific match sets the rate; with no match the item’s own rate applies.
Show properties
string
required
Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
integer
Breaks ties between dimensions that match the same number of keys. Higher wins.
string
required
object[]
required
Show properties
number
required
Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.
number
required
Credits consumed per billing-unit group within this tier.
object
Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.
Show properties
string
required
Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
number
Multiplies the matched rate. All matching multipliers stack.
number
Added to the rate after every factor is applied, in credits per billing-unit group.
string
object[]
Show properties
number
required
Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.
number
required
Credits consumed per billing-unit group within this tier.
number
Credits consumed per billing-unit group.
true
Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
object
For AI credit system features: replaces the feature’s markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature’s.
Show properties
number
Default percentage markup for customers on this plan. Use -100 to make usage free.
object | null
Per-provider markup percentages for customers on this plan.
Show properties
number
required
object | null
Per-model markup overrides for customers on this plan.
Show properties
number
number
number
object[]
Show properties
string
Match items linked to this feature.
'prepaid' | 'usage_based'
Match items with this billing method (prepaid or usage_based).
Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.
integer
Match items with this interval_count. Disambiguates between items that share an interval but differ in count.
number
Match items whose grant equals this included usage. Omitted is a wildcard.
object
object[]
License links to drop, keyed by license_plan_id. Parallel to remove_items.
Show properties
string
required
'created' | 'updated' | 'removed'
required
created = new planLicense; updated = row or effective content changed; removed = dropped.
object | null
required
Previous included / prepaid_only / version. Null when created or removed, or when no row scalar changed.
Show properties
integer
The exact license-plan version pinned by this link.
string
Version slug of the license-plan row this link points at.
number
Number of license assignments included with this plan for free.
object | null
Diff of the license’s effective plan. Null when created, removed, or the effective content is unchanged.
Show properties
object
The plan after the change. Omitted unless the caller expands it.
Show properties
string
required
Unique identifier for the plan.
string
required
Display name of the plan.
string | null
required
Optional description of the plan.
string | null
required
Group identifier for organizing related plans. Plans in the same group are mutually exclusive.
number
required
Version number of the plan. Incremented when plan configuration changes.
string | null
User-facing version identity. Defaults to v{n} when the version is minted.
boolean
Whether this is the active version of the plan. At most one version is active.
boolean
required
Whether this is an add-on plan that can be attached alongside a main plan.
boolean
required
If true, this plan is automatically attached when a customer is created. Used for free plans.
object | null
required
Base recurring price for the plan. Null for free plans or usage-only plans.
Show properties
number
required
Base price amount for the plan, in major currency units (e.g. dollars).
object[]
Base price amounts in additional currencies. The base ‘amount’ is in the org’s default currency.
The interval at which the feature balance resets (e.g. ‘month’, ‘year’). For consumable features, usage resets to 0 and included units are restored.
number
Number of intervals between resets. Defaults to 1.
object | null
required
Pricing configuration for usage beyond included units. Null if feature is entirely free.
Show properties
number
Price per billing_units after included usage is consumed. Mutually exclusive with tiers.
object[]
Amounts in additional currencies for this flat price. The base ‘amount’ is in the org’s default currency. Only valid with ‘amount’, not ‘tiers’ (tiered prices carry per-currency amounts on each tier).
Flat amount for this tier in this currency, if the tier uses one.
'graduated' | 'volume'
How tiers price usage. ‘graduated’ (default) charges each unit at the rate of the tier it falls in. ‘volume’ picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier’s rate plus its flat_amount.
Billing interval for this price. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.
number
Number of intervals per billing cycle. Defaults to 1.
number
required
Number of units per price increment. Usage is rounded UP to the nearest billing_units when billed (e.g. billing_units=100 means 101 usage rounds to 200).
'prepaid' | 'usage_based'
required
‘prepaid’ for features like seats where customers pay upfront, ‘usage_based’ for pay-as-you-go after included usage.
number | null
required
Maximum units a customer can purchase beyond included. E.g. if included=100 and max_purchase=300, customer can use up to 400 total before usage is capped. Null for no limit.
object
Payment processors this item price is connected to. Omitted when unset.
Show properties
object | null
Show properties
string
required
Stripe price ID. For prepaid with included > 0 this is the V2 price.
object
Display text for showing this item in pricing pages.
Show properties
string
required
Main display text (e.g. ‘$10’ or ‘100 messages’).
string
Secondary display text (e.g. ‘per month’ or ‘then $0.5 per 100’).
object
Rollover configuration for unused units. If set, unused included units roll over to the next period.
Show properties
number | null
required
Maximum rollover units. Null for unlimited rollover.
number | null
Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.
'month' | 'forever'
required
When rolled over units expire.
number
Number of periods before expiry.
object | null
Purchased units expire this long after each purchase. One-off prepaid consumable items only.
Show properties
'day' | 'week' | 'month' | 'year'
required
number
required
object
Overrides fields of this item’s feature for customers on this plan (e.g. a credit system’s credit_schema).
Show properties
object | object | object[]
For credit system features: merges into the feature’s credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with excluded: true removes it, and unlisted features keep the credit system’s rate.
Show properties
string
ID of the metered feature that draws from this credit system.
number
Number of metered-feature units priced together. Defaults to one when omitted.
object
Named rates chosen by event properties. The most specific match sets the rate; with no match the item’s own rate applies.
Show properties
string
required
Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
integer
Breaks ties between dimensions that match the same number of keys. Higher wins.
string
required
object[]
required
Show properties
number
required
Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.
number
required
Credits consumed per billing-unit group within this tier.
object
Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.
Show properties
string
required
Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
number
Multiplies the matched rate. All matching multipliers stack.
number
Added to the rate after every factor is applied, in credits per billing-unit group.
string
object[]
Show properties
number
required
Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.
number
required
Credits consumed per billing-unit group within this tier.
number
Credits consumed per billing-unit group.
true
Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
object
For AI credit system features: replaces the feature’s markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature’s.
Show properties
number
Default percentage markup for customers on this plan. Use -100 to make usage free.
object | null
Per-provider markup percentages for customers on this plan.
Show properties
number
required
object | null
Per-model markup overrides for customers on this plan.
Show properties
number
number
number
object
Payment processors this plan is connected to. Omitted when unset.
Show properties
object | null
Show properties
string
required
Stripe product ID this plan is billed under.
string[]
Extra Stripe product IDs aliased to this plan.
object | null
Show properties
object[]
required
Every RevenueCat product that maps to this plan. Replaces the current set.
Show properties
string
required
RevenueCat product ID that grants this plan when purchased.
object[]
Prepaid quantities granted when this specific RevenueCat product is purchased, in feature units.
Show properties
string
required
number
object
Free trial configuration. If set, new customers can try this plan before being charged.
Show properties
number
required
Number of duration_type periods the trial lasts.
'day' | 'month' | 'year'
required
Unit of time for the trial duration (‘day’, ‘month’, ‘year’).
boolean
required
Whether a payment method is required to start the trial. If true, customer will be charged after trial ends.
'bill' | 'revert'
Behavior when the trial ends. ‘bill’ charges the customer (default). ‘revert’ expires the trial and restores the customer’s previous plan.
number
required
Unix timestamp (ms) when the plan was created.
'sandbox' | 'live'
required
Environment this plan belongs to (‘sandbox’ or ‘live’).
boolean
required
Whether the plan is archived. Archived plans cannot be attached to new customers.
object
required
Miscellaneous plan-level configuration flags.
Show properties
boolean
required
If true, entitlements attached to this plan will still reset on schedule even when the customer’s product is in a past_due state.
boolean
object
Plan-level billing controls used as customer defaults.
Show properties
object[]
List of auto top-up configurations per feature.
Show properties
string
required
The ID of the feature (credit balance) to auto top-up.
boolean
required
Whether auto top-up is enabled.
number
required
When the balance drops below this threshold, an auto top-up will be purchased.
number
required
Amount of credits to add per auto top-up.
object
Optional limit on auto top-ups per window, by number of top-ups or amount charged.
Show properties
'count' | 'amount'
What limit caps: the number of auto top-ups (count, default) or the total amount charged for them, in the customer’s currency (amount).
'hour' | 'day' | 'week' | 'month'
required
The time interval for the purchase limit window.
number
required
Number of intervals in the purchase limit window.
number
required
Maximum allowed within the interval: a number of auto top-ups when limit_type is count, or a total charge (e.g. 500 for $500, pre-tax) when limit_type is amount.
boolean
When true, auto top-up creates a send_invoice invoice instead of auto-charging.
object[]
List of overage spend limits per feature (caps overage spend).
Show properties
string
Optional feature ID this spend limit applies to.
boolean
required
Whether the overage spend limit is enabled.
'absolute' | 'usage_percentage'
How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
number
Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
boolean
When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.
object[]
List of hard usage caps per feature (max units per interval).
Show properties
string
required
The feature this usage limit applies to.
boolean
required
Whether this usage limit is enabled.
number
required
Maximum units allowed per interval.
'day' | 'week' | 'month' | 'year'
required
Interval for the cap, aligned to the customer’s billing cycle.
'billing_cycle' | 'utc'
Window alignment. ‘billing_cycle’ phases the interval to the customer’s renewal time; ‘utc’ aligns to the UTC calendar.
object
When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
Show properties
string
required
object[]
List of usage alert configurations per feature.
Show properties
string
The feature ID this alert applies to.
boolean
required
Whether this usage alert is enabled.
number
required
The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage. remaining and remaining_percentage accept negative values with basis balance, to alert once the balance is overdrawn.
What 100% means. balance: every grant on the feature. included: the plan allowance only. recurring: grants that reset. usage_limit: the cap of the usage limit with the same feature and filter.
object
Only valid with basis usage_limit. Points the alert at the usage limit carrying the same filter.
Show properties
string
required
string
Optional user-defined label to distinguish multiple alerts on the same feature.
object[]
List of overage allowed controls per feature. When enabled, usage can exceed balance.
Show properties
string
required
The feature ID this overage allowed control applies to.
boolean
required
Whether overage is allowed for this feature.
object
required
Arbitrary key-value metadata defined by you for your own use. Shared across all versions of the plan.
object
Show properties
boolean
Whether the trial on this plan is available to this customer. For example, if the customer used the trial in the past, this will be false.
'active' | 'scheduled'
The customer’s current status with this plan. ‘active’ if attached, ‘scheduled’ if pending activation.
boolean
Whether the customer’s active instance of this plan is set to cancel.
boolean
Whether the customer is currently on a free trial of this plan.
Flat amount for this tier in this currency, if the tier uses one.
'graduated' | 'volume'
How tiers price usage. ‘graduated’ (default) charges each unit at the rate of the tier it falls in. ‘volume’ picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier’s rate plus its flat_amount.
Billing interval. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.
number
Number of intervals per billing cycle. Defaults to 1.
number
Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).
'prepaid' | 'usage_based'
required
‘prepaid’ for upfront payment (seats), ‘usage_based’ for pay-as-you-go.
number | null
Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.
object
Proration settings for prepaid features. Controls mid-cycle quantity change billing.
Credit behavior when quantity decreases mid-cycle.
object
Rollover config for unused units. If set, unused included units carry over.
Show properties
number
Max rollover units. Omit for unlimited rollover.
number
Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.
'month' | 'forever'
required
When rolled over units expire.
number
Number of periods before expiry.
object
Purchased units expire this long after each purchase. One-off prepaid consumable items only.
Show properties
'day' | 'week' | 'month' | 'year'
required
number
required
object
Overrides fields of this item’s feature for customers on this plan (e.g. a credit system’s credit_schema).
Show properties
object | object | object[]
For credit system features: merges into the feature’s credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with excluded: true removes it, and unlisted features keep the credit system’s rate.
Show properties
string
ID of the metered feature that draws from this credit system.
number
Number of metered-feature units priced together. Defaults to one when omitted.
object
Named rates chosen by event properties. The most specific match sets the rate; with no match the item’s own rate applies.
Show properties
string
required
Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
integer
Breaks ties between dimensions that match the same number of keys. Higher wins.
string
required
object[]
required
Show properties
number
required
Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.
number
required
Credits consumed per billing-unit group within this tier.
object
Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.
Show properties
string
required
Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
number
Multiplies the matched rate. All matching multipliers stack.
number
Added to the rate after every factor is applied, in credits per billing-unit group.
string
object[]
Show properties
number
required
Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.
number
required
Credits consumed per billing-unit group within this tier.
number
Credits consumed per billing-unit group.
true
Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
object
For AI credit system features: replaces the feature’s markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature’s.
Show properties
number
Default percentage markup for customers on this plan. Use -100 to make usage free.
object | null
Per-provider markup percentages for customers on this plan.
Show properties
number
required
object | null
Per-model markup overrides for customers on this plan.
Show properties
number
number
number
object[]
Filters selecting items to remove from the plan.
Show properties
string
Match items linked to this feature.
'prepaid' | 'usage_based'
Match items with this billing method (prepaid or usage_based).
Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.
integer
Match items with this interval_count. Disambiguates between items that share an interval but differ in count.
number
Match items whose grant equals this included usage. Omitted is a wildcard.
object | null
Free trial configuration for a plan.
Show properties
number
required
Number of duration_type periods the trial lasts.
'day' | 'month' | 'year'
required
Unit of time for the trial (‘day’, ‘month’, ‘year’).
boolean
required
If true, a payment method is required to start the trial and the customer is charged when it ends. Defaults to false.
'bill' | 'revert'
object
Override the plan’s billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
Show properties
object[]
Show properties
string
required
The ID of the feature (credit balance) to auto top-up.
boolean
required
Whether auto top-up is enabled.
number
required
When the balance drops below this threshold, an auto top-up will be purchased.
number
required
Amount of credits to add per auto top-up.
object
Optional rate limit to cap how often auto top-ups occur. Pass count or amount to set the current window’s consumed top-ups or charged amount.
Show properties
'count' | 'amount'
What limit caps: the number of auto top-ups (count, default) or the total amount charged for them, in the customer’s currency (amount).
'hour' | 'day' | 'week' | 'month'
required
The time interval for the purchase limit window.
number
required
Number of intervals in the purchase limit window.
number
required
Maximum allowed within the interval: a number of auto top-ups when limit_type is count, or a total charge (e.g. 500 for $500, pre-tax) when limit_type is amount.
number
Set the current window’s consumed auto top-up count. Omit to leave runtime state unchanged.
number
Set the amount already charged by auto top-ups in the current window. Omit to leave runtime state unchanged.
boolean
When true, auto top-up creates a send_invoice invoice instead of auto-charging.
object[]
Show properties
string
Optional feature ID this spend limit applies to.
boolean
required
Whether the overage spend limit is enabled.
'absolute' | 'usage_percentage'
How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
number
Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
boolean
When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.
object[]
Show properties
string
required
The feature this usage limit applies to.
boolean
required
Whether this usage limit is enabled.
number
required
Maximum units allowed per interval.
'day' | 'week' | 'month' | 'year'
required
Interval for the cap, aligned to the customer’s billing cycle.
'billing_cycle' | 'utc'
Window alignment. ‘billing_cycle’ phases the interval to the customer’s renewal time; ‘utc’ aligns to the UTC calendar.
object
When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
Show properties
string
required
object[]
Show properties
string
The feature ID this alert applies to.
boolean
required
Whether this usage alert is enabled.
number
required
The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage. remaining and remaining_percentage accept negative values with basis balance, to alert once the balance is overdrawn.
What 100% means. balance: every grant on the feature. included: the plan allowance only. recurring: grants that reset. usage_limit: the cap of the usage limit with the same feature and filter.
object
Only valid with basis usage_limit. Points the alert at the usage limit carrying the same filter.
Show properties
string
required
string
Optional user-defined label to distinguish multiple alerts on the same feature.
object[]
Show properties
string
required
The feature ID this overage allowed control applies to.
boolean
required
Whether overage is allowed for this feature.
object[]
License links to add or override for this customer, keyed by license_plan_id. Omitted fields inherit the plan catalog link (included defaults to 1 when the license is not in the catalog). A bare entry restores the license to pure catalog inheritance.
Show properties
string
required
string
integer
boolean
object | null
Show properties
object | null
Base price configuration for a plan.
Show properties
number
required
Base price amount for the plan, in major currency units (e.g. dollars).
Flat amount for this tier in this currency, if the tier uses one.
'graduated' | 'volume'
How tiers price usage. ‘graduated’ (default) charges each unit at the rate of the tier it falls in. ‘volume’ picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier’s rate plus its flat_amount.
Billing interval. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.
number
Number of intervals per billing cycle. Defaults to 1.
number
Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).
'prepaid' | 'usage_based'
required
‘prepaid’ for upfront payment (seats), ‘usage_based’ for pay-as-you-go.
number | null
Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.
object
Proration settings for prepaid features. Controls mid-cycle quantity change billing.
Credit behavior when quantity decreases mid-cycle.
object
Rollover config for unused units. If set, unused included units carry over.
Show properties
number
Max rollover units. Omit for unlimited rollover.
number
Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.
'month' | 'forever'
required
When rolled over units expire.
number
Number of periods before expiry.
object
Purchased units expire this long after each purchase. One-off prepaid consumable items only.
Show properties
'day' | 'week' | 'month' | 'year'
required
number
required
object
Overrides fields of this item’s feature for customers on this plan (e.g. a credit system’s credit_schema).
Show properties
object | object | object[]
For credit system features: merges into the feature’s credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with excluded: true removes it, and unlisted features keep the credit system’s rate.
Show properties
string
ID of the metered feature that draws from this credit system.
number
Number of metered-feature units priced together. Defaults to one when omitted.
object
Named rates chosen by event properties. The most specific match sets the rate; with no match the item’s own rate applies.
Show properties
string
required
Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
integer
Breaks ties between dimensions that match the same number of keys. Higher wins.
string
required
object[]
required
Show properties
number
required
Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.
number
required
Credits consumed per billing-unit group within this tier.
object
Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.
Show properties
string
required
Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
number
Multiplies the matched rate. All matching multipliers stack.
number
Added to the rate after every factor is applied, in credits per billing-unit group.
string
object[]
Show properties
number
required
Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.
number
required
Credits consumed per billing-unit group within this tier.
number
Credits consumed per billing-unit group.
true
Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
object
For AI credit system features: replaces the feature’s markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature’s.
Show properties
number
Default percentage markup for customers on this plan. Use -100 to make usage free.
object | null
Per-provider markup percentages for customers on this plan.
Show properties
number
required
object | null
Per-model markup overrides for customers on this plan.
Show properties
number
number
number
object[]
Show properties
string
Match items linked to this feature.
'prepaid' | 'usage_based'
Match items with this billing method (prepaid or usage_based).
Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.
integer
Match items with this interval_count. Disambiguates between items that share an interval but differ in count.
number
Match items whose grant equals this included usage. Omitted is a wildcard.
object
object[]
License links to drop, keyed by license_plan_id. Parallel to remove_items.
Show properties
string
required
object | null
required
Sparse map of scalar plan fields that changed, holding their previous values. Null when the plan is new.
Show properties
string | null
Unique identifier for the plan.
string | null
Display name of the plan.
string | null | null
Optional description of the plan.
string | null | null
Group identifier for organizing related plans. Plans in the same group are mutually exclusive.
boolean | null
Whether this is an add-on plan that can be attached alongside a main plan.
boolean | null
If true, this plan is automatically attached when a customer is created. Used for free plans.
object | null
Miscellaneous plan-level configuration flags.
Show properties
boolean
required
If true, entitlements attached to this plan will still reset on schedule even when the customer’s product is in a past_due state.
boolean
boolean | null
Whether this is the active version of the plan. At most one version is active.
boolean | null
Whether the plan is archived. Archived plans cannot be attached to new customers.
object | null
Arbitrary key-value metadata defined by you for your own use. Shared across all versions of the plan.
object | null
Previous payment processors when they changed. Null when the plan had none.
Show properties
object | null
Show properties
string
required
Stripe product ID this plan is billed under.
string[]
Extra Stripe product IDs aliased to this plan.
object | null
Show properties
object[]
required
Every RevenueCat product that maps to this plan. Replaces the current set.
Show properties
string
required
RevenueCat product ID that grants this plan when purchased.
object[]
Prepaid quantities granted when this specific RevenueCat product is purchased, in feature units.
Show properties
string
required
number
string | null
The base plan this variant pointed at before this update re-anchored it. Null when it was standalone.
integer | null
The base row version this variant pointed at before this update. Null when it was standalone.
string | null
The base row version slug this variant pointed at before this update. Null when it was standalone.
object | null
Previous free trial when it changed. Null when the plan had none.
Show properties
number
required
Number of duration_type periods the trial lasts.
'day' | 'month' | 'year'
required
Unit of time for the trial duration (‘day’, ‘month’, ‘year’).
boolean
required
Whether a payment method is required to start the trial. If true, customer will be charged after trial ends.
'bill' | 'revert'
Behavior when the trial ends. ‘bill’ charges the customer (default). ‘revert’ expires the trial and restores the customer’s previous plan.
object | null
Sparse previous billing_controls — only keys that changed. Null when unset; a null lane was unset before.
Show properties
object[] | null
List of auto top-up configurations per feature.
Show properties
string
required
The ID of the feature (credit balance) to auto top-up.
boolean
required
Whether auto top-up is enabled.
number
required
When the balance drops below this threshold, an auto top-up will be purchased.
number
required
Amount of credits to add per auto top-up.
object
Optional limit on auto top-ups per window, by number of top-ups or amount charged.
Show properties
'count' | 'amount'
What limit caps: the number of auto top-ups (count, default) or the total amount charged for them, in the customer’s currency (amount).
'hour' | 'day' | 'week' | 'month'
required
The time interval for the purchase limit window.
number
required
Number of intervals in the purchase limit window.
number
required
Maximum allowed within the interval: a number of auto top-ups when limit_type is count, or a total charge (e.g. 500 for $500, pre-tax) when limit_type is amount.
boolean
When true, auto top-up creates a send_invoice invoice instead of auto-charging.
object[] | null
List of overage spend limits per feature (caps overage spend).
Show properties
string
Optional feature ID this spend limit applies to.
boolean
required
Whether the overage spend limit is enabled.
'absolute' | 'usage_percentage'
How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
number
Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
boolean
When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.
object[] | null
List of hard usage caps per feature (max units per interval).
Show properties
string
required
The feature this usage limit applies to.
boolean
required
Whether this usage limit is enabled.
number
required
Maximum units allowed per interval.
'day' | 'week' | 'month' | 'year'
required
Interval for the cap, aligned to the customer’s billing cycle.
'billing_cycle' | 'utc'
Window alignment. ‘billing_cycle’ phases the interval to the customer’s renewal time; ‘utc’ aligns to the UTC calendar.
object
When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
Show properties
string
required
object[] | null
List of usage alert configurations per feature.
Show properties
string
The feature ID this alert applies to.
boolean
required
Whether this usage alert is enabled.
number
required
The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage. remaining and remaining_percentage accept negative values with basis balance, to alert once the balance is overdrawn.
What 100% means. balance: every grant on the feature. included: the plan allowance only. recurring: grants that reset. usage_limit: the cap of the usage limit with the same feature and filter.
object
Only valid with basis usage_limit. Points the alert at the usage limit carrying the same filter.
Show properties
string
required
string
Optional user-defined label to distinguish multiple alerts on the same feature.
object[] | null
List of overage allowed controls per feature. When enabled, usage can exceed balance.
Show properties
string
required
The feature ID this overage allowed control applies to.
boolean
required
Whether overage is allowed for this feature.
object
Present when the plan’s price changed.
Show properties
object | null | null
required
Base recurring price for the plan. Null for free plans or usage-only plans.
Show properties
number
required
Base price amount for the plan, in major currency units (e.g. dollars).
object[]
Base price amounts in additional currencies. The base ‘amount’ is in the org’s default currency.
The interval at which the feature balance resets (e.g. ‘month’, ‘year’). For consumable features, usage resets to 0 and included units are restored.
number
Number of intervals between resets. Defaults to 1.
object | null
required
Pricing configuration for usage beyond included units. Null if feature is entirely free.
Show properties
number
Price per billing_units after included usage is consumed. Mutually exclusive with tiers.
object[]
Amounts in additional currencies for this flat price. The base ‘amount’ is in the org’s default currency. Only valid with ‘amount’, not ‘tiers’ (tiered prices carry per-currency amounts on each tier).
Flat amount for this tier in this currency, if the tier uses one.
'graduated' | 'volume'
How tiers price usage. ‘graduated’ (default) charges each unit at the rate of the tier it falls in. ‘volume’ picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier’s rate plus its flat_amount.
Billing interval for this price. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.
number
Number of intervals per billing cycle. Defaults to 1.
number
required
Number of units per price increment. Usage is rounded UP to the nearest billing_units when billed (e.g. billing_units=100 means 101 usage rounds to 200).
'prepaid' | 'usage_based'
required
‘prepaid’ for features like seats where customers pay upfront, ‘usage_based’ for pay-as-you-go after included usage.
number | null
required
Maximum units a customer can purchase beyond included. E.g. if included=100 and max_purchase=300, customer can use up to 400 total before usage is capped. Null for no limit.
object
Payment processors this item price is connected to. Omitted when unset.
Show properties
object | null
Show properties
string
required
Stripe price ID. For prepaid with included > 0 this is the V2 price.
object
Display text for showing this item in pricing pages.
Show properties
string
required
Main display text (e.g. ‘$10’ or ‘100 messages’).
string
Secondary display text (e.g. ‘per month’ or ‘then $0.5 per 100’).
object
Rollover configuration for unused units. If set, unused included units roll over to the next period.
Show properties
number | null
required
Maximum rollover units. Null for unlimited rollover.
number | null
Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.
'month' | 'forever'
required
When rolled over units expire.
number
Number of periods before expiry.
object | null
Purchased units expire this long after each purchase. One-off prepaid consumable items only.
Show properties
'day' | 'week' | 'month' | 'year'
required
number
required
object
Overrides fields of this item’s feature for customers on this plan (e.g. a credit system’s credit_schema).
Show properties
object | object | object[]
For credit system features: merges into the feature’s credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with excluded: true removes it, and unlisted features keep the credit system’s rate.
Show properties
string
ID of the metered feature that draws from this credit system.
number
Number of metered-feature units priced together. Defaults to one when omitted.
object
Named rates chosen by event properties. The most specific match sets the rate; with no match the item’s own rate applies.
Show properties
string
required
Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
integer
Breaks ties between dimensions that match the same number of keys. Higher wins.
string
required
object[]
required
Show properties
number
required
Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.
number
required
Credits consumed per billing-unit group within this tier.
object
Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.
Show properties
string
required
Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
number
Multiplies the matched rate. All matching multipliers stack.
number
Added to the rate after every factor is applied, in credits per billing-unit group.
string
object[]
Show properties
number
required
Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.
number
required
Credits consumed per billing-unit group within this tier.
number
Credits consumed per billing-unit group.
true
Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
object
For AI credit system features: replaces the feature’s markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature’s.
Show properties
number
Default percentage markup for customers on this plan. Use -100 to make usage free.
object | null
Per-provider markup percentages for customers on this plan.
Show properties
number
required
object | null
Per-model markup overrides for customers on this plan.
Show properties
number
number
number
object
Params that would transform the previous plan into the current one. Omitted when nothing customizable changed.
Show properties
object | null
Base price configuration for a plan.
Show properties
number
required
Base price amount for the plan, in major currency units (e.g. dollars).
Flat amount for this tier in this currency, if the tier uses one.
'graduated' | 'volume'
How tiers price usage. ‘graduated’ (default) charges each unit at the rate of the tier it falls in. ‘volume’ picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier’s rate plus its flat_amount.
Billing interval. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.
number
Number of intervals per billing cycle. Defaults to 1.
number
Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).
'prepaid' | 'usage_based'
required
‘prepaid’ for upfront payment (seats), ‘usage_based’ for pay-as-you-go.
number | null
Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.
object
Proration settings for prepaid features. Controls mid-cycle quantity change billing.
Credit behavior when quantity decreases mid-cycle.
object
Rollover config for unused units. If set, unused included units carry over.
Show properties
number
Max rollover units. Omit for unlimited rollover.
number
Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.
'month' | 'forever'
required
When rolled over units expire.
number
Number of periods before expiry.
object
Purchased units expire this long after each purchase. One-off prepaid consumable items only.
Show properties
'day' | 'week' | 'month' | 'year'
required
number
required
object
Overrides fields of this item’s feature for customers on this plan (e.g. a credit system’s credit_schema).
Show properties
object | object | object[]
For credit system features: merges into the feature’s credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with excluded: true removes it, and unlisted features keep the credit system’s rate.
Show properties
string
ID of the metered feature that draws from this credit system.
number
Number of metered-feature units priced together. Defaults to one when omitted.
object
Named rates chosen by event properties. The most specific match sets the rate; with no match the item’s own rate applies.
Show properties
string
required
Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
integer
Breaks ties between dimensions that match the same number of keys. Higher wins.
string
required
object[]
required
Show properties
number
required
Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.
number
required
Credits consumed per billing-unit group within this tier.
object
Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.
Show properties
string
required
Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
number
Multiplies the matched rate. All matching multipliers stack.
number
Added to the rate after every factor is applied, in credits per billing-unit group.
string
object[]
Show properties
number
required
Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.
number
required
Credits consumed per billing-unit group within this tier.
number
Credits consumed per billing-unit group.
true
Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
object
For AI credit system features: replaces the feature’s markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature’s.
Show properties
number
Default percentage markup for customers on this plan. Use -100 to make usage free.
object | null
Per-provider markup percentages for customers on this plan.
Show properties
number
required
object | null
Per-model markup overrides for customers on this plan.
Show properties
number
number
number
object[]
Filters selecting items to remove from the plan.
Show properties
string
Match items linked to this feature.
'prepaid' | 'usage_based'
Match items with this billing method (prepaid or usage_based).
Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.
integer
Match items with this interval_count. Disambiguates between items that share an interval but differ in count.
number
Match items whose grant equals this included usage. Omitted is a wildcard.
object | null
Free trial configuration for a plan.
Show properties
number
required
Number of duration_type periods the trial lasts.
'day' | 'month' | 'year'
required
Unit of time for the trial (‘day’, ‘month’, ‘year’).
boolean
required
If true, a payment method is required to start the trial and the customer is charged when it ends. Defaults to false.
'bill' | 'revert'
object
Override the plan’s billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
Show properties
object[]
Show properties
string
required
The ID of the feature (credit balance) to auto top-up.
boolean
required
Whether auto top-up is enabled.
number
required
When the balance drops below this threshold, an auto top-up will be purchased.
number
required
Amount of credits to add per auto top-up.
object
Optional rate limit to cap how often auto top-ups occur. Pass count or amount to set the current window’s consumed top-ups or charged amount.
Show properties
'count' | 'amount'
What limit caps: the number of auto top-ups (count, default) or the total amount charged for them, in the customer’s currency (amount).
'hour' | 'day' | 'week' | 'month'
required
The time interval for the purchase limit window.
number
required
Number of intervals in the purchase limit window.
number
required
Maximum allowed within the interval: a number of auto top-ups when limit_type is count, or a total charge (e.g. 500 for $500, pre-tax) when limit_type is amount.
number
Set the current window’s consumed auto top-up count. Omit to leave runtime state unchanged.
number
Set the amount already charged by auto top-ups in the current window. Omit to leave runtime state unchanged.
boolean
When true, auto top-up creates a send_invoice invoice instead of auto-charging.
object[]
Show properties
string
Optional feature ID this spend limit applies to.
boolean
required
Whether the overage spend limit is enabled.
'absolute' | 'usage_percentage'
How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
number
Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
boolean
When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.
object[]
Show properties
string
required
The feature this usage limit applies to.
boolean
required
Whether this usage limit is enabled.
number
required
Maximum units allowed per interval.
'day' | 'week' | 'month' | 'year'
required
Interval for the cap, aligned to the customer’s billing cycle.
'billing_cycle' | 'utc'
Window alignment. ‘billing_cycle’ phases the interval to the customer’s renewal time; ‘utc’ aligns to the UTC calendar.
object
When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
Show properties
string
required
object[]
Show properties
string
The feature ID this alert applies to.
boolean
required
Whether this usage alert is enabled.
number
required
The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage. remaining and remaining_percentage accept negative values with basis balance, to alert once the balance is overdrawn.
What 100% means. balance: every grant on the feature. included: the plan allowance only. recurring: grants that reset. usage_limit: the cap of the usage limit with the same feature and filter.
object
Only valid with basis usage_limit. Points the alert at the usage limit carrying the same filter.
Show properties
string
required
string
Optional user-defined label to distinguish multiple alerts on the same feature.
object[]
Show properties
string
required
The feature ID this overage allowed control applies to.
boolean
required
Whether overage is allowed for this feature.
object[]
License links to add or override for this customer, keyed by license_plan_id. Omitted fields inherit the plan catalog link (included defaults to 1 when the license is not in the catalog). A bare entry restores the license to pure catalog inheritance.
Show properties
string
required
string
integer
boolean
object | null
Show properties
object | null
Base price configuration for a plan.
Show properties
number
required
Base price amount for the plan, in major currency units (e.g. dollars).
Flat amount for this tier in this currency, if the tier uses one.
'graduated' | 'volume'
How tiers price usage. ‘graduated’ (default) charges each unit at the rate of the tier it falls in. ‘volume’ picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier’s rate plus its flat_amount.
Billing interval. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.
number
Number of intervals per billing cycle. Defaults to 1.
number
Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).
'prepaid' | 'usage_based'
required
‘prepaid’ for upfront payment (seats), ‘usage_based’ for pay-as-you-go.
number | null
Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.
object
Proration settings for prepaid features. Controls mid-cycle quantity change billing.
Credit behavior when quantity decreases mid-cycle.
object
Rollover config for unused units. If set, unused included units carry over.
Show properties
number
Max rollover units. Omit for unlimited rollover.
number
Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.
'month' | 'forever'
required
When rolled over units expire.
number
Number of periods before expiry.
object
Purchased units expire this long after each purchase. One-off prepaid consumable items only.
Show properties
'day' | 'week' | 'month' | 'year'
required
number
required
object
Overrides fields of this item’s feature for customers on this plan (e.g. a credit system’s credit_schema).
Show properties
object | object | object[]
For credit system features: merges into the feature’s credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with excluded: true removes it, and unlisted features keep the credit system’s rate.
Show properties
string
ID of the metered feature that draws from this credit system.
number
Number of metered-feature units priced together. Defaults to one when omitted.
object
Named rates chosen by event properties. The most specific match sets the rate; with no match the item’s own rate applies.
Show properties
string
required
Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
integer
Breaks ties between dimensions that match the same number of keys. Higher wins.
string
required
object[]
required
Show properties
number
required
Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.
number
required
Credits consumed per billing-unit group within this tier.
object
Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.
Show properties
string
required
Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
number
Multiplies the matched rate. All matching multipliers stack.
number
Added to the rate after every factor is applied, in credits per billing-unit group.
string
object[]
Show properties
number
required
Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.
number
required
Credits consumed per billing-unit group within this tier.
number
Credits consumed per billing-unit group.
true
Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
object
For AI credit system features: replaces the feature’s markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature’s.
Show properties
number
Default percentage markup for customers on this plan. Use -100 to make usage free.
object | null
Per-provider markup percentages for customers on this plan.
Show properties
number
required
object | null
Per-model markup overrides for customers on this plan.
Show properties
number
number
number
object[]
Show properties
string
Match items linked to this feature.
'prepaid' | 'usage_based'
Match items with this billing method (prepaid or usage_based).
Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.
integer
Match items with this interval_count. Disambiguates between items that share an interval but differ in count.
number
Match items whose grant equals this included usage. Omitted is a wildcard.
object
object[]
License links to drop, keyed by license_plan_id. Parallel to remove_items.
Show properties
string
required
object[]
required
Deprecated — use plan_change.item_changes. Features that were added to or removed from this plan.
Show properties
'created' | 'deleted'
required
Whether the item was added to or removed from the plan.
string
required
The ID of the feature that was added or removed.
object
required
The plan item snapshot that was added or removed.
Show properties
object | null
Bills this many feature units when outstanding overage reaches it.
Show properties
number
required
string
required
The ID of the feature this item configures.
object
The full feature object if expanded.
Show properties
string
required
The ID of the feature, used to refer to it in other API calls like /track or /check.
The interval at which the feature balance resets (e.g. ‘month’, ‘year’). For consumable features, usage resets to 0 and included units are restored.
number
Number of intervals between resets. Defaults to 1.
object | null
required
Pricing configuration for usage beyond included units. Null if feature is entirely free.
Show properties
number
Price per billing_units after included usage is consumed. Mutually exclusive with tiers.
object[]
Amounts in additional currencies for this flat price. The base ‘amount’ is in the org’s default currency. Only valid with ‘amount’, not ‘tiers’ (tiered prices carry per-currency amounts on each tier).
Flat amount for this tier in this currency, if the tier uses one.
'graduated' | 'volume'
How tiers price usage. ‘graduated’ (default) charges each unit at the rate of the tier it falls in. ‘volume’ picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier’s rate plus its flat_amount.
Billing interval for this price. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.
number
Number of intervals per billing cycle. Defaults to 1.
number
required
Number of units per price increment. Usage is rounded UP to the nearest billing_units when billed (e.g. billing_units=100 means 101 usage rounds to 200).
'prepaid' | 'usage_based'
required
‘prepaid’ for features like seats where customers pay upfront, ‘usage_based’ for pay-as-you-go after included usage.
number | null
required
Maximum units a customer can purchase beyond included. E.g. if included=100 and max_purchase=300, customer can use up to 400 total before usage is capped. Null for no limit.
object
Payment processors this item price is connected to. Omitted when unset.
Show properties
object | null
Show properties
string
required
Stripe price ID. For prepaid with included > 0 this is the V2 price.
object
Display text for showing this item in pricing pages.
Show properties
string
required
Main display text (e.g. ‘$10’ or ‘100 messages’).
string
Secondary display text (e.g. ‘per month’ or ‘then $0.5 per 100’).
object
Rollover configuration for unused units. If set, unused included units roll over to the next period.
Show properties
number | null
required
Maximum rollover units. Null for unlimited rollover.
number | null
Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.
'month' | 'forever'
required
When rolled over units expire.
number
Number of periods before expiry.
object | null
Purchased units expire this long after each purchase. One-off prepaid consumable items only.
Show properties
'day' | 'week' | 'month' | 'year'
required
number
required
object
Overrides fields of this item’s feature for customers on this plan (e.g. a credit system’s credit_schema).
Show properties
object | object | object[]
For credit system features: merges into the feature’s credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with excluded: true removes it, and unlisted features keep the credit system’s rate.
Show properties
string
ID of the metered feature that draws from this credit system.
number
Number of metered-feature units priced together. Defaults to one when omitted.
object
Named rates chosen by event properties. The most specific match sets the rate; with no match the item’s own rate applies.
Show properties
string
required
Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
integer
Breaks ties between dimensions that match the same number of keys. Higher wins.
string
required
object[]
required
Show properties
number
required
Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.
number
required
Credits consumed per billing-unit group within this tier.
object
Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.
Show properties
string
required
Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
number
Multiplies the matched rate. All matching multipliers stack.
number
Added to the rate after every factor is applied, in credits per billing-unit group.
string
object[]
Show properties
number
required
Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.
number
required
Credits consumed per billing-unit group within this tier.
number
Credits consumed per billing-unit group.
true
Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
object
For AI credit system features: replaces the feature’s markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature’s.
Show properties
number
Default percentage markup for customers on this plan. Use -100 to make usage free.
object | null
Per-provider markup percentages for customers on this plan.
Show properties
number
required
object | null
Per-model markup overrides for customers on this plan.
Show properties
number
number
number
string[]
required
Reason tags describing why this event fired (e.g. ‘trial_ended’, ‘phase_changed’). Always present; empty when no specific reason applies.
Authorizations
Authorization
string
header
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Autumn","colors":{"primary":"#8838ff","light":"#9b5cff","dark":"#8838ff"},"logo":{"light":"https://mintcdn.com/autumn-b9b4c0fb/BOEMpWFJsAdGcii1/assets/logo/autumn-dark.svg?fit=max\u0026auto=format\u0026n=BOEMpWFJsAdGcii1\u0026q=85\u0026s=720bd2227c435e77f2c91cbfcbccd274","dark":"https://mintcdn.com/autumn-b9b4c0fb/BOEMpWFJsAdGcii1/assets/logo/autumn-light.svg?fit=max\u0026auto=format\u0026n=BOEMpWFJsAdGcii1\u0026q=85\u0026s=f700b862e5d0ada8c89a5976d27863fe"},"favicon":"https://mintcdn.com/autumn-b9b4c0fb/ihHX49Ug6NamJ10t/favicon.svg?fit=max\u0026auto=format\u0026n=ihHX49Ug6NamJ10t\u0026q=85\u0026s=b1fd8b3e3086e5a3855a8cf8c45dd57a","api":{"playground":{"display":"interactive"},"examples":{"languages":["typescript","python","bash"]}},"appearance":{"default":"system","strict":false},"background":{"color":{"light":"#FFFFFF","dark":"#0A0A0A"}},"navbar":{"primary":{"type":"button","label":"Dashboard","href":"https://app.useautumn.com"}},"footer":{"socials":{"x":"https://x.com/autumnpricing","linkedin":"https://linkedin.com/company/useautumn"}},"fonts":{"heading":{"family":"Inter"},"body":{"family":"Inter"}},"contextual":{"options":["copy","cursor","view"],"display":"header"},"interaction":{"drilldown":true},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Discord","icon":"discord","href":"https://discord.gg/STqxY92zuS"},{"anchor":"Website","icon":"globe","href":"https://useautumn.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"autumn-b9b4c0fb","hasAudioNarration":false,"actualSubdomain":"autumn-b9b4c0fb","customDomains":["docs.useautumn.com"],"gitSource":{"type":"github","owner":"useautumn","repo":"autumn","deployBranch":"main","contentDirectory":"apps/docs/mintlify","isPrivate":true,"mountPath":"","label":""},"feedback":{"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b005d7863690229f1b7eb5c","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"API Reference","count":107},{"language":"default","tag":"Documentation","count":61},{"language":"default","tag":"Billing","count":21},{"language":"default","tag":"Configure Pricing","count":19},{"language":"default","tag":"Lakehouse","count":18},{"language":"default","tag":"Customers","count":16},{"language":"default","tag":"Rewards \u0026 Referrals","count":13},{"language":"default","tag":"Additional Resources","count":13},{"language":"default","tag":"Balances","count":12},{"language":"default","tag":"Webhook Events","count":10}],"searchSettings":{"tuning":{"anchor":{"titleCoverageRelabel":true}}}},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"language-tabs.css","content":"[data-testid=\"code-sample-language-select\"],.code-sample-language-select,[aria-haspopup=\"listbox\"]{}"},{"filePath":"style.css","content":".prose>.api-section{display:none!important}"}]}
{"page":{"pagePath":"api-reference/webhooks/billingUpdated","slug":"/api-reference/webhooks/billingUpdated","pageMetadata":{"title":"Plans Updated","openapi":"api/openapi.yml webhook billing.updated","description":"Fired when a customer's plans change — activated, scheduled, updated, or expired. Each event carries a `plan_changes` array describing what happened and a `tags` array (e.g. `trial_ended`, `phase_changed`) describing why.","href":"/api-reference/webhooks/billingUpdated"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Fired when a customer’s plans change — activated, scheduled, updated, or expired. Each event carries a \", _jsx(_components.code, {\n children: \"plan_changes\"\n }), \" array describing what happened and a \", _jsx(_components.code, {\n children: \"tags\"\n }), \" array (e.g. \", _jsx(_components.code, {\n children: \"trial_ended\"\n }), \", \", _jsx(_components.code, {\n children: \"phase_changed\"\n }), \") describing why.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,..._provideComponents(),...props.components},{Expandable,Heading,ParamField}=_components;if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`3`,id:`payload-fields`,children:`Payload Fields`}),`\n`,_jsx(ParamField,{body:`object`,type:`string`,required:true,id:`param-object`}),`\n`,_jsx(ParamField,{body:`customer_id`,type:`string`,required:true,id:`param-customer-id`,children:_jsx(_components.p,{children:`The ID of the customer whose plans changed.`})}),`\n`,_jsx(ParamField,{body:`entity_id`,type:`string | null`,id:`param-entity-id`,children:_jsx(_components.p,{children:`The ID of the entity, if the changes are scoped to a specific entity.`})}),`\n`,_jsxs(ParamField,{body:`plan_changes`,type:`object[]`,required:true,id:`param-plan-changes`,children:[_jsx(_components.p,{children:`The plans that were activated, scheduled, updated, or expired.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`entity_id`,type:`string | null`,id:`param-entity-id-1`,children:_jsx(_components.p,{children:`The ID of the entity this plan is scoped to, or null when the plan is customer-level. A single event can carry changes for several entities.`})}),_jsx(ParamField,{body:`action`,type:`'activated' | 'scheduled' | 'updated' | 'expired' | 'paused'`,required:true,id:`param-action`,children:_jsx(_components.p,{children:`The lifecycle action applied to this plan: activated (newly active on the customer), scheduled (queued for a future start), updated (mutated in place), expired (ended), or paused (set aside until a revert trial ends).`})}),_jsxs(ParamField,{body:`subscription`,type:`object`,id:`param-subscription`,children:[_jsx(_components.p,{children:`The subscription as it stands after this change. Present when the plan is billed as a recurring subscription.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`plan_id`,type:`string`,required:true,id:`param-plan-id`,children:_jsx(_components.p,{children:`The ID of the customer plan.`})}),_jsx(ParamField,{body:`status`,type:`'active' | 'scheduled' | 'expired'`,required:true,id:`param-status`,children:_jsx(_components.p,{children:`The current status of the subscription on the customer.`})}),_jsx(ParamField,{body:`past_due`,type:`boolean`,required:true,id:`param-past-due`,children:_jsx(_components.p,{children:`Whether the subscription has overdue payments.`})}),_jsx(ParamField,{body:`started_at`,type:`number | null`,required:true,id:`param-started-at`,children:_jsx(_components.p,{children:`When the subscription started, in milliseconds since the Unix epoch.`})}),_jsx(ParamField,{body:`canceled_at`,type:`number | null`,required:true,id:`param-canceled-at`,children:_jsx(_components.p,{children:`When the subscription was canceled, in milliseconds since the Unix epoch, or null if not canceled.`})}),_jsx(ParamField,{body:`expires_at`,type:`number | null`,required:true,id:`param-expires-at`,children:_jsx(_components.p,{children:`When the subscription ends, in milliseconds since the Unix epoch, or null if no expiry is set.`})}),_jsx(ParamField,{body:`trial_ends_at`,type:`number | null`,required:true,id:`param-trial-ends-at`,children:_jsx(_components.p,{children:`When the trial ends, in milliseconds since the Unix epoch. Null when not actively trialing.`})}),_jsx(ParamField,{body:`current_period_start`,type:`number | null`,required:true,id:`param-current-period-start`,children:_jsx(_components.p,{children:`Start of the current billing period, or null if not applicable.`})}),_jsx(ParamField,{body:`current_period_end`,type:`number | null`,required:true,id:`param-current-period-end`,children:_jsx(_components.p,{children:`End of the current billing period, or null if not applicable.`})})]})]}),_jsxs(ParamField,{body:`purchase`,type:`object`,id:`param-purchase`,children:[_jsx(_components.p,{children:`The purchase as it stands after this change. Present when the plan is a one-off purchase.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`plan_id`,type:`string`,required:true,id:`param-plan-id-1`,children:_jsx(_components.p,{children:`The ID of the customer plan.`})}),_jsx(ParamField,{body:`status`,type:`'active' | 'scheduled' | 'expired'`,required:true,id:`param-status-1`,children:_jsx(_components.p,{children:`The current status of the purchase on the customer.`})}),_jsx(ParamField,{body:`expires_at`,type:`number | null`,required:true,id:`param-expires-at-1`,children:_jsx(_components.p,{children:`When the purchase ends, in milliseconds since the Unix epoch, or null if no expiry is set.`})})]})]}),_jsxs(ParamField,{body:`previous_attributes`,type:`object | null`,required:true,id:`param-previous-attributes`,children:[_jsx(_components.p,{children:`Sparse map of lifecycle scalar fields whose values changed, holding their previous values. Null when the plan is newly activated or scheduled, or when no lifecycle field changed.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`status`,type:`'active' | 'scheduled' | 'expired'`,id:`param-status-2`,children:_jsx(_components.p,{children:`The current status of the subscription on the customer.`})}),_jsx(ParamField,{body:`past_due`,type:`boolean`,id:`param-past-due-1`,children:_jsx(_components.p,{children:`Whether the subscription has overdue payments.`})}),_jsx(ParamField,{body:`canceled_at`,type:`number | null`,id:`param-canceled-at-1`,children:_jsx(_components.p,{children:`When the subscription was canceled, in milliseconds since the Unix epoch, or null if not canceled.`})}),_jsx(ParamField,{body:`expires_at`,type:`number | null`,id:`param-expires-at-2`,children:_jsx(_components.p,{children:`When the subscription ends, in milliseconds since the Unix epoch, or null if no expiry is set.`})}),_jsx(ParamField,{body:`trial_ends_at`,type:`number | null`,id:`param-trial-ends-at-1`,children:_jsx(_components.p,{children:`When the trial ends, in milliseconds since the Unix epoch. Null when not actively trialing.`})})]})]}),_jsxs(ParamField,{body:`plan_change`,type:`object`,id:`param-plan-change`,children:[_jsx(_components.p,{children:`Content-level change to the plan definition for this customer plan (items, base price, free trial).`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`plan`,type:`object`,id:`param-plan`,children:[_jsx(_components.p,{children:`The plan after the change. Omitted unless the caller expands it.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`id`,type:`string`,required:true,id:`param-id`,children:_jsx(_components.p,{children:`Unique identifier for the plan.`})}),_jsx(ParamField,{body:`name`,type:`string`,required:true,id:`param-name`,children:_jsx(_components.p,{children:`Display name of the plan.`})}),_jsx(ParamField,{body:`description`,type:`string | null`,required:true,id:`param-description`,children:_jsx(_components.p,{children:`Optional description of the plan.`})}),_jsx(ParamField,{body:`group`,type:`string | null`,required:true,id:`param-group`,children:_jsx(_components.p,{children:`Group identifier for organizing related plans. Plans in the same group are mutually exclusive.`})}),_jsx(ParamField,{body:`version`,type:`number`,required:true,id:`param-version`,children:_jsx(_components.p,{children:`Version number of the plan. Incremented when plan configuration changes.`})}),_jsx(ParamField,{body:`version_slug`,type:`string | null`,id:`param-version-slug`,children:_jsx(_components.p,{children:`User-facing version identity. Defaults to v{n} when the version is minted.`})}),_jsx(ParamField,{body:`active`,type:`boolean`,id:`param-active`,children:_jsx(_components.p,{children:`Whether this is the active version of the plan. At most one version is active.`})}),_jsx(ParamField,{body:`add_on`,type:`boolean`,required:true,id:`param-add-on`,children:_jsx(_components.p,{children:`Whether this is an add-on plan that can be attached alongside a main plan.`})}),_jsx(ParamField,{body:`auto_enable`,type:`boolean`,required:true,id:`param-auto-enable`,children:_jsx(_components.p,{children:`If true, this plan is automatically attached when a customer is created. Used for free plans.`})}),_jsxs(ParamField,{body:`price`,type:`object | null`,required:true,id:`param-price`,children:[_jsx(_components.p,{children:`Base recurring price for the plan. Null for free plans or usage-only plans.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount`,children:_jsx(_components.p,{children:`Base price amount for the plan, in major currency units (e.g. dollars).`})}),_jsxs(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies`,children:[_jsx(_components.p,{children:`Base price amounts in additional currencies. The base ‘amount’ is in the org’s default currency.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-1`,children:_jsx(_components.p,{children:`Price amount in this currency. Set explicitly per currency, not converted from the base amount.`})})]})]}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval`,children:_jsx(_components.p,{children:`Billing interval (e.g. ‘month’, ‘year’).`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count`,children:_jsx(_components.p,{children:`Number of intervals per billing cycle. Defaults to 1.`})}),_jsxs(ParamField,{body:`display`,type:`object`,id:`param-display`,children:[_jsx(_components.p,{children:`Display text for showing this price in pricing pages.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`primary_text`,type:`string`,required:true,id:`param-primary-text`,children:_jsx(_components.p,{children:`Main display text (e.g. ‘$10’ or ‘100 messages’).`})}),_jsx(ParamField,{body:`secondary_text`,type:`string`,id:`param-secondary-text`,children:_jsx(_components.p,{children:`Secondary display text (e.g. ‘per month’ or ‘then $0.5 per 100’).`})})]})]}),_jsxs(ParamField,{body:`processors`,type:`object`,id:`param-processors`,children:[_jsx(_components.p,{children:`Payment processors this base price is connected to. Omitted when unset.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`stripe`,type:`object | null`,id:`param-stripe`,children:_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`price_id`,type:`string`,required:true,id:`param-price-id`,children:_jsx(_components.p,{children:`Stripe price ID. For prepaid with included > 0 this is the V2 price.`})})})})})]})]})]}),_jsxs(ParamField,{body:`items`,type:`object[]`,required:true,id:`param-items`,children:[_jsx(_components.p,{children:`Feature configurations included in this plan. Each item defines included units, pricing, and reset behavior for a feature.`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`threshold_billing`,type:`object | null`,id:`param-threshold-billing`,children:[_jsx(_components.p,{children:`Bills this many feature units when outstanding overage reaches it.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold`})})]}),_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id`,children:_jsx(_components.p,{children:`The ID of the feature this item configures.`})}),_jsxs(ParamField,{body:`feature`,type:`object`,id:`param-feature`,children:[_jsx(_components.p,{children:`The full feature object if expanded.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`id`,type:`string`,required:true,id:`param-id-1`,children:_jsx(_components.p,{children:`The ID of the feature, used to refer to it in other API calls like /track or /check.`})}),_jsx(ParamField,{body:`name`,type:`string | null`,id:`param-name-1`,children:_jsx(_components.p,{children:`The name of the feature.`})}),_jsx(ParamField,{body:`type`,type:`'static' | 'boolean' | 'single_use' | 'continuous_use' | 'credit_system' | 'ai_credit_system'`,required:true,id:`param-type`,children:_jsx(_components.p,{children:`The type of the feature`})}),_jsxs(ParamField,{body:`display`,type:`object | null`,id:`param-display-1`,children:[_jsx(_components.p,{children:`Singular and plural display names for the feature.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`singular`,type:`string`,required:true,id:`param-singular`,children:_jsx(_components.p,{children:`The singular display name for the feature.`})}),_jsx(ParamField,{body:`plural`,type:`string`,required:true,id:`param-plural`,children:_jsx(_components.p,{children:`The plural display name for the feature.`})})]})]}),_jsxs(ParamField,{body:`credit_schema`,type:`object[] | null`,id:`param-credit-schema`,children:[_jsx(_components.p,{children:`Credit cost schema for credit system features.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`metered_feature_id`,type:`string`,required:true,id:`param-metered-feature-id`,children:_jsx(_components.p,{children:`The ID of the metered feature (should be a single_use feature).`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost`,children:_jsx(_components.p,{children:`The credit cost of the metered feature.`})})]})]}),_jsx(ParamField,{body:`archived`,type:`boolean | null`,id:`param-archived`,children:_jsx(_components.p,{children:`Whether or not the feature is archived.`})})]})]}),_jsx(ParamField,{body:`included`,type:`number`,required:true,id:`param-included`,children:_jsx(_components.p,{children:`Number of free units included. For consumable features, balance resets to this number each interval.`})}),_jsx(ParamField,{body:`unlimited`,type:`boolean`,required:true,id:`param-unlimited`,children:_jsx(_components.p,{children:`Whether the customer has unlimited access to this feature.`})}),_jsx(ParamField,{body:`pooled`,type:`boolean`,id:`param-pooled`,children:_jsx(_components.p,{children:`Whether entity-level grants contribute to a shared customer balance.`})}),_jsxs(ParamField,{body:`reset`,type:`object | null`,required:true,id:`param-reset`,children:[_jsx(_components.p,{children:`Reset configuration for consumable features. Null for non-consumable features like seats where usage persists across billing cycles.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`interval`,type:`'one_off' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-1`,children:_jsx(_components.p,{children:`The interval at which the feature balance resets (e.g. ‘month’, ‘year’). For consumable features, usage resets to 0 and included units are restored.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-1`,children:_jsx(_components.p,{children:`Number of intervals between resets. Defaults to 1.`})})]})]}),_jsxs(ParamField,{body:`price`,type:`object | null`,required:true,id:`param-price-1`,children:[_jsx(_components.p,{children:`Pricing configuration for usage beyond included units. Null if feature is entirely free.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-2`,children:_jsx(_components.p,{children:`Price per billing_units after included usage is consumed. Mutually exclusive with tiers.`})}),_jsxs(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-1`,children:[_jsx(_components.p,{children:`Amounts in additional currencies for this flat price. The base ‘amount’ is in the org’s default currency. Only valid with ‘amount’, not ‘tiers’ (tiered prices carry per-currency amounts on each tier).`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-1`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-3`,children:_jsx(_components.p,{children:`Price amount in this currency. Set explicitly per currency, not converted from the base amount.`})})]})]}),_jsxs(ParamField,{body:`tiers`,type:`object[]`,id:`param-tiers`,children:[_jsx(_components.p,{children:`Tiered pricing configuration. Each tier’s ‘to’ INCLUDES the included amount. Either ‘tiers’ or ‘amount’ is required.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to`}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-4`}),_jsx(ParamField,{body:`flat_amount`,type:`number`,id:`param-flat-amount`}),_jsx(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-2`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-2`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-5`,children:_jsx(_components.p,{children:`Per-unit amount for this tier in this currency.`})}),_jsx(ParamField,{body:`flat_amount`,type:`number`,id:`param-flat-amount-1`,children:_jsx(_components.p,{children:`Flat amount for this tier in this currency, if the tier uses one.`})})]})})]})]}),_jsx(ParamField,{body:`tier_behavior`,type:`'graduated' | 'volume'`,id:`param-tier-behavior`,children:_jsx(_components.p,{children:`How tiers price usage. ‘graduated’ (default) charges each unit at the rate of the tier it falls in. ‘volume’ picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier’s rate plus its flat_amount.`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-2`,children:_jsx(_components.p,{children:`Billing interval for this price. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-2`,children:_jsx(_components.p,{children:`Number of intervals per billing cycle. Defaults to 1.`})}),_jsx(ParamField,{body:`billing_units`,type:`number`,required:true,id:`param-billing-units`,children:_jsx(_components.p,{children:`Number of units per price increment. Usage is rounded UP to the nearest billing_units when billed (e.g. billing_units=100 means 101 usage rounds to 200).`})}),_jsx(ParamField,{body:`billing_method`,type:`'prepaid' | 'usage_based'`,required:true,id:`param-billing-method`,children:_jsx(_components.p,{children:`‘prepaid’ for features like seats where customers pay upfront, ‘usage_based’ for pay-as-you-go after included usage.`})}),_jsx(ParamField,{body:`max_purchase`,type:`number | null`,required:true,id:`param-max-purchase`,children:_jsx(_components.p,{children:`Maximum units a customer can purchase beyond included. E.g. if included=100 and max_purchase=300, customer can use up to 400 total before usage is capped. Null for no limit.`})}),_jsxs(ParamField,{body:`processors`,type:`object`,id:`param-processors-1`,children:[_jsx(_components.p,{children:`Payment processors this item price is connected to. Omitted when unset.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`stripe`,type:`object | null`,id:`param-stripe-1`,children:_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`price_id`,type:`string`,required:true,id:`param-price-id-1`,children:_jsx(_components.p,{children:`Stripe price ID. For prepaid with included > 0 this is the V2 price.`})})})})})]})]})]}),_jsxs(ParamField,{body:`display`,type:`object`,id:`param-display-2`,children:[_jsx(_components.p,{children:`Display text for showing this item in pricing pages.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`primary_text`,type:`string`,required:true,id:`param-primary-text-1`,children:_jsx(_components.p,{children:`Main display text (e.g. ‘$10’ or ‘100 messages’).`})}),_jsx(ParamField,{body:`secondary_text`,type:`string`,id:`param-secondary-text-1`,children:_jsx(_components.p,{children:`Secondary display text (e.g. ‘per month’ or ‘then $0.5 per 100’).`})})]})]}),_jsxs(ParamField,{body:`rollover`,type:`object`,id:`param-rollover`,children:[_jsx(_components.p,{children:`Rollover configuration for unused units. If set, unused included units roll over to the next period.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`max`,type:`number | null`,required:true,id:`param-max`,children:_jsx(_components.p,{children:`Maximum rollover units. Null for unlimited rollover.`})}),_jsx(ParamField,{body:`max_percentage`,type:`number | null`,id:`param-max-percentage`,children:_jsx(_components.p,{children:`Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.`})}),_jsx(ParamField,{body:`expiry_duration_type`,type:`'month' | 'forever'`,required:true,id:`param-expiry-duration-type`,children:_jsx(_components.p,{children:`When rolled over units expire.`})}),_jsx(ParamField,{body:`expiry_duration_length`,type:`number`,id:`param-expiry-duration-length`,children:_jsx(_components.p,{children:`Number of periods before expiry.`})})]})]}),_jsxs(ParamField,{body:`expiry`,type:`object | null`,id:`param-expiry`,children:[_jsx(_components.p,{children:`Purchased units expire this long after each purchase. One-off prepaid consumable items only.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`duration`,type:`'day' | 'week' | 'month' | 'year'`,required:true,id:`param-duration`}),_jsx(ParamField,{body:`length`,type:`number`,required:true,id:`param-length`})]})]}),_jsxs(ParamField,{body:`feature_override`,type:`object`,id:`param-feature-override`,children:[_jsx(_components.p,{children:`Overrides fields of this item’s feature for customers on this plan (e.g. a credit system’s credit_schema).`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`credit_schema`,type:`object | object | object[]`,id:`param-credit-schema-1`,children:[_jsxs(_components.p,{children:[`For credit system features: merges into the feature’s credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `,_jsx(_components.code,{children:`excluded: true`}),` removes it, and unlisted features keep the credit system’s rate.`]}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`metered_feature_id`,type:`string`,id:`param-metered-feature-id-1`,children:_jsx(_components.p,{children:`ID of the metered feature that draws from this credit system.`})}),_jsx(ParamField,{body:`billing_units`,type:`number`,id:`param-billing-units-1`,children:_jsx(_components.p,{children:`Number of metered-feature units priced together. Defaults to one when omitted.`})}),_jsxs(ParamField,{body:`dimensions.{key}`,type:`object`,id:`param-dimensions-key`,children:[_jsx(_components.p,{children:`Named rates chosen by event properties. The most specific match sets the rate; with no match the item’s own rate applies.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`match.{key}`,type:`string`,required:true,id:`param-match-key`,children:_jsx(_components.p,{children:`Event properties this entry applies to. Every key must equal the tracked property, compared as strings.`})}),_jsx(ParamField,{body:`priority`,type:`integer`,id:`param-priority`,children:_jsx(_components.p,{children:`Breaks ties between dimensions that match the same number of keys. Higher wins.`})}),_jsx(ParamField,{body:`tier_behavior`,type:`string`,required:true,id:`param-tier-behavior-1`}),_jsx(ParamField,{body:`tiers`,type:`object[]`,required:true,id:`param-tiers-1`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-1`,children:_jsx(_components.p,{children:`Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-1`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group within this tier.`})})]})})]})]}),_jsxs(ParamField,{body:`multipliers.{key}`,type:`object`,id:`param-multipliers-key`,children:[_jsx(_components.p,{children:`Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`match.{key}`,type:`string`,required:true,id:`param-match-key-1`,children:_jsx(_components.p,{children:`Event properties this entry applies to. Every key must equal the tracked property, compared as strings.`})}),_jsx(ParamField,{body:`factor`,type:`number`,id:`param-factor`,children:_jsx(_components.p,{children:`Multiplies the matched rate. All matching multipliers stack.`})}),_jsx(ParamField,{body:`add`,type:`number`,id:`param-add`,children:_jsx(_components.p,{children:`Added to the rate after every factor is applied, in credits per billing-unit group.`})})]})]}),_jsx(ParamField,{body:`tier_behavior`,type:`string`,id:`param-tier-behavior-2`}),_jsx(ParamField,{body:`tiers`,type:`object[]`,id:`param-tiers-2`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-2`,children:_jsx(_components.p,{children:`Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-2`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group within this tier.`})})]})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,id:`param-credit-cost-3`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group.`})}),_jsx(ParamField,{body:`excluded`,type:`true`,id:`param-excluded`,children:_jsx(_components.p,{children:`Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.`})})]})]}),_jsxs(ParamField,{body:`markups`,type:`object`,id:`param-markups`,children:[_jsx(_components.p,{children:`For AI credit system features: replaces the feature’s markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature’s.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`default_markup`,type:`number`,id:`param-default-markup`,children:_jsx(_components.p,{children:`Default percentage markup for customers on this plan. Use -100 to make usage free.`})}),_jsxs(ParamField,{body:`provider_markups.{key}`,type:`object | null`,id:`param-provider-markups-key`,children:[_jsx(_components.p,{children:`Per-provider markup percentages for customers on this plan.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`markup`,type:`number`,required:true,id:`param-markup`})})]}),_jsxs(ParamField,{body:`model_markups.{key}`,type:`object | null`,id:`param-model-markups-key`,children:[_jsx(_components.p,{children:`Per-model markup overrides for customers on this plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`markup`,type:`number`,id:`param-markup-1`}),_jsx(ParamField,{body:`input_cost`,type:`number`,id:`param-input-cost`}),_jsx(ParamField,{body:`output_cost`,type:`number`,id:`param-output-cost`})]})]})]})]})]})]})]})]}),_jsxs(ParamField,{body:`processors`,type:`object`,id:`param-processors-2`,children:[_jsx(_components.p,{children:`Payment processors this plan is connected to. Omitted when unset.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`stripe`,type:`object | null`,id:`param-stripe-2`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`product_id`,type:`string`,required:true,id:`param-product-id`,children:_jsx(_components.p,{children:`Stripe product ID this plan is billed under.`})}),_jsx(ParamField,{body:`additional_product_ids`,type:`string[]`,id:`param-additional-product-ids`,children:_jsx(_components.p,{children:`Extra Stripe product IDs aliased to this plan.`})})]})}),_jsx(ParamField,{body:`revenuecat`,type:`object | null`,id:`param-revenuecat`,children:_jsx(Expandable,{title:`properties`,children:_jsxs(ParamField,{body:`products`,type:`object[]`,required:true,id:`param-products`,children:[_jsx(_components.p,{children:`Every RevenueCat product that maps to this plan. Replaces the current set.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`product_id`,type:`string`,required:true,id:`param-product-id-1`,children:_jsx(_components.p,{children:`RevenueCat product ID that grants this plan when purchased.`})}),_jsxs(ParamField,{body:`feature_quantities`,type:`object[]`,id:`param-feature-quantities`,children:[_jsx(_components.p,{children:`Prepaid quantities granted when this specific RevenueCat product is purchased, in feature units.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-1`}),_jsx(ParamField,{body:`quantity`,type:`number`,id:`param-quantity`})]})]})]})]})})})]})]}),_jsxs(ParamField,{body:`free_trial`,type:`object`,id:`param-free-trial`,children:[_jsx(_components.p,{children:`Free trial configuration. If set, new customers can try this plan before being charged.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`duration_length`,type:`number`,required:true,id:`param-duration-length`,children:_jsx(_components.p,{children:`Number of duration_type periods the trial lasts.`})}),_jsx(ParamField,{body:`duration_type`,type:`'day' | 'month' | 'year'`,required:true,id:`param-duration-type`,children:_jsx(_components.p,{children:`Unit of time for the trial duration (‘day’, ‘month’, ‘year’).`})}),_jsx(ParamField,{body:`card_required`,type:`boolean`,required:true,id:`param-card-required`,children:_jsx(_components.p,{children:`Whether a payment method is required to start the trial. If true, customer will be charged after trial ends.`})}),_jsx(ParamField,{body:`on_end`,type:`'bill' | 'revert'`,id:`param-on-end`,children:_jsx(_components.p,{children:`Behavior when the trial ends. ‘bill’ charges the customer (default). ‘revert’ expires the trial and restores the customer’s previous plan.`})})]})]}),_jsx(ParamField,{body:`created_at`,type:`number`,required:true,id:`param-created-at`,children:_jsx(_components.p,{children:`Unix timestamp (ms) when the plan was created.`})}),_jsx(ParamField,{body:`env`,type:`'sandbox' | 'live'`,required:true,id:`param-env`,children:_jsx(_components.p,{children:`Environment this plan belongs to (‘sandbox’ or ‘live’).`})}),_jsx(ParamField,{body:`archived`,type:`boolean`,required:true,id:`param-archived-1`,children:_jsx(_components.p,{children:`Whether the plan is archived. Archived plans cannot be attached to new customers.`})}),_jsxs(ParamField,{body:`config`,type:`object`,required:true,id:`param-config`,children:[_jsx(_components.p,{children:`Miscellaneous plan-level configuration flags.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`ignore_past_due`,type:`boolean`,required:true,id:`param-ignore-past-due`,children:_jsx(_components.p,{children:`If true, entitlements attached to this plan will still reset on schedule even when the customer’s product is in a past_due state.`})}),_jsx(ParamField,{body:`anchor_to_month_start`,type:`boolean`,id:`param-anchor-to-month-start`})]})]}),_jsxs(ParamField,{body:`billing_controls`,type:`object`,id:`param-billing-controls`,children:[_jsx(_components.p,{children:`Plan-level billing controls used as customer defaults.`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`auto_topups`,type:`object[]`,id:`param-auto-topups`,children:[_jsx(_components.p,{children:`List of auto top-up configurations per feature.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-2`,children:_jsx(_components.p,{children:`The ID of the feature (credit balance) to auto top-up.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled`,children:_jsx(_components.p,{children:`Whether auto top-up is enabled.`})}),_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-1`,children:_jsx(_components.p,{children:`When the balance drops below this threshold, an auto top-up will be purchased.`})}),_jsx(ParamField,{body:`quantity`,type:`number`,required:true,id:`param-quantity-1`,children:_jsx(_components.p,{children:`Amount of credits to add per auto top-up.`})}),_jsxs(ParamField,{body:`purchase_limit`,type:`object`,id:`param-purchase-limit`,children:[_jsx(_components.p,{children:`Optional limit on auto top-ups per window, by number of top-ups or amount charged.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`limit_type`,type:`'count' | 'amount'`,id:`param-limit-type`,children:_jsxs(_components.p,{children:[`What `,_jsx(_components.code,{children:`limit`}),` caps: the number of auto top-ups (`,_jsx(_components.code,{children:`count`}),`, default) or the total amount charged for them, in the customer’s currency (`,_jsx(_components.code,{children:`amount`}),`).`]})}),_jsx(ParamField,{body:`interval`,type:`'hour' | 'day' | 'week' | 'month'`,required:true,id:`param-interval-3`,children:_jsx(_components.p,{children:`The time interval for the purchase limit window.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,required:true,id:`param-interval-count-3`,children:_jsx(_components.p,{children:`Number of intervals in the purchase limit window.`})}),_jsx(ParamField,{body:`limit`,type:`number`,required:true,id:`param-limit`,children:_jsx(_components.p,{children:`Maximum allowed within the interval: a number of auto top-ups when limit_type is count, or a total charge (e.g. 500 for $500, pre-tax) when limit_type is amount.`})})]})]}),_jsx(ParamField,{body:`invoice_mode`,type:`boolean`,id:`param-invoice-mode`,children:_jsx(_components.p,{children:`When true, auto top-up creates a send_invoice invoice instead of auto-charging.`})})]})]}),_jsxs(ParamField,{body:`spend_limits`,type:`object[]`,id:`param-spend-limits`,children:[_jsx(_components.p,{children:`List of overage spend limits per feature (caps overage spend).`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,id:`param-feature-id-3`,children:_jsx(_components.p,{children:`Optional feature ID this spend limit applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-1`,children:_jsx(_components.p,{children:`Whether the overage spend limit is enabled.`})}),_jsx(ParamField,{body:`limit_type`,type:`'absolute' | 'usage_percentage'`,id:`param-limit-type-1`,children:_jsx(_components.p,{children:`How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.`})}),_jsx(ParamField,{body:`overage_limit`,type:`number`,id:`param-overage-limit`,children:_jsx(_components.p,{children:`Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.`})}),_jsx(ParamField,{body:`skip_overage_billing`,type:`boolean`,id:`param-skip-overage-billing`,children:_jsx(_components.p,{children:`When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.`})})]})]}),_jsxs(ParamField,{body:`usage_limits`,type:`object[]`,id:`param-usage-limits`,children:[_jsx(_components.p,{children:`List of hard usage caps per feature (max units per interval).`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-4`,children:_jsx(_components.p,{children:`The feature this usage limit applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-2`,children:_jsx(_components.p,{children:`Whether this usage limit is enabled.`})}),_jsx(ParamField,{body:`limit`,type:`number`,required:true,id:`param-limit-1`,children:_jsx(_components.p,{children:`Maximum units allowed per interval.`})}),_jsx(ParamField,{body:`interval`,type:`'day' | 'week' | 'month' | 'year'`,required:true,id:`param-interval-4`,children:_jsx(_components.p,{children:`Interval for the cap, aligned to the customer’s billing cycle.`})}),_jsx(ParamField,{body:`anchor`,type:`'billing_cycle' | 'utc'`,id:`param-anchor`,children:_jsx(_components.p,{children:`Window alignment. ‘billing_cycle’ phases the interval to the customer’s renewal time; ‘utc’ aligns to the UTC calendar.`})}),_jsxs(ParamField,{body:`filter`,type:`object`,id:`param-filter`,children:[_jsx(_components.p,{children:`When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`properties.{key}`,type:`string`,required:true,id:`param-properties-key`})})]})]})]}),_jsxs(ParamField,{body:`usage_alerts`,type:`object[]`,id:`param-usage-alerts`,children:[_jsx(_components.p,{children:`List of usage alert configurations per feature.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,id:`param-feature-id-5`,children:_jsx(_components.p,{children:`The feature ID this alert applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-3`,children:_jsx(_components.p,{children:`Whether this usage alert is enabled.`})}),_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-2`,children:_jsx(_components.p,{children:`The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage. remaining and remaining_percentage accept negative values with basis balance, to alert once the balance is overdrawn.`})}),_jsx(ParamField,{body:`threshold_type`,type:`'usage' | 'usage_percentage' | 'remaining' | 'remaining_percentage'`,required:true,id:`param-threshold-type`,children:_jsx(_components.p,{children:`Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.`})}),_jsx(ParamField,{body:`basis`,type:`'balance' | 'included' | 'recurring' | 'usage_limit'`,required:true,id:`param-basis`,children:_jsx(_components.p,{children:`What 100% means. balance: every grant on the feature. included: the plan allowance only. recurring: grants that reset. usage_limit: the cap of the usage limit with the same feature and filter.`})}),_jsxs(ParamField,{body:`filter`,type:`object`,id:`param-filter-1`,children:[_jsx(_components.p,{children:`Only valid with basis usage_limit. Points the alert at the usage limit carrying the same filter.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`properties.{key}`,type:`string`,required:true,id:`param-properties-key-1`})})]}),_jsx(ParamField,{body:`name`,type:`string`,id:`param-name-2`,children:_jsx(_components.p,{children:`Optional user-defined label to distinguish multiple alerts on the same feature.`})})]})]}),_jsxs(ParamField,{body:`overage_allowed`,type:`object[]`,id:`param-overage-allowed`,children:[_jsx(_components.p,{children:`List of overage allowed controls per feature. When enabled, usage can exceed balance.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-6`,children:_jsx(_components.p,{children:`The feature ID this overage allowed control applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-4`,children:_jsx(_components.p,{children:`Whether overage is allowed for this feature.`})})]})]})]})]}),_jsx(ParamField,{body:`metadata`,type:`object`,required:true,id:`param-metadata`,children:_jsx(_components.p,{children:`Arbitrary key-value metadata defined by you for your own use. Shared across all versions of the plan.`})}),_jsx(ParamField,{body:`customer_eligibility`,type:`object`,id:`param-customer-eligibility`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`trial_available`,type:`boolean`,id:`param-trial-available`,children:_jsx(_components.p,{children:`Whether the trial on this plan is available to this customer. For example, if the customer used the trial in the past, this will be false.`})}),_jsx(ParamField,{body:`status`,type:`'active' | 'scheduled'`,id:`param-status-3`,children:_jsx(_components.p,{children:`The customer’s current status with this plan. ‘active’ if attached, ‘scheduled’ if pending activation.`})}),_jsx(ParamField,{body:`canceling`,type:`boolean`,id:`param-canceling`,children:_jsx(_components.p,{children:`Whether the customer’s active instance of this plan is set to cancel.`})}),_jsx(ParamField,{body:`trialing`,type:`boolean`,id:`param-trialing`,children:_jsx(_components.p,{children:`Whether the customer is currently on a free trial of this plan.`})}),_jsx(ParamField,{body:`attach_action`,type:`'activate' | 'upgrade' | 'downgrade' | 'none' | 'purchase'`,required:true,id:`param-attach-action`,children:_jsx(_components.p,{children:`The action that would occur if this plan were attached to the customer.`})})]})}),_jsx(ParamField,{body:`base_variant_id`,type:`string | null`,required:true,id:`param-base-variant-id`,children:_jsx(_components.p,{children:`Deprecated. Use variant_details.base_plan_id instead. If this is a variant, the ID of the base plan it was created from.`})}),_jsxs(ParamField,{body:`variant_details`,type:`object`,id:`param-variant-details`,children:[_jsx(_components.p,{children:`Details about how this variant relates to its latest base plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`base_plan_id`,type:`string`,required:true,id:`param-base-plan-id`,children:_jsx(_components.p,{children:`The ID of the base plan this variant was derived from.`})}),_jsxs(ParamField,{body:`customize`,type:`object`,id:`param-customize`,children:[_jsx(_components.p,{children:`The customization that transforms the base plan into this variant.`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`price`,type:`object | null`,id:`param-price-2`,children:[_jsx(_components.p,{children:`Base price configuration for a plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-6`,children:_jsx(_components.p,{children:`Base price amount for the plan, in major currency units (e.g. dollars).`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-5`,children:_jsx(_components.p,{children:`Billing interval (e.g. ‘month’, ‘year’).`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-4`}),_jsxs(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-3`,children:[_jsx(_components.p,{children:`Base price amounts in additional currencies. The base ‘amount’ is in the org’s default currency.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-3`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-7`,children:_jsx(_components.p,{children:`Price amount in this currency. Set explicitly per currency, not converted from the base amount.`})})]})]})]})]}),_jsxs(ParamField,{body:`add_items`,type:`object[]`,id:`param-add-items`,children:[_jsx(_components.p,{children:`Items to add to the plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`threshold_billing`,type:`object | null`,id:`param-threshold-billing-1`,children:[_jsx(_components.p,{children:`Bills this many feature units when outstanding overage reaches it.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-3`})})]}),_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-7`,children:_jsx(_components.p,{children:`The ID of the feature to configure.`})}),_jsx(ParamField,{body:`included`,type:`number`,id:`param-included-1`,children:_jsx(_components.p,{children:`Number of free units included. Balance resets to this each interval for consumable features.`})}),_jsx(ParamField,{body:`unlimited`,type:`boolean`,id:`param-unlimited-1`,children:_jsx(_components.p,{children:`If true, customer has unlimited access to this feature.`})}),_jsx(ParamField,{body:`pooled`,type:`boolean`,id:`param-pooled-1`,children:_jsx(_components.p,{children:`Whether entity-level grants contribute to a shared customer balance.`})}),_jsxs(ParamField,{body:`reset`,type:`object`,id:`param-reset-1`,children:[_jsx(_components.p,{children:`Reset configuration for consumable features. Omit for non-consumable features like seats.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`interval`,type:`'one_off' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-6`,children:_jsx(_components.p,{children:`Interval at which balance resets (e.g. ‘month’, ‘year’). For consumable features only.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-5`})]})]}),_jsxs(ParamField,{body:`price`,type:`object`,id:`param-price-3`,children:[_jsx(_components.p,{children:`Pricing for usage beyond included units. Omit for free features.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-8`,children:_jsx(_components.p,{children:`Price per billing_units after included usage. Either ‘amount’ or ‘tiers’ is required.`})}),_jsxs(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-4`,children:[_jsx(_components.p,{children:`Amounts in additional currencies for this flat price. The base ‘amount’ is in the org’s default currency. Only valid with ‘amount’, not ‘tiers’.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-4`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-9`,children:_jsx(_components.p,{children:`Price amount in this currency. Set explicitly per currency, not converted from the base amount.`})})]})]}),_jsxs(ParamField,{body:`tiers`,type:`object[]`,id:`param-tiers-3`,children:[_jsx(_components.p,{children:`Tiered pricing. Either ‘amount’ or ‘tiers’ is required.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-3`}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-10`}),_jsx(ParamField,{body:`flat_amount`,type:`number`,id:`param-flat-amount-2`}),_jsx(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-5`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-5`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-11`,children:_jsx(_components.p,{children:`Per-unit amount for this tier in this currency.`})}),_jsx(ParamField,{body:`flat_amount`,type:`number`,id:`param-flat-amount-3`,children:_jsx(_components.p,{children:`Flat amount for this tier in this currency, if the tier uses one.`})})]})})]})]}),_jsx(ParamField,{body:`tier_behavior`,type:`'graduated' | 'volume'`,id:`param-tier-behavior-3`,children:_jsx(_components.p,{children:`How tiers price usage. ‘graduated’ (default) charges each unit at the rate of the tier it falls in. ‘volume’ picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier’s rate plus its flat_amount.`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-7`,children:_jsx(_components.p,{children:`Billing interval. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-6`,children:_jsx(_components.p,{children:`Number of intervals per billing cycle. Defaults to 1.`})}),_jsx(ParamField,{body:`billing_units`,type:`number`,id:`param-billing-units-2`,children:_jsx(_components.p,{children:`Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).`})}),_jsx(ParamField,{body:`billing_method`,type:`'prepaid' | 'usage_based'`,required:true,id:`param-billing-method-1`,children:_jsx(_components.p,{children:`‘prepaid’ for upfront payment (seats), ‘usage_based’ for pay-as-you-go.`})}),_jsx(ParamField,{body:`max_purchase`,type:`number | null`,id:`param-max-purchase-1`,children:_jsx(_components.p,{children:`Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.`})})]})]}),_jsxs(ParamField,{body:`proration`,type:`object`,id:`param-proration`,children:[_jsx(_components.p,{children:`Proration settings for prepaid features. Controls mid-cycle quantity change billing.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`on_increase`,type:`'bill_immediately' | 'prorate_immediately' | 'prorate_next_cycle' | 'bill_next_cycle'`,required:true,id:`param-on-increase`,children:_jsx(_components.p,{children:`Billing behavior when quantity increases mid-cycle.`})}),_jsx(ParamField,{body:`on_decrease`,type:`'prorate' | 'prorate_immediately' | 'prorate_next_cycle' | 'none' | 'no_prorations'`,required:true,id:`param-on-decrease`,children:_jsx(_components.p,{children:`Credit behavior when quantity decreases mid-cycle.`})})]})]}),_jsxs(ParamField,{body:`rollover`,type:`object`,id:`param-rollover-1`,children:[_jsx(_components.p,{children:`Rollover config for unused units. If set, unused included units carry over.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`max`,type:`number`,id:`param-max-1`,children:_jsx(_components.p,{children:`Max rollover units. Omit for unlimited rollover.`})}),_jsx(ParamField,{body:`max_percentage`,type:`number`,id:`param-max-percentage-1`,children:_jsx(_components.p,{children:`Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.`})}),_jsx(ParamField,{body:`expiry_duration_type`,type:`'month' | 'forever'`,required:true,id:`param-expiry-duration-type-1`,children:_jsx(_components.p,{children:`When rolled over units expire.`})}),_jsx(ParamField,{body:`expiry_duration_length`,type:`number`,id:`param-expiry-duration-length-1`,children:_jsx(_components.p,{children:`Number of periods before expiry.`})})]})]}),_jsxs(ParamField,{body:`expiry`,type:`object`,id:`param-expiry-1`,children:[_jsx(_components.p,{children:`Purchased units expire this long after each purchase. One-off prepaid consumable items only.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`duration`,type:`'day' | 'week' | 'month' | 'year'`,required:true,id:`param-duration-1`}),_jsx(ParamField,{body:`length`,type:`number`,required:true,id:`param-length-1`})]})]}),_jsxs(ParamField,{body:`feature_override`,type:`object`,id:`param-feature-override-1`,children:[_jsx(_components.p,{children:`Overrides fields of this item’s feature for customers on this plan (e.g. a credit system’s credit_schema).`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`credit_schema`,type:`object | object | object[]`,id:`param-credit-schema-2`,children:[_jsxs(_components.p,{children:[`For credit system features: merges into the feature’s credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `,_jsx(_components.code,{children:`excluded: true`}),` removes it, and unlisted features keep the credit system’s rate.`]}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`metered_feature_id`,type:`string`,id:`param-metered-feature-id-2`,children:_jsx(_components.p,{children:`ID of the metered feature that draws from this credit system.`})}),_jsx(ParamField,{body:`billing_units`,type:`number`,id:`param-billing-units-3`,children:_jsx(_components.p,{children:`Number of metered-feature units priced together. Defaults to one when omitted.`})}),_jsxs(ParamField,{body:`dimensions.{key}`,type:`object`,id:`param-dimensions-key-1`,children:[_jsx(_components.p,{children:`Named rates chosen by event properties. The most specific match sets the rate; with no match the item’s own rate applies.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`match.{key}`,type:`string`,required:true,id:`param-match-key-2`,children:_jsx(_components.p,{children:`Event properties this entry applies to. Every key must equal the tracked property, compared as strings.`})}),_jsx(ParamField,{body:`priority`,type:`integer`,id:`param-priority-1`,children:_jsx(_components.p,{children:`Breaks ties between dimensions that match the same number of keys. Higher wins.`})}),_jsx(ParamField,{body:`tier_behavior`,type:`string`,required:true,id:`param-tier-behavior-4`}),_jsx(ParamField,{body:`tiers`,type:`object[]`,required:true,id:`param-tiers-4`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-4`,children:_jsx(_components.p,{children:`Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-4`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group within this tier.`})})]})})]})]}),_jsxs(ParamField,{body:`multipliers.{key}`,type:`object`,id:`param-multipliers-key-1`,children:[_jsx(_components.p,{children:`Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`match.{key}`,type:`string`,required:true,id:`param-match-key-3`,children:_jsx(_components.p,{children:`Event properties this entry applies to. Every key must equal the tracked property, compared as strings.`})}),_jsx(ParamField,{body:`factor`,type:`number`,id:`param-factor-1`,children:_jsx(_components.p,{children:`Multiplies the matched rate. All matching multipliers stack.`})}),_jsx(ParamField,{body:`add`,type:`number`,id:`param-add-1`,children:_jsx(_components.p,{children:`Added to the rate after every factor is applied, in credits per billing-unit group.`})})]})]}),_jsx(ParamField,{body:`tier_behavior`,type:`string`,id:`param-tier-behavior-5`}),_jsx(ParamField,{body:`tiers`,type:`object[]`,id:`param-tiers-5`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-5`,children:_jsx(_components.p,{children:`Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-5`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group within this tier.`})})]})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,id:`param-credit-cost-6`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group.`})}),_jsx(ParamField,{body:`excluded`,type:`true`,id:`param-excluded-1`,children:_jsx(_components.p,{children:`Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.`})})]})]}),_jsxs(ParamField,{body:`markups`,type:`object`,id:`param-markups-1`,children:[_jsx(_components.p,{children:`For AI credit system features: replaces the feature’s markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature’s.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`default_markup`,type:`number`,id:`param-default-markup-1`,children:_jsx(_components.p,{children:`Default percentage markup for customers on this plan. Use -100 to make usage free.`})}),_jsxs(ParamField,{body:`provider_markups.{key}`,type:`object | null`,id:`param-provider-markups-key-1`,children:[_jsx(_components.p,{children:`Per-provider markup percentages for customers on this plan.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`markup`,type:`number`,required:true,id:`param-markup-2`})})]}),_jsxs(ParamField,{body:`model_markups.{key}`,type:`object | null`,id:`param-model-markups-key-1`,children:[_jsx(_components.p,{children:`Per-model markup overrides for customers on this plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`markup`,type:`number`,id:`param-markup-3`}),_jsx(ParamField,{body:`input_cost`,type:`number`,id:`param-input-cost-1`}),_jsx(ParamField,{body:`output_cost`,type:`number`,id:`param-output-cost-1`})]})]})]})]})]})]})]})]}),_jsxs(ParamField,{body:`remove_items`,type:`object[]`,id:`param-remove-items`,children:[_jsx(_components.p,{children:`Filters selecting items to remove from the plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,id:`param-feature-id-8`,children:_jsx(_components.p,{children:`Match items linked to this feature.`})}),_jsx(ParamField,{body:`billing_method`,type:`'prepaid' | 'usage_based'`,id:`param-billing-method-2`,children:_jsx(_components.p,{children:`Match items with this billing method (prepaid or usage_based).`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,id:`param-interval-8`,children:_jsx(_components.p,{children:`Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.`})}),_jsx(ParamField,{body:`interval_count`,type:`integer`,id:`param-interval-count-7`,children:_jsx(_components.p,{children:`Match items with this interval_count. Disambiguates between items that share an interval but differ in count.`})}),_jsx(ParamField,{body:`included`,type:`number`,id:`param-included-2`,children:_jsx(_components.p,{children:`Match items whose grant equals this included usage. Omitted is a wildcard.`})})]})]}),_jsxs(ParamField,{body:`free_trial`,type:`object | null`,id:`param-free-trial-1`,children:[_jsx(_components.p,{children:`Free trial configuration for a plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`duration_length`,type:`number`,required:true,id:`param-duration-length-1`,children:_jsx(_components.p,{children:`Number of duration_type periods the trial lasts.`})}),_jsx(ParamField,{body:`duration_type`,type:`'day' | 'month' | 'year'`,required:true,id:`param-duration-type-1`,children:_jsx(_components.p,{children:`Unit of time for the trial (‘day’, ‘month’, ‘year’).`})}),_jsx(ParamField,{body:`card_required`,type:`boolean`,required:true,id:`param-card-required-1`,children:_jsx(_components.p,{children:`If true, a payment method is required to start the trial and the customer is charged when it ends. Defaults to false.`})}),_jsx(ParamField,{body:`on_end`,type:`'bill' | 'revert'`,id:`param-on-end-1`})]})]}),_jsxs(ParamField,{body:`billing_controls`,type:`object`,id:`param-billing-controls-1`,children:[_jsx(_components.p,{children:`Override the plan’s billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`auto_topups`,type:`object[]`,id:`param-auto-topups-1`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-9`,children:_jsx(_components.p,{children:`The ID of the feature (credit balance) to auto top-up.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-5`,children:_jsx(_components.p,{children:`Whether auto top-up is enabled.`})}),_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-4`,children:_jsx(_components.p,{children:`When the balance drops below this threshold, an auto top-up will be purchased.`})}),_jsx(ParamField,{body:`quantity`,type:`number`,required:true,id:`param-quantity-2`,children:_jsx(_components.p,{children:`Amount of credits to add per auto top-up.`})}),_jsxs(ParamField,{body:`purchase_limit`,type:`object`,id:`param-purchase-limit-1`,children:[_jsx(_components.p,{children:`Optional rate limit to cap how often auto top-ups occur. Pass count or amount to set the current window’s consumed top-ups or charged amount.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`limit_type`,type:`'count' | 'amount'`,id:`param-limit-type-2`,children:_jsxs(_components.p,{children:[`What `,_jsx(_components.code,{children:`limit`}),` caps: the number of auto top-ups (`,_jsx(_components.code,{children:`count`}),`, default) or the total amount charged for them, in the customer’s currency (`,_jsx(_components.code,{children:`amount`}),`).`]})}),_jsx(ParamField,{body:`interval`,type:`'hour' | 'day' | 'week' | 'month'`,required:true,id:`param-interval-9`,children:_jsx(_components.p,{children:`The time interval for the purchase limit window.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,required:true,id:`param-interval-count-8`,children:_jsx(_components.p,{children:`Number of intervals in the purchase limit window.`})}),_jsx(ParamField,{body:`limit`,type:`number`,required:true,id:`param-limit-2`,children:_jsx(_components.p,{children:`Maximum allowed within the interval: a number of auto top-ups when limit_type is count, or a total charge (e.g. 500 for $500, pre-tax) when limit_type is amount.`})}),_jsx(ParamField,{body:`count`,type:`number`,id:`param-count`,children:_jsx(_components.p,{children:`Set the current window’s consumed auto top-up count. Omit to leave runtime state unchanged.`})}),_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-12`,children:_jsx(_components.p,{children:`Set the amount already charged by auto top-ups in the current window. Omit to leave runtime state unchanged.`})})]})]}),_jsx(ParamField,{body:`invoice_mode`,type:`boolean`,id:`param-invoice-mode-1`,children:_jsx(_components.p,{children:`When true, auto top-up creates a send_invoice invoice instead of auto-charging.`})})]})}),_jsx(ParamField,{body:`spend_limits`,type:`object[]`,id:`param-spend-limits-1`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,id:`param-feature-id-10`,children:_jsx(_components.p,{children:`Optional feature ID this spend limit applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-6`,children:_jsx(_components.p,{children:`Whether the overage spend limit is enabled.`})}),_jsx(ParamField,{body:`limit_type`,type:`'absolute' | 'usage_percentage'`,id:`param-limit-type-3`,children:_jsx(_components.p,{children:`How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.`})}),_jsx(ParamField,{body:`overage_limit`,type:`number`,id:`param-overage-limit-1`,children:_jsx(_components.p,{children:`Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.`})}),_jsx(ParamField,{body:`skip_overage_billing`,type:`boolean`,id:`param-skip-overage-billing-1`,children:_jsx(_components.p,{children:`When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.`})})]})}),_jsx(ParamField,{body:`usage_limits`,type:`object[]`,id:`param-usage-limits-1`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-11`,children:_jsx(_components.p,{children:`The feature this usage limit applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-7`,children:_jsx(_components.p,{children:`Whether this usage limit is enabled.`})}),_jsx(ParamField,{body:`limit`,type:`number`,required:true,id:`param-limit-3`,children:_jsx(_components.p,{children:`Maximum units allowed per interval.`})}),_jsx(ParamField,{body:`interval`,type:`'day' | 'week' | 'month' | 'year'`,required:true,id:`param-interval-10`,children:_jsx(_components.p,{children:`Interval for the cap, aligned to the customer’s billing cycle.`})}),_jsx(ParamField,{body:`anchor`,type:`'billing_cycle' | 'utc'`,id:`param-anchor-1`,children:_jsx(_components.p,{children:`Window alignment. ‘billing_cycle’ phases the interval to the customer’s renewal time; ‘utc’ aligns to the UTC calendar.`})}),_jsxs(ParamField,{body:`filter`,type:`object`,id:`param-filter-2`,children:[_jsx(_components.p,{children:`When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`properties.{key}`,type:`string`,required:true,id:`param-properties-key-2`})})]})]})}),_jsx(ParamField,{body:`usage_alerts`,type:`object[]`,id:`param-usage-alerts-1`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,id:`param-feature-id-12`,children:_jsx(_components.p,{children:`The feature ID this alert applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-8`,children:_jsx(_components.p,{children:`Whether this usage alert is enabled.`})}),_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-5`,children:_jsx(_components.p,{children:`The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage. remaining and remaining_percentage accept negative values with basis balance, to alert once the balance is overdrawn.`})}),_jsx(ParamField,{body:`threshold_type`,type:`'usage' | 'usage_percentage' | 'remaining' | 'remaining_percentage'`,required:true,id:`param-threshold-type-1`,children:_jsx(_components.p,{children:`Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.`})}),_jsx(ParamField,{body:`basis`,type:`'balance' | 'included' | 'recurring' | 'usage_limit'`,required:true,id:`param-basis-1`,children:_jsx(_components.p,{children:`What 100% means. balance: every grant on the feature. included: the plan allowance only. recurring: grants that reset. usage_limit: the cap of the usage limit with the same feature and filter.`})}),_jsxs(ParamField,{body:`filter`,type:`object`,id:`param-filter-3`,children:[_jsx(_components.p,{children:`Only valid with basis usage_limit. Points the alert at the usage limit carrying the same filter.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`properties.{key}`,type:`string`,required:true,id:`param-properties-key-3`})})]}),_jsx(ParamField,{body:`name`,type:`string`,id:`param-name-3`,children:_jsx(_components.p,{children:`Optional user-defined label to distinguish multiple alerts on the same feature.`})})]})}),_jsx(ParamField,{body:`overage_allowed`,type:`object[]`,id:`param-overage-allowed-1`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-13`,children:_jsx(_components.p,{children:`The feature ID this overage allowed control applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-9`,children:_jsx(_components.p,{children:`Whether overage is allowed for this feature.`})})]})})]})]}),_jsxs(ParamField,{body:`upsert_licenses`,type:`object[]`,id:`param-upsert-licenses`,children:[_jsx(_components.p,{children:`License links to add or override for this customer, keyed by license_plan_id. Omitted fields inherit the plan catalog link (included defaults to 1 when the license is not in the catalog). A bare entry restores the license to pure catalog inheritance.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`license_plan_id`,type:`string`,required:true,id:`param-license-plan-id`}),_jsx(ParamField,{body:`version_slug`,type:`string`,id:`param-version-slug-1`}),_jsx(ParamField,{body:`included`,type:`integer`,id:`param-included-3`}),_jsx(ParamField,{body:`prepaid_only`,type:`boolean`,id:`param-prepaid-only`}),_jsx(ParamField,{body:`customize`,type:`object | null`,id:`param-customize-1`,children:_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`price`,type:`object | null`,id:`param-price-4`,children:[_jsx(_components.p,{children:`Base price configuration for a plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-13`,children:_jsx(_components.p,{children:`Base price amount for the plan, in major currency units (e.g. dollars).`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-11`,children:_jsx(_components.p,{children:`Billing interval (e.g. ‘month’, ‘year’).`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-9`}),_jsxs(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-6`,children:[_jsx(_components.p,{children:`Base price amounts in additional currencies. The base ‘amount’ is in the org’s default currency.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-6`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-14`,children:_jsx(_components.p,{children:`Price amount in this currency. Set explicitly per currency, not converted from the base amount.`})})]})]})]})]}),_jsx(ParamField,{body:`add_items`,type:`object[]`,id:`param-add-items-1`,children:_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`threshold_billing`,type:`object | null`,id:`param-threshold-billing-2`,children:[_jsx(_components.p,{children:`Bills this many feature units when outstanding overage reaches it.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-6`})})]}),_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-14`,children:_jsx(_components.p,{children:`The ID of the feature to configure.`})}),_jsx(ParamField,{body:`included`,type:`number`,id:`param-included-4`,children:_jsx(_components.p,{children:`Number of free units included. Balance resets to this each interval for consumable features.`})}),_jsx(ParamField,{body:`unlimited`,type:`boolean`,id:`param-unlimited-2`,children:_jsx(_components.p,{children:`If true, customer has unlimited access to this feature.`})}),_jsx(ParamField,{body:`pooled`,type:`boolean`,id:`param-pooled-2`,children:_jsx(_components.p,{children:`Whether entity-level grants contribute to a shared customer balance.`})}),_jsxs(ParamField,{body:`reset`,type:`object`,id:`param-reset-2`,children:[_jsx(_components.p,{children:`Reset configuration for consumable features. Omit for non-consumable features like seats.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`interval`,type:`'one_off' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-12`,children:_jsx(_components.p,{children:`Interval at which balance resets (e.g. ‘month’, ‘year’). For consumable features only.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-10`})]})]}),_jsxs(ParamField,{body:`price`,type:`object`,id:`param-price-5`,children:[_jsx(_components.p,{children:`Pricing for usage beyond included units. Omit for free features.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-15`,children:_jsx(_components.p,{children:`Price per billing_units after included usage. Either ‘amount’ or ‘tiers’ is required.`})}),_jsxs(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-7`,children:[_jsx(_components.p,{children:`Amounts in additional currencies for this flat price. The base ‘amount’ is in the org’s default currency. Only valid with ‘amount’, not ‘tiers’.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-7`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-16`,children:_jsx(_components.p,{children:`Price amount in this currency. Set explicitly per currency, not converted from the base amount.`})})]})]}),_jsxs(ParamField,{body:`tiers`,type:`object[]`,id:`param-tiers-6`,children:[_jsx(_components.p,{children:`Tiered pricing. Either ‘amount’ or ‘tiers’ is required.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-6`}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-17`}),_jsx(ParamField,{body:`flat_amount`,type:`number`,id:`param-flat-amount-4`}),_jsx(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-8`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-8`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-18`,children:_jsx(_components.p,{children:`Per-unit amount for this tier in this currency.`})}),_jsx(ParamField,{body:`flat_amount`,type:`number`,id:`param-flat-amount-5`,children:_jsx(_components.p,{children:`Flat amount for this tier in this currency, if the tier uses one.`})})]})})]})]}),_jsx(ParamField,{body:`tier_behavior`,type:`'graduated' | 'volume'`,id:`param-tier-behavior-6`,children:_jsx(_components.p,{children:`How tiers price usage. ‘graduated’ (default) charges each unit at the rate of the tier it falls in. ‘volume’ picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier’s rate plus its flat_amount.`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-13`,children:_jsx(_components.p,{children:`Billing interval. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-11`,children:_jsx(_components.p,{children:`Number of intervals per billing cycle. Defaults to 1.`})}),_jsx(ParamField,{body:`billing_units`,type:`number`,id:`param-billing-units-4`,children:_jsx(_components.p,{children:`Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).`})}),_jsx(ParamField,{body:`billing_method`,type:`'prepaid' | 'usage_based'`,required:true,id:`param-billing-method-3`,children:_jsx(_components.p,{children:`‘prepaid’ for upfront payment (seats), ‘usage_based’ for pay-as-you-go.`})}),_jsx(ParamField,{body:`max_purchase`,type:`number | null`,id:`param-max-purchase-2`,children:_jsx(_components.p,{children:`Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.`})})]})]}),_jsxs(ParamField,{body:`proration`,type:`object`,id:`param-proration-1`,children:[_jsx(_components.p,{children:`Proration settings for prepaid features. Controls mid-cycle quantity change billing.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`on_increase`,type:`'bill_immediately' | 'prorate_immediately' | 'prorate_next_cycle' | 'bill_next_cycle'`,required:true,id:`param-on-increase-1`,children:_jsx(_components.p,{children:`Billing behavior when quantity increases mid-cycle.`})}),_jsx(ParamField,{body:`on_decrease`,type:`'prorate' | 'prorate_immediately' | 'prorate_next_cycle' | 'none' | 'no_prorations'`,required:true,id:`param-on-decrease-1`,children:_jsx(_components.p,{children:`Credit behavior when quantity decreases mid-cycle.`})})]})]}),_jsxs(ParamField,{body:`rollover`,type:`object`,id:`param-rollover-2`,children:[_jsx(_components.p,{children:`Rollover config for unused units. If set, unused included units carry over.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`max`,type:`number`,id:`param-max-2`,children:_jsx(_components.p,{children:`Max rollover units. Omit for unlimited rollover.`})}),_jsx(ParamField,{body:`max_percentage`,type:`number`,id:`param-max-percentage-2`,children:_jsx(_components.p,{children:`Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.`})}),_jsx(ParamField,{body:`expiry_duration_type`,type:`'month' | 'forever'`,required:true,id:`param-expiry-duration-type-2`,children:_jsx(_components.p,{children:`When rolled over units expire.`})}),_jsx(ParamField,{body:`expiry_duration_length`,type:`number`,id:`param-expiry-duration-length-2`,children:_jsx(_components.p,{children:`Number of periods before expiry.`})})]})]}),_jsxs(ParamField,{body:`expiry`,type:`object`,id:`param-expiry-2`,children:[_jsx(_components.p,{children:`Purchased units expire this long after each purchase. One-off prepaid consumable items only.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`duration`,type:`'day' | 'week' | 'month' | 'year'`,required:true,id:`param-duration-2`}),_jsx(ParamField,{body:`length`,type:`number`,required:true,id:`param-length-2`})]})]}),_jsxs(ParamField,{body:`feature_override`,type:`object`,id:`param-feature-override-2`,children:[_jsx(_components.p,{children:`Overrides fields of this item’s feature for customers on this plan (e.g. a credit system’s credit_schema).`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`credit_schema`,type:`object | object | object[]`,id:`param-credit-schema-3`,children:[_jsxs(_components.p,{children:[`For credit system features: merges into the feature’s credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `,_jsx(_components.code,{children:`excluded: true`}),` removes it, and unlisted features keep the credit system’s rate.`]}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`metered_feature_id`,type:`string`,id:`param-metered-feature-id-3`,children:_jsx(_components.p,{children:`ID of the metered feature that draws from this credit system.`})}),_jsx(ParamField,{body:`billing_units`,type:`number`,id:`param-billing-units-5`,children:_jsx(_components.p,{children:`Number of metered-feature units priced together. Defaults to one when omitted.`})}),_jsxs(ParamField,{body:`dimensions.{key}`,type:`object`,id:`param-dimensions-key-2`,children:[_jsx(_components.p,{children:`Named rates chosen by event properties. The most specific match sets the rate; with no match the item’s own rate applies.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`match.{key}`,type:`string`,required:true,id:`param-match-key-4`,children:_jsx(_components.p,{children:`Event properties this entry applies to. Every key must equal the tracked property, compared as strings.`})}),_jsx(ParamField,{body:`priority`,type:`integer`,id:`param-priority-2`,children:_jsx(_components.p,{children:`Breaks ties between dimensions that match the same number of keys. Higher wins.`})}),_jsx(ParamField,{body:`tier_behavior`,type:`string`,required:true,id:`param-tier-behavior-7`}),_jsx(ParamField,{body:`tiers`,type:`object[]`,required:true,id:`param-tiers-7`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-7`,children:_jsx(_components.p,{children:`Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-7`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group within this tier.`})})]})})]})]}),_jsxs(ParamField,{body:`multipliers.{key}`,type:`object`,id:`param-multipliers-key-2`,children:[_jsx(_components.p,{children:`Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`match.{key}`,type:`string`,required:true,id:`param-match-key-5`,children:_jsx(_components.p,{children:`Event properties this entry applies to. Every key must equal the tracked property, compared as strings.`})}),_jsx(ParamField,{body:`factor`,type:`number`,id:`param-factor-2`,children:_jsx(_components.p,{children:`Multiplies the matched rate. All matching multipliers stack.`})}),_jsx(ParamField,{body:`add`,type:`number`,id:`param-add-2`,children:_jsx(_components.p,{children:`Added to the rate after every factor is applied, in credits per billing-unit group.`})})]})]}),_jsx(ParamField,{body:`tier_behavior`,type:`string`,id:`param-tier-behavior-8`}),_jsx(ParamField,{body:`tiers`,type:`object[]`,id:`param-tiers-8`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-8`,children:_jsx(_components.p,{children:`Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-8`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group within this tier.`})})]})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,id:`param-credit-cost-9`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group.`})}),_jsx(ParamField,{body:`excluded`,type:`true`,id:`param-excluded-2`,children:_jsx(_components.p,{children:`Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.`})})]})]}),_jsxs(ParamField,{body:`markups`,type:`object`,id:`param-markups-2`,children:[_jsx(_components.p,{children:`For AI credit system features: replaces the feature’s markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature’s.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`default_markup`,type:`number`,id:`param-default-markup-2`,children:_jsx(_components.p,{children:`Default percentage markup for customers on this plan. Use -100 to make usage free.`})}),_jsxs(ParamField,{body:`provider_markups.{key}`,type:`object | null`,id:`param-provider-markups-key-2`,children:[_jsx(_components.p,{children:`Per-provider markup percentages for customers on this plan.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`markup`,type:`number`,required:true,id:`param-markup-4`})})]}),_jsxs(ParamField,{body:`model_markups.{key}`,type:`object | null`,id:`param-model-markups-key-2`,children:[_jsx(_components.p,{children:`Per-model markup overrides for customers on this plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`markup`,type:`number`,id:`param-markup-5`}),_jsx(ParamField,{body:`input_cost`,type:`number`,id:`param-input-cost-2`}),_jsx(ParamField,{body:`output_cost`,type:`number`,id:`param-output-cost-2`})]})]})]})]})]})]})]})}),_jsx(ParamField,{body:`remove_items`,type:`object[]`,id:`param-remove-items-1`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,id:`param-feature-id-15`,children:_jsx(_components.p,{children:`Match items linked to this feature.`})}),_jsx(ParamField,{body:`billing_method`,type:`'prepaid' | 'usage_based'`,id:`param-billing-method-4`,children:_jsx(_components.p,{children:`Match items with this billing method (prepaid or usage_based).`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,id:`param-interval-14`,children:_jsx(_components.p,{children:`Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.`})}),_jsx(ParamField,{body:`interval_count`,type:`integer`,id:`param-interval-count-12`,children:_jsx(_components.p,{children:`Match items with this interval_count. Disambiguates between items that share an interval but differ in count.`})}),_jsx(ParamField,{body:`included`,type:`number`,id:`param-included-5`,children:_jsx(_components.p,{children:`Match items whose grant equals this included usage. Omitted is a wildcard.`})})]})})]})}),_jsx(ParamField,{body:`metadata`,type:`object`,id:`param-metadata-1`})]})]}),_jsxs(ParamField,{body:`remove_licenses`,type:`object[]`,id:`param-remove-licenses`,children:[_jsx(_components.p,{children:`License links to drop, keyed by license_plan_id. Parallel to remove_items.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`license_plan_id`,type:`string`,required:true,id:`param-license-plan-id-1`})})]})]})]})]})]})]})]}),_jsxs(ParamField,{body:`previous_attributes`,type:`object | null`,required:true,id:`param-previous-attributes-1`,children:[_jsx(_components.p,{children:`Sparse map of scalar plan fields that changed, holding their previous values. Null when the plan is new.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`id`,type:`string | null`,id:`param-id-2`,children:_jsx(_components.p,{children:`Unique identifier for the plan.`})}),_jsx(ParamField,{body:`name`,type:`string | null`,id:`param-name-4`,children:_jsx(_components.p,{children:`Display name of the plan.`})}),_jsx(ParamField,{body:`description`,type:`string | null | null`,id:`param-description-1`,children:_jsx(_components.p,{children:`Optional description of the plan.`})}),_jsx(ParamField,{body:`group`,type:`string | null | null`,id:`param-group-1`,children:_jsx(_components.p,{children:`Group identifier for organizing related plans. Plans in the same group are mutually exclusive.`})}),_jsx(ParamField,{body:`add_on`,type:`boolean | null`,id:`param-add-on-1`,children:_jsx(_components.p,{children:`Whether this is an add-on plan that can be attached alongside a main plan.`})}),_jsx(ParamField,{body:`auto_enable`,type:`boolean | null`,id:`param-auto-enable-1`,children:_jsx(_components.p,{children:`If true, this plan is automatically attached when a customer is created. Used for free plans.`})}),_jsxs(ParamField,{body:`config`,type:`object | null`,id:`param-config-1`,children:[_jsx(_components.p,{children:`Miscellaneous plan-level configuration flags.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`ignore_past_due`,type:`boolean`,required:true,id:`param-ignore-past-due-1`,children:_jsx(_components.p,{children:`If true, entitlements attached to this plan will still reset on schedule even when the customer’s product is in a past_due state.`})}),_jsx(ParamField,{body:`anchor_to_month_start`,type:`boolean`,id:`param-anchor-to-month-start-1`})]})]}),_jsx(ParamField,{body:`active`,type:`boolean | null`,id:`param-active-1`,children:_jsx(_components.p,{children:`Whether this is the active version of the plan. At most one version is active.`})}),_jsx(ParamField,{body:`archived`,type:`boolean | null`,id:`param-archived-2`,children:_jsx(_components.p,{children:`Whether the plan is archived. Archived plans cannot be attached to new customers.`})}),_jsx(ParamField,{body:`metadata`,type:`object | null`,id:`param-metadata-2`,children:_jsx(_components.p,{children:`Arbitrary key-value metadata defined by you for your own use. Shared across all versions of the plan.`})}),_jsxs(ParamField,{body:`processors`,type:`object | null`,id:`param-processors-3`,children:[_jsx(_components.p,{children:`Previous payment processors when they changed. Null when the plan had none.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`stripe`,type:`object | null`,id:`param-stripe-3`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`product_id`,type:`string`,required:true,id:`param-product-id-2`,children:_jsx(_components.p,{children:`Stripe product ID this plan is billed under.`})}),_jsx(ParamField,{body:`additional_product_ids`,type:`string[]`,id:`param-additional-product-ids-1`,children:_jsx(_components.p,{children:`Extra Stripe product IDs aliased to this plan.`})})]})}),_jsx(ParamField,{body:`revenuecat`,type:`object | null`,id:`param-revenuecat-1`,children:_jsx(Expandable,{title:`properties`,children:_jsxs(ParamField,{body:`products`,type:`object[]`,required:true,id:`param-products-1`,children:[_jsx(_components.p,{children:`Every RevenueCat product that maps to this plan. Replaces the current set.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`product_id`,type:`string`,required:true,id:`param-product-id-3`,children:_jsx(_components.p,{children:`RevenueCat product ID that grants this plan when purchased.`})}),_jsxs(ParamField,{body:`feature_quantities`,type:`object[]`,id:`param-feature-quantities-1`,children:[_jsx(_components.p,{children:`Prepaid quantities granted when this specific RevenueCat product is purchased, in feature units.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-16`}),_jsx(ParamField,{body:`quantity`,type:`number`,id:`param-quantity-3`})]})]})]})]})})})]})]}),_jsx(ParamField,{body:`base_variant_id`,type:`string | null`,id:`param-base-variant-id-1`,children:_jsx(_components.p,{children:`The base plan this variant pointed at before this update re-anchored it. Null when it was standalone.`})}),_jsx(ParamField,{body:`base_version`,type:`integer | null`,id:`param-base-version`,children:_jsx(_components.p,{children:`The base row version this variant pointed at before this update. Null when it was standalone.`})}),_jsx(ParamField,{body:`base_version_slug`,type:`string | null`,id:`param-base-version-slug`,children:_jsx(_components.p,{children:`The base row version slug this variant pointed at before this update. Null when it was standalone.`})}),_jsxs(ParamField,{body:`free_trial`,type:`object | null`,id:`param-free-trial-2`,children:[_jsx(_components.p,{children:`Previous free trial when it changed. Null when the plan had none.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`duration_length`,type:`number`,required:true,id:`param-duration-length-2`,children:_jsx(_components.p,{children:`Number of duration_type periods the trial lasts.`})}),_jsx(ParamField,{body:`duration_type`,type:`'day' | 'month' | 'year'`,required:true,id:`param-duration-type-2`,children:_jsx(_components.p,{children:`Unit of time for the trial duration (‘day’, ‘month’, ‘year’).`})}),_jsx(ParamField,{body:`card_required`,type:`boolean`,required:true,id:`param-card-required-2`,children:_jsx(_components.p,{children:`Whether a payment method is required to start the trial. If true, customer will be charged after trial ends.`})}),_jsx(ParamField,{body:`on_end`,type:`'bill' | 'revert'`,id:`param-on-end-2`,children:_jsx(_components.p,{children:`Behavior when the trial ends. ‘bill’ charges the customer (default). ‘revert’ expires the trial and restores the customer’s previous plan.`})})]})]}),_jsxs(ParamField,{body:`billing_controls`,type:`object | null`,id:`param-billing-controls-2`,children:[_jsx(_components.p,{children:`Sparse previous billing_controls — only keys that changed. Null when unset; a null lane was unset before.`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`auto_topups`,type:`object[] | null`,id:`param-auto-topups-2`,children:[_jsx(_components.p,{children:`List of auto top-up configurations per feature.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-17`,children:_jsx(_components.p,{children:`The ID of the feature (credit balance) to auto top-up.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-10`,children:_jsx(_components.p,{children:`Whether auto top-up is enabled.`})}),_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-7`,children:_jsx(_components.p,{children:`When the balance drops below this threshold, an auto top-up will be purchased.`})}),_jsx(ParamField,{body:`quantity`,type:`number`,required:true,id:`param-quantity-4`,children:_jsx(_components.p,{children:`Amount of credits to add per auto top-up.`})}),_jsxs(ParamField,{body:`purchase_limit`,type:`object`,id:`param-purchase-limit-2`,children:[_jsx(_components.p,{children:`Optional limit on auto top-ups per window, by number of top-ups or amount charged.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`limit_type`,type:`'count' | 'amount'`,id:`param-limit-type-4`,children:_jsxs(_components.p,{children:[`What `,_jsx(_components.code,{children:`limit`}),` caps: the number of auto top-ups (`,_jsx(_components.code,{children:`count`}),`, default) or the total amount charged for them, in the customer’s currency (`,_jsx(_components.code,{children:`amount`}),`).`]})}),_jsx(ParamField,{body:`interval`,type:`'hour' | 'day' | 'week' | 'month'`,required:true,id:`param-interval-15`,children:_jsx(_components.p,{children:`The time interval for the purchase limit window.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,required:true,id:`param-interval-count-13`,children:_jsx(_components.p,{children:`Number of intervals in the purchase limit window.`})}),_jsx(ParamField,{body:`limit`,type:`number`,required:true,id:`param-limit-4`,children:_jsx(_components.p,{children:`Maximum allowed within the interval: a number of auto top-ups when limit_type is count, or a total charge (e.g. 500 for $500, pre-tax) when limit_type is amount.`})})]})]}),_jsx(ParamField,{body:`invoice_mode`,type:`boolean`,id:`param-invoice-mode-2`,children:_jsx(_components.p,{children:`When true, auto top-up creates a send_invoice invoice instead of auto-charging.`})})]})]}),_jsxs(ParamField,{body:`spend_limits`,type:`object[] | null`,id:`param-spend-limits-2`,children:[_jsx(_components.p,{children:`List of overage spend limits per feature (caps overage spend).`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,id:`param-feature-id-18`,children:_jsx(_components.p,{children:`Optional feature ID this spend limit applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-11`,children:_jsx(_components.p,{children:`Whether the overage spend limit is enabled.`})}),_jsx(ParamField,{body:`limit_type`,type:`'absolute' | 'usage_percentage'`,id:`param-limit-type-5`,children:_jsx(_components.p,{children:`How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.`})}),_jsx(ParamField,{body:`overage_limit`,type:`number`,id:`param-overage-limit-2`,children:_jsx(_components.p,{children:`Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.`})}),_jsx(ParamField,{body:`skip_overage_billing`,type:`boolean`,id:`param-skip-overage-billing-2`,children:_jsx(_components.p,{children:`When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.`})})]})]}),_jsxs(ParamField,{body:`usage_limits`,type:`object[] | null`,id:`param-usage-limits-2`,children:[_jsx(_components.p,{children:`List of hard usage caps per feature (max units per interval).`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-19`,children:_jsx(_components.p,{children:`The feature this usage limit applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-12`,children:_jsx(_components.p,{children:`Whether this usage limit is enabled.`})}),_jsx(ParamField,{body:`limit`,type:`number`,required:true,id:`param-limit-5`,children:_jsx(_components.p,{children:`Maximum units allowed per interval.`})}),_jsx(ParamField,{body:`interval`,type:`'day' | 'week' | 'month' | 'year'`,required:true,id:`param-interval-16`,children:_jsx(_components.p,{children:`Interval for the cap, aligned to the customer’s billing cycle.`})}),_jsx(ParamField,{body:`anchor`,type:`'billing_cycle' | 'utc'`,id:`param-anchor-2`,children:_jsx(_components.p,{children:`Window alignment. ‘billing_cycle’ phases the interval to the customer’s renewal time; ‘utc’ aligns to the UTC calendar.`})}),_jsxs(ParamField,{body:`filter`,type:`object`,id:`param-filter-4`,children:[_jsx(_components.p,{children:`When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`properties.{key}`,type:`string`,required:true,id:`param-properties-key-4`})})]})]})]}),_jsxs(ParamField,{body:`usage_alerts`,type:`object[] | null`,id:`param-usage-alerts-2`,children:[_jsx(_components.p,{children:`List of usage alert configurations per feature.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,id:`param-feature-id-20`,children:_jsx(_components.p,{children:`The feature ID this alert applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-13`,children:_jsx(_components.p,{children:`Whether this usage alert is enabled.`})}),_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-8`,children:_jsx(_components.p,{children:`The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage. remaining and remaining_percentage accept negative values with basis balance, to alert once the balance is overdrawn.`})}),_jsx(ParamField,{body:`threshold_type`,type:`'usage' | 'usage_percentage' | 'remaining' | 'remaining_percentage'`,required:true,id:`param-threshold-type-2`,children:_jsx(_components.p,{children:`Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.`})}),_jsx(ParamField,{body:`basis`,type:`'balance' | 'included' | 'recurring' | 'usage_limit'`,required:true,id:`param-basis-2`,children:_jsx(_components.p,{children:`What 100% means. balance: every grant on the feature. included: the plan allowance only. recurring: grants that reset. usage_limit: the cap of the usage limit with the same feature and filter.`})}),_jsxs(ParamField,{body:`filter`,type:`object`,id:`param-filter-5`,children:[_jsx(_components.p,{children:`Only valid with basis usage_limit. Points the alert at the usage limit carrying the same filter.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`properties.{key}`,type:`string`,required:true,id:`param-properties-key-5`})})]}),_jsx(ParamField,{body:`name`,type:`string`,id:`param-name-5`,children:_jsx(_components.p,{children:`Optional user-defined label to distinguish multiple alerts on the same feature.`})})]})]}),_jsxs(ParamField,{body:`overage_allowed`,type:`object[] | null`,id:`param-overage-allowed-2`,children:[_jsx(_components.p,{children:`List of overage allowed controls per feature. When enabled, usage can exceed balance.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-21`,children:_jsx(_components.p,{children:`The feature ID this overage allowed control applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-14`,children:_jsx(_components.p,{children:`Whether overage is allowed for this feature.`})})]})]})]})]})]})]}),_jsxs(ParamField,{body:`price_change`,type:`object`,id:`param-price-change`,children:[_jsx(_components.p,{children:`Present when the plan’s price changed.`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`previous`,type:`object | null | null`,required:true,id:`param-previous`,children:[_jsx(_components.p,{children:`Base recurring price for the plan. Null for free plans or usage-only plans.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-19`,children:_jsx(_components.p,{children:`Base price amount for the plan, in major currency units (e.g. dollars).`})}),_jsxs(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-9`,children:[_jsx(_components.p,{children:`Base price amounts in additional currencies. The base ‘amount’ is in the org’s default currency.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-9`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-20`,children:_jsx(_components.p,{children:`Price amount in this currency. Set explicitly per currency, not converted from the base amount.`})})]})]}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-17`,children:_jsx(_components.p,{children:`Billing interval (e.g. ‘month’, ‘year’).`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-14`,children:_jsx(_components.p,{children:`Number of intervals per billing cycle. Defaults to 1.`})}),_jsxs(ParamField,{body:`display`,type:`object`,id:`param-display-3`,children:[_jsx(_components.p,{children:`Display text for showing this price in pricing pages.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`primary_text`,type:`string`,required:true,id:`param-primary-text-2`,children:_jsx(_components.p,{children:`Main display text (e.g. ‘$10’ or ‘100 messages’).`})}),_jsx(ParamField,{body:`secondary_text`,type:`string`,id:`param-secondary-text-2`,children:_jsx(_components.p,{children:`Secondary display text (e.g. ‘per month’ or ‘then $0.5 per 100’).`})})]})]}),_jsxs(ParamField,{body:`processors`,type:`object`,id:`param-processors-4`,children:[_jsx(_components.p,{children:`Payment processors this base price is connected to. Omitted when unset.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`stripe`,type:`object | null`,id:`param-stripe-4`,children:_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`price_id`,type:`string`,required:true,id:`param-price-id-2`,children:_jsx(_components.p,{children:`Stripe price ID. For prepaid with included > 0 this is the V2 price.`})})})})})]})]})]}),_jsxs(ParamField,{body:`current`,type:`object | null`,required:true,id:`param-current`,children:[_jsx(_components.p,{children:`The plan’s price after the change.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-21`,children:_jsx(_components.p,{children:`Base price amount for the plan, in major currency units (e.g. dollars).`})}),_jsxs(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-10`,children:[_jsx(_components.p,{children:`Base price amounts in additional currencies. The base ‘amount’ is in the org’s default currency.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-10`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-22`,children:_jsx(_components.p,{children:`Price amount in this currency. Set explicitly per currency, not converted from the base amount.`})})]})]}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-18`,children:_jsx(_components.p,{children:`Billing interval (e.g. ‘month’, ‘year’).`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-15`,children:_jsx(_components.p,{children:`Number of intervals per billing cycle. Defaults to 1.`})}),_jsxs(ParamField,{body:`display`,type:`object`,id:`param-display-4`,children:[_jsx(_components.p,{children:`Display text for showing this price in pricing pages.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`primary_text`,type:`string`,required:true,id:`param-primary-text-3`,children:_jsx(_components.p,{children:`Main display text (e.g. ‘$10’ or ‘100 messages’).`})}),_jsx(ParamField,{body:`secondary_text`,type:`string`,id:`param-secondary-text-3`,children:_jsx(_components.p,{children:`Secondary display text (e.g. ‘per month’ or ‘then $0.5 per 100’).`})})]})]}),_jsxs(ParamField,{body:`processors`,type:`object`,id:`param-processors-5`,children:[_jsx(_components.p,{children:`Payment processors this base price is connected to. Omitted when unset.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`stripe`,type:`object | null`,id:`param-stripe-5`,children:_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`price_id`,type:`string`,required:true,id:`param-price-id-3`,children:_jsx(_components.p,{children:`Stripe price ID. For prepaid with included > 0 this is the V2 price.`})})})})})]})]})]})]})]}),_jsxs(ParamField,{body:`free_trial_change`,type:`object`,id:`param-free-trial-change`,children:[_jsx(_components.p,{children:`Present when the plan’s free trial changed.`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`previous`,type:`object | null`,required:true,id:`param-previous-1`,children:[_jsx(_components.p,{children:`The plan’s free trial before the change. Null when none.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`duration_length`,type:`number`,required:true,id:`param-duration-length-3`,children:_jsx(_components.p,{children:`Number of duration_type periods the trial lasts.`})}),_jsx(ParamField,{body:`duration_type`,type:`'day' | 'month' | 'year'`,required:true,id:`param-duration-type-3`,children:_jsx(_components.p,{children:`Unit of time for the trial duration (‘day’, ‘month’, ‘year’).`})}),_jsx(ParamField,{body:`card_required`,type:`boolean`,required:true,id:`param-card-required-3`,children:_jsx(_components.p,{children:`Whether a payment method is required to start the trial. If true, customer will be charged after trial ends.`})}),_jsx(ParamField,{body:`on_end`,type:`'bill' | 'revert'`,id:`param-on-end-3`,children:_jsx(_components.p,{children:`Behavior when the trial ends. ‘bill’ charges the customer (default). ‘revert’ expires the trial and restores the customer’s previous plan.`})})]})]}),_jsxs(ParamField,{body:`current`,type:`object | null`,required:true,id:`param-current-1`,children:[_jsx(_components.p,{children:`The plan’s free trial after the change. Null when none.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`duration_length`,type:`number`,required:true,id:`param-duration-length-4`,children:_jsx(_components.p,{children:`Number of duration_type periods the trial lasts.`})}),_jsx(ParamField,{body:`duration_type`,type:`'day' | 'month' | 'year'`,required:true,id:`param-duration-type-4`,children:_jsx(_components.p,{children:`Unit of time for the trial duration (‘day’, ‘month’, ‘year’).`})}),_jsx(ParamField,{body:`card_required`,type:`boolean`,required:true,id:`param-card-required-4`,children:_jsx(_components.p,{children:`Whether a payment method is required to start the trial. If true, customer will be charged after trial ends.`})}),_jsx(ParamField,{body:`on_end`,type:`'bill' | 'revert'`,id:`param-on-end-4`,children:_jsx(_components.p,{children:`Behavior when the trial ends. ‘bill’ charges the customer (default). ‘revert’ expires the trial and restores the customer’s previous plan.`})})]})]})]})]}),_jsxs(ParamField,{body:`item_changes`,type:`object[]`,required:true,id:`param-item-changes`,children:[_jsx(_components.p,{children:`Feature items added to or removed from the plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`action`,type:`'created' | 'deleted'`,required:true,id:`param-action-1`,children:_jsx(_components.p,{children:`Whether the item was added to or removed from the plan.`})}),_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-22`,children:_jsx(_components.p,{children:`The ID of the feature that was added or removed.`})}),_jsxs(ParamField,{body:`item`,type:`object`,required:true,id:`param-item`,children:[_jsx(_components.p,{children:`The plan item snapshot that was added or removed.`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`threshold_billing`,type:`object | null`,id:`param-threshold-billing-3`,children:[_jsx(_components.p,{children:`Bills this many feature units when outstanding overage reaches it.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-9`})})]}),_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-23`,children:_jsx(_components.p,{children:`The ID of the feature this item configures.`})}),_jsxs(ParamField,{body:`feature`,type:`object`,id:`param-feature-1`,children:[_jsx(_components.p,{children:`The full feature object if expanded.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`id`,type:`string`,required:true,id:`param-id-3`,children:_jsx(_components.p,{children:`The ID of the feature, used to refer to it in other API calls like /track or /check.`})}),_jsx(ParamField,{body:`name`,type:`string | null`,id:`param-name-6`,children:_jsx(_components.p,{children:`The name of the feature.`})}),_jsx(ParamField,{body:`type`,type:`'static' | 'boolean' | 'single_use' | 'continuous_use' | 'credit_system' | 'ai_credit_system'`,required:true,id:`param-type-1`,children:_jsx(_components.p,{children:`The type of the feature`})}),_jsxs(ParamField,{body:`display`,type:`object | null`,id:`param-display-5`,children:[_jsx(_components.p,{children:`Singular and plural display names for the feature.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`singular`,type:`string`,required:true,id:`param-singular-1`,children:_jsx(_components.p,{children:`The singular display name for the feature.`})}),_jsx(ParamField,{body:`plural`,type:`string`,required:true,id:`param-plural-1`,children:_jsx(_components.p,{children:`The plural display name for the feature.`})})]})]}),_jsxs(ParamField,{body:`credit_schema`,type:`object[] | null`,id:`param-credit-schema-4`,children:[_jsx(_components.p,{children:`Credit cost schema for credit system features.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`metered_feature_id`,type:`string`,required:true,id:`param-metered-feature-id-4`,children:_jsx(_components.p,{children:`The ID of the metered feature (should be a single_use feature).`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-10`,children:_jsx(_components.p,{children:`The credit cost of the metered feature.`})})]})]}),_jsx(ParamField,{body:`archived`,type:`boolean | null`,id:`param-archived-3`,children:_jsx(_components.p,{children:`Whether or not the feature is archived.`})})]})]}),_jsx(ParamField,{body:`included`,type:`number`,required:true,id:`param-included-6`,children:_jsx(_components.p,{children:`Number of free units included. For consumable features, balance resets to this number each interval.`})}),_jsx(ParamField,{body:`unlimited`,type:`boolean`,required:true,id:`param-unlimited-3`,children:_jsx(_components.p,{children:`Whether the customer has unlimited access to this feature.`})}),_jsx(ParamField,{body:`pooled`,type:`boolean`,id:`param-pooled-3`,children:_jsx(_components.p,{children:`Whether entity-level grants contribute to a shared customer balance.`})}),_jsxs(ParamField,{body:`reset`,type:`object | null`,required:true,id:`param-reset-3`,children:[_jsx(_components.p,{children:`Reset configuration for consumable features. Null for non-consumable features like seats where usage persists across billing cycles.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`interval`,type:`'one_off' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-19`,children:_jsx(_components.p,{children:`The interval at which the feature balance resets (e.g. ‘month’, ‘year’). For consumable features, usage resets to 0 and included units are restored.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-16`,children:_jsx(_components.p,{children:`Number of intervals between resets. Defaults to 1.`})})]})]}),_jsxs(ParamField,{body:`price`,type:`object | null`,required:true,id:`param-price-6`,children:[_jsx(_components.p,{children:`Pricing configuration for usage beyond included units. Null if feature is entirely free.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-23`,children:_jsx(_components.p,{children:`Price per billing_units after included usage is consumed. Mutually exclusive with tiers.`})}),_jsxs(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-11`,children:[_jsx(_components.p,{children:`Amounts in additional currencies for this flat price. The base ‘amount’ is in the org’s default currency. Only valid with ‘amount’, not ‘tiers’ (tiered prices carry per-currency amounts on each tier).`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-11`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-24`,children:_jsx(_components.p,{children:`Price amount in this currency. Set explicitly per currency, not converted from the base amount.`})})]})]}),_jsxs(ParamField,{body:`tiers`,type:`object[]`,id:`param-tiers-9`,children:[_jsx(_components.p,{children:`Tiered pricing configuration. Each tier’s ‘to’ INCLUDES the included amount. Either ‘tiers’ or ‘amount’ is required.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-9`}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-25`}),_jsx(ParamField,{body:`flat_amount`,type:`number`,id:`param-flat-amount-6`}),_jsx(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-12`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-12`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-26`,children:_jsx(_components.p,{children:`Per-unit amount for this tier in this currency.`})}),_jsx(ParamField,{body:`flat_amount`,type:`number`,id:`param-flat-amount-7`,children:_jsx(_components.p,{children:`Flat amount for this tier in this currency, if the tier uses one.`})})]})})]})]}),_jsx(ParamField,{body:`tier_behavior`,type:`'graduated' | 'volume'`,id:`param-tier-behavior-9`,children:_jsx(_components.p,{children:`How tiers price usage. ‘graduated’ (default) charges each unit at the rate of the tier it falls in. ‘volume’ picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier’s rate plus its flat_amount.`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-20`,children:_jsx(_components.p,{children:`Billing interval for this price. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-17`,children:_jsx(_components.p,{children:`Number of intervals per billing cycle. Defaults to 1.`})}),_jsx(ParamField,{body:`billing_units`,type:`number`,required:true,id:`param-billing-units-6`,children:_jsx(_components.p,{children:`Number of units per price increment. Usage is rounded UP to the nearest billing_units when billed (e.g. billing_units=100 means 101 usage rounds to 200).`})}),_jsx(ParamField,{body:`billing_method`,type:`'prepaid' | 'usage_based'`,required:true,id:`param-billing-method-5`,children:_jsx(_components.p,{children:`‘prepaid’ for features like seats where customers pay upfront, ‘usage_based’ for pay-as-you-go after included usage.`})}),_jsx(ParamField,{body:`max_purchase`,type:`number | null`,required:true,id:`param-max-purchase-3`,children:_jsx(_components.p,{children:`Maximum units a customer can purchase beyond included. E.g. if included=100 and max_purchase=300, customer can use up to 400 total before usage is capped. Null for no limit.`})}),_jsxs(ParamField,{body:`processors`,type:`object`,id:`param-processors-6`,children:[_jsx(_components.p,{children:`Payment processors this item price is connected to. Omitted when unset.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`stripe`,type:`object | null`,id:`param-stripe-6`,children:_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`price_id`,type:`string`,required:true,id:`param-price-id-4`,children:_jsx(_components.p,{children:`Stripe price ID. For prepaid with included > 0 this is the V2 price.`})})})})})]})]})]}),_jsxs(ParamField,{body:`display`,type:`object`,id:`param-display-6`,children:[_jsx(_components.p,{children:`Display text for showing this item in pricing pages.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`primary_text`,type:`string`,required:true,id:`param-primary-text-4`,children:_jsx(_components.p,{children:`Main display text (e.g. ‘$10’ or ‘100 messages’).`})}),_jsx(ParamField,{body:`secondary_text`,type:`string`,id:`param-secondary-text-4`,children:_jsx(_components.p,{children:`Secondary display text (e.g. ‘per month’ or ‘then $0.5 per 100’).`})})]})]}),_jsxs(ParamField,{body:`rollover`,type:`object`,id:`param-rollover-3`,children:[_jsx(_components.p,{children:`Rollover configuration for unused units. If set, unused included units roll over to the next period.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`max`,type:`number | null`,required:true,id:`param-max-3`,children:_jsx(_components.p,{children:`Maximum rollover units. Null for unlimited rollover.`})}),_jsx(ParamField,{body:`max_percentage`,type:`number | null`,id:`param-max-percentage-3`,children:_jsx(_components.p,{children:`Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.`})}),_jsx(ParamField,{body:`expiry_duration_type`,type:`'month' | 'forever'`,required:true,id:`param-expiry-duration-type-3`,children:_jsx(_components.p,{children:`When rolled over units expire.`})}),_jsx(ParamField,{body:`expiry_duration_length`,type:`number`,id:`param-expiry-duration-length-3`,children:_jsx(_components.p,{children:`Number of periods before expiry.`})})]})]}),_jsxs(ParamField,{body:`expiry`,type:`object | null`,id:`param-expiry-3`,children:[_jsx(_components.p,{children:`Purchased units expire this long after each purchase. One-off prepaid consumable items only.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`duration`,type:`'day' | 'week' | 'month' | 'year'`,required:true,id:`param-duration-3`}),_jsx(ParamField,{body:`length`,type:`number`,required:true,id:`param-length-3`})]})]}),_jsxs(ParamField,{body:`feature_override`,type:`object`,id:`param-feature-override-3`,children:[_jsx(_components.p,{children:`Overrides fields of this item’s feature for customers on this plan (e.g. a credit system’s credit_schema).`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`credit_schema`,type:`object | object | object[]`,id:`param-credit-schema-5`,children:[_jsxs(_components.p,{children:[`For credit system features: merges into the feature’s credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `,_jsx(_components.code,{children:`excluded: true`}),` removes it, and unlisted features keep the credit system’s rate.`]}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`metered_feature_id`,type:`string`,id:`param-metered-feature-id-5`,children:_jsx(_components.p,{children:`ID of the metered feature that draws from this credit system.`})}),_jsx(ParamField,{body:`billing_units`,type:`number`,id:`param-billing-units-7`,children:_jsx(_components.p,{children:`Number of metered-feature units priced together. Defaults to one when omitted.`})}),_jsxs(ParamField,{body:`dimensions.{key}`,type:`object`,id:`param-dimensions-key-3`,children:[_jsx(_components.p,{children:`Named rates chosen by event properties. The most specific match sets the rate; with no match the item’s own rate applies.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`match.{key}`,type:`string`,required:true,id:`param-match-key-6`,children:_jsx(_components.p,{children:`Event properties this entry applies to. Every key must equal the tracked property, compared as strings.`})}),_jsx(ParamField,{body:`priority`,type:`integer`,id:`param-priority-3`,children:_jsx(_components.p,{children:`Breaks ties between dimensions that match the same number of keys. Higher wins.`})}),_jsx(ParamField,{body:`tier_behavior`,type:`string`,required:true,id:`param-tier-behavior-10`}),_jsx(ParamField,{body:`tiers`,type:`object[]`,required:true,id:`param-tiers-10`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-10`,children:_jsx(_components.p,{children:`Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-11`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group within this tier.`})})]})})]})]}),_jsxs(ParamField,{body:`multipliers.{key}`,type:`object`,id:`param-multipliers-key-3`,children:[_jsx(_components.p,{children:`Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`match.{key}`,type:`string`,required:true,id:`param-match-key-7`,children:_jsx(_components.p,{children:`Event properties this entry applies to. Every key must equal the tracked property, compared as strings.`})}),_jsx(ParamField,{body:`factor`,type:`number`,id:`param-factor-3`,children:_jsx(_components.p,{children:`Multiplies the matched rate. All matching multipliers stack.`})}),_jsx(ParamField,{body:`add`,type:`number`,id:`param-add-3`,children:_jsx(_components.p,{children:`Added to the rate after every factor is applied, in credits per billing-unit group.`})})]})]}),_jsx(ParamField,{body:`tier_behavior`,type:`string`,id:`param-tier-behavior-11`}),_jsx(ParamField,{body:`tiers`,type:`object[]`,id:`param-tiers-11`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-11`,children:_jsx(_components.p,{children:`Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-12`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group within this tier.`})})]})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,id:`param-credit-cost-13`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group.`})}),_jsx(ParamField,{body:`excluded`,type:`true`,id:`param-excluded-3`,children:_jsx(_components.p,{children:`Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.`})})]})]}),_jsxs(ParamField,{body:`markups`,type:`object`,id:`param-markups-3`,children:[_jsx(_components.p,{children:`For AI credit system features: replaces the feature’s markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature’s.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`default_markup`,type:`number`,id:`param-default-markup-3`,children:_jsx(_components.p,{children:`Default percentage markup for customers on this plan. Use -100 to make usage free.`})}),_jsxs(ParamField,{body:`provider_markups.{key}`,type:`object | null`,id:`param-provider-markups-key-3`,children:[_jsx(_components.p,{children:`Per-provider markup percentages for customers on this plan.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`markup`,type:`number`,required:true,id:`param-markup-6`})})]}),_jsxs(ParamField,{body:`model_markups.{key}`,type:`object | null`,id:`param-model-markups-key-3`,children:[_jsx(_components.p,{children:`Per-model markup overrides for customers on this plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`markup`,type:`number`,id:`param-markup-7`}),_jsx(ParamField,{body:`input_cost`,type:`number`,id:`param-input-cost-3`}),_jsx(ParamField,{body:`output_cost`,type:`number`,id:`param-output-cost-3`})]})]})]})]})]})]})]})]})]})]}),_jsxs(ParamField,{body:`customize`,type:`object`,id:`param-customize-2`,children:[_jsx(_components.p,{children:`Params that would transform the previous plan into the current one, including license upserts/removes.`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`price`,type:`object | null`,id:`param-price-7`,children:[_jsx(_components.p,{children:`Base price configuration for a plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-27`,children:_jsx(_components.p,{children:`Base price amount for the plan, in major currency units (e.g. dollars).`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-21`,children:_jsx(_components.p,{children:`Billing interval (e.g. ‘month’, ‘year’).`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-18`}),_jsxs(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-13`,children:[_jsx(_components.p,{children:`Base price amounts in additional currencies. The base ‘amount’ is in the org’s default currency.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-13`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-28`,children:_jsx(_components.p,{children:`Price amount in this currency. Set explicitly per currency, not converted from the base amount.`})})]})]})]})]}),_jsxs(ParamField,{body:`add_items`,type:`object[]`,id:`param-add-items-2`,children:[_jsx(_components.p,{children:`Items to add to the plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`threshold_billing`,type:`object | null`,id:`param-threshold-billing-4`,children:[_jsx(_components.p,{children:`Bills this many feature units when outstanding overage reaches it.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-10`})})]}),_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-24`,children:_jsx(_components.p,{children:`The ID of the feature to configure.`})}),_jsx(ParamField,{body:`included`,type:`number`,id:`param-included-7`,children:_jsx(_components.p,{children:`Number of free units included. Balance resets to this each interval for consumable features.`})}),_jsx(ParamField,{body:`unlimited`,type:`boolean`,id:`param-unlimited-4`,children:_jsx(_components.p,{children:`If true, customer has unlimited access to this feature.`})}),_jsx(ParamField,{body:`pooled`,type:`boolean`,id:`param-pooled-4`,children:_jsx(_components.p,{children:`Whether entity-level grants contribute to a shared customer balance.`})}),_jsxs(ParamField,{body:`reset`,type:`object`,id:`param-reset-4`,children:[_jsx(_components.p,{children:`Reset configuration for consumable features. Omit for non-consumable features like seats.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`interval`,type:`'one_off' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-22`,children:_jsx(_components.p,{children:`Interval at which balance resets (e.g. ‘month’, ‘year’). For consumable features only.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-19`})]})]}),_jsxs(ParamField,{body:`price`,type:`object`,id:`param-price-8`,children:[_jsx(_components.p,{children:`Pricing for usage beyond included units. Omit for free features.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-29`,children:_jsx(_components.p,{children:`Price per billing_units after included usage. Either ‘amount’ or ‘tiers’ is required.`})}),_jsxs(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-14`,children:[_jsx(_components.p,{children:`Amounts in additional currencies for this flat price. The base ‘amount’ is in the org’s default currency. Only valid with ‘amount’, not ‘tiers’.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-14`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-30`,children:_jsx(_components.p,{children:`Price amount in this currency. Set explicitly per currency, not converted from the base amount.`})})]})]}),_jsxs(ParamField,{body:`tiers`,type:`object[]`,id:`param-tiers-12`,children:[_jsx(_components.p,{children:`Tiered pricing. Either ‘amount’ or ‘tiers’ is required.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-12`}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-31`}),_jsx(ParamField,{body:`flat_amount`,type:`number`,id:`param-flat-amount-8`}),_jsx(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-15`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-15`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-32`,children:_jsx(_components.p,{children:`Per-unit amount for this tier in this currency.`})}),_jsx(ParamField,{body:`flat_amount`,type:`number`,id:`param-flat-amount-9`,children:_jsx(_components.p,{children:`Flat amount for this tier in this currency, if the tier uses one.`})})]})})]})]}),_jsx(ParamField,{body:`tier_behavior`,type:`'graduated' | 'volume'`,id:`param-tier-behavior-12`,children:_jsx(_components.p,{children:`How tiers price usage. ‘graduated’ (default) charges each unit at the rate of the tier it falls in. ‘volume’ picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier’s rate plus its flat_amount.`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-23`,children:_jsx(_components.p,{children:`Billing interval. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-20`,children:_jsx(_components.p,{children:`Number of intervals per billing cycle. Defaults to 1.`})}),_jsx(ParamField,{body:`billing_units`,type:`number`,id:`param-billing-units-8`,children:_jsx(_components.p,{children:`Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).`})}),_jsx(ParamField,{body:`billing_method`,type:`'prepaid' | 'usage_based'`,required:true,id:`param-billing-method-6`,children:_jsx(_components.p,{children:`‘prepaid’ for upfront payment (seats), ‘usage_based’ for pay-as-you-go.`})}),_jsx(ParamField,{body:`max_purchase`,type:`number | null`,id:`param-max-purchase-4`,children:_jsx(_components.p,{children:`Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.`})})]})]}),_jsxs(ParamField,{body:`proration`,type:`object`,id:`param-proration-2`,children:[_jsx(_components.p,{children:`Proration settings for prepaid features. Controls mid-cycle quantity change billing.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`on_increase`,type:`'bill_immediately' | 'prorate_immediately' | 'prorate_next_cycle' | 'bill_next_cycle'`,required:true,id:`param-on-increase-2`,children:_jsx(_components.p,{children:`Billing behavior when quantity increases mid-cycle.`})}),_jsx(ParamField,{body:`on_decrease`,type:`'prorate' | 'prorate_immediately' | 'prorate_next_cycle' | 'none' | 'no_prorations'`,required:true,id:`param-on-decrease-2`,children:_jsx(_components.p,{children:`Credit behavior when quantity decreases mid-cycle.`})})]})]}),_jsxs(ParamField,{body:`rollover`,type:`object`,id:`param-rollover-4`,children:[_jsx(_components.p,{children:`Rollover config for unused units. If set, unused included units carry over.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`max`,type:`number`,id:`param-max-4`,children:_jsx(_components.p,{children:`Max rollover units. Omit for unlimited rollover.`})}),_jsx(ParamField,{body:`max_percentage`,type:`number`,id:`param-max-percentage-4`,children:_jsx(_components.p,{children:`Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.`})}),_jsx(ParamField,{body:`expiry_duration_type`,type:`'month' | 'forever'`,required:true,id:`param-expiry-duration-type-4`,children:_jsx(_components.p,{children:`When rolled over units expire.`})}),_jsx(ParamField,{body:`expiry_duration_length`,type:`number`,id:`param-expiry-duration-length-4`,children:_jsx(_components.p,{children:`Number of periods before expiry.`})})]})]}),_jsxs(ParamField,{body:`expiry`,type:`object`,id:`param-expiry-4`,children:[_jsx(_components.p,{children:`Purchased units expire this long after each purchase. One-off prepaid consumable items only.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`duration`,type:`'day' | 'week' | 'month' | 'year'`,required:true,id:`param-duration-4`}),_jsx(ParamField,{body:`length`,type:`number`,required:true,id:`param-length-4`})]})]}),_jsxs(ParamField,{body:`feature_override`,type:`object`,id:`param-feature-override-4`,children:[_jsx(_components.p,{children:`Overrides fields of this item’s feature for customers on this plan (e.g. a credit system’s credit_schema).`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`credit_schema`,type:`object | object | object[]`,id:`param-credit-schema-6`,children:[_jsxs(_components.p,{children:[`For credit system features: merges into the feature’s credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `,_jsx(_components.code,{children:`excluded: true`}),` removes it, and unlisted features keep the credit system’s rate.`]}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`metered_feature_id`,type:`string`,id:`param-metered-feature-id-6`,children:_jsx(_components.p,{children:`ID of the metered feature that draws from this credit system.`})}),_jsx(ParamField,{body:`billing_units`,type:`number`,id:`param-billing-units-9`,children:_jsx(_components.p,{children:`Number of metered-feature units priced together. Defaults to one when omitted.`})}),_jsxs(ParamField,{body:`dimensions.{key}`,type:`object`,id:`param-dimensions-key-4`,children:[_jsx(_components.p,{children:`Named rates chosen by event properties. The most specific match sets the rate; with no match the item’s own rate applies.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`match.{key}`,type:`string`,required:true,id:`param-match-key-8`,children:_jsx(_components.p,{children:`Event properties this entry applies to. Every key must equal the tracked property, compared as strings.`})}),_jsx(ParamField,{body:`priority`,type:`integer`,id:`param-priority-4`,children:_jsx(_components.p,{children:`Breaks ties between dimensions that match the same number of keys. Higher wins.`})}),_jsx(ParamField,{body:`tier_behavior`,type:`string`,required:true,id:`param-tier-behavior-13`}),_jsx(ParamField,{body:`tiers`,type:`object[]`,required:true,id:`param-tiers-13`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-13`,children:_jsx(_components.p,{children:`Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-14`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group within this tier.`})})]})})]})]}),_jsxs(ParamField,{body:`multipliers.{key}`,type:`object`,id:`param-multipliers-key-4`,children:[_jsx(_components.p,{children:`Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`match.{key}`,type:`string`,required:true,id:`param-match-key-9`,children:_jsx(_components.p,{children:`Event properties this entry applies to. Every key must equal the tracked property, compared as strings.`})}),_jsx(ParamField,{body:`factor`,type:`number`,id:`param-factor-4`,children:_jsx(_components.p,{children:`Multiplies the matched rate. All matching multipliers stack.`})}),_jsx(ParamField,{body:`add`,type:`number`,id:`param-add-4`,children:_jsx(_components.p,{children:`Added to the rate after every factor is applied, in credits per billing-unit group.`})})]})]}),_jsx(ParamField,{body:`tier_behavior`,type:`string`,id:`param-tier-behavior-14`}),_jsx(ParamField,{body:`tiers`,type:`object[]`,id:`param-tiers-14`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-14`,children:_jsx(_components.p,{children:`Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-15`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group within this tier.`})})]})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,id:`param-credit-cost-16`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group.`})}),_jsx(ParamField,{body:`excluded`,type:`true`,id:`param-excluded-4`,children:_jsx(_components.p,{children:`Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.`})})]})]}),_jsxs(ParamField,{body:`markups`,type:`object`,id:`param-markups-4`,children:[_jsx(_components.p,{children:`For AI credit system features: replaces the feature’s markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature’s.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`default_markup`,type:`number`,id:`param-default-markup-4`,children:_jsx(_components.p,{children:`Default percentage markup for customers on this plan. Use -100 to make usage free.`})}),_jsxs(ParamField,{body:`provider_markups.{key}`,type:`object | null`,id:`param-provider-markups-key-4`,children:[_jsx(_components.p,{children:`Per-provider markup percentages for customers on this plan.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`markup`,type:`number`,required:true,id:`param-markup-8`})})]}),_jsxs(ParamField,{body:`model_markups.{key}`,type:`object | null`,id:`param-model-markups-key-4`,children:[_jsx(_components.p,{children:`Per-model markup overrides for customers on this plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`markup`,type:`number`,id:`param-markup-9`}),_jsx(ParamField,{body:`input_cost`,type:`number`,id:`param-input-cost-4`}),_jsx(ParamField,{body:`output_cost`,type:`number`,id:`param-output-cost-4`})]})]})]})]})]})]})]})]}),_jsxs(ParamField,{body:`remove_items`,type:`object[]`,id:`param-remove-items-2`,children:[_jsx(_components.p,{children:`Filters selecting items to remove from the plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,id:`param-feature-id-25`,children:_jsx(_components.p,{children:`Match items linked to this feature.`})}),_jsx(ParamField,{body:`billing_method`,type:`'prepaid' | 'usage_based'`,id:`param-billing-method-7`,children:_jsx(_components.p,{children:`Match items with this billing method (prepaid or usage_based).`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,id:`param-interval-24`,children:_jsx(_components.p,{children:`Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.`})}),_jsx(ParamField,{body:`interval_count`,type:`integer`,id:`param-interval-count-21`,children:_jsx(_components.p,{children:`Match items with this interval_count. Disambiguates between items that share an interval but differ in count.`})}),_jsx(ParamField,{body:`included`,type:`number`,id:`param-included-8`,children:_jsx(_components.p,{children:`Match items whose grant equals this included usage. Omitted is a wildcard.`})})]})]}),_jsxs(ParamField,{body:`free_trial`,type:`object | null`,id:`param-free-trial-3`,children:[_jsx(_components.p,{children:`Free trial configuration for a plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`duration_length`,type:`number`,required:true,id:`param-duration-length-5`,children:_jsx(_components.p,{children:`Number of duration_type periods the trial lasts.`})}),_jsx(ParamField,{body:`duration_type`,type:`'day' | 'month' | 'year'`,required:true,id:`param-duration-type-5`,children:_jsx(_components.p,{children:`Unit of time for the trial (‘day’, ‘month’, ‘year’).`})}),_jsx(ParamField,{body:`card_required`,type:`boolean`,required:true,id:`param-card-required-5`,children:_jsx(_components.p,{children:`If true, a payment method is required to start the trial and the customer is charged when it ends. Defaults to false.`})}),_jsx(ParamField,{body:`on_end`,type:`'bill' | 'revert'`,id:`param-on-end-5`})]})]}),_jsxs(ParamField,{body:`billing_controls`,type:`object`,id:`param-billing-controls-3`,children:[_jsx(_components.p,{children:`Override the plan’s billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`auto_topups`,type:`object[]`,id:`param-auto-topups-3`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-26`,children:_jsx(_components.p,{children:`The ID of the feature (credit balance) to auto top-up.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-15`,children:_jsx(_components.p,{children:`Whether auto top-up is enabled.`})}),_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-11`,children:_jsx(_components.p,{children:`When the balance drops below this threshold, an auto top-up will be purchased.`})}),_jsx(ParamField,{body:`quantity`,type:`number`,required:true,id:`param-quantity-5`,children:_jsx(_components.p,{children:`Amount of credits to add per auto top-up.`})}),_jsxs(ParamField,{body:`purchase_limit`,type:`object`,id:`param-purchase-limit-3`,children:[_jsx(_components.p,{children:`Optional rate limit to cap how often auto top-ups occur. Pass count or amount to set the current window’s consumed top-ups or charged amount.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`limit_type`,type:`'count' | 'amount'`,id:`param-limit-type-6`,children:_jsxs(_components.p,{children:[`What `,_jsx(_components.code,{children:`limit`}),` caps: the number of auto top-ups (`,_jsx(_components.code,{children:`count`}),`, default) or the total amount charged for them, in the customer’s currency (`,_jsx(_components.code,{children:`amount`}),`).`]})}),_jsx(ParamField,{body:`interval`,type:`'hour' | 'day' | 'week' | 'month'`,required:true,id:`param-interval-25`,children:_jsx(_components.p,{children:`The time interval for the purchase limit window.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,required:true,id:`param-interval-count-22`,children:_jsx(_components.p,{children:`Number of intervals in the purchase limit window.`})}),_jsx(ParamField,{body:`limit`,type:`number`,required:true,id:`param-limit-6`,children:_jsx(_components.p,{children:`Maximum allowed within the interval: a number of auto top-ups when limit_type is count, or a total charge (e.g. 500 for $500, pre-tax) when limit_type is amount.`})}),_jsx(ParamField,{body:`count`,type:`number`,id:`param-count-1`,children:_jsx(_components.p,{children:`Set the current window’s consumed auto top-up count. Omit to leave runtime state unchanged.`})}),_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-33`,children:_jsx(_components.p,{children:`Set the amount already charged by auto top-ups in the current window. Omit to leave runtime state unchanged.`})})]})]}),_jsx(ParamField,{body:`invoice_mode`,type:`boolean`,id:`param-invoice-mode-3`,children:_jsx(_components.p,{children:`When true, auto top-up creates a send_invoice invoice instead of auto-charging.`})})]})}),_jsx(ParamField,{body:`spend_limits`,type:`object[]`,id:`param-spend-limits-3`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,id:`param-feature-id-27`,children:_jsx(_components.p,{children:`Optional feature ID this spend limit applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-16`,children:_jsx(_components.p,{children:`Whether the overage spend limit is enabled.`})}),_jsx(ParamField,{body:`limit_type`,type:`'absolute' | 'usage_percentage'`,id:`param-limit-type-7`,children:_jsx(_components.p,{children:`How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.`})}),_jsx(ParamField,{body:`overage_limit`,type:`number`,id:`param-overage-limit-3`,children:_jsx(_components.p,{children:`Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.`})}),_jsx(ParamField,{body:`skip_overage_billing`,type:`boolean`,id:`param-skip-overage-billing-3`,children:_jsx(_components.p,{children:`When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.`})})]})}),_jsx(ParamField,{body:`usage_limits`,type:`object[]`,id:`param-usage-limits-3`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-28`,children:_jsx(_components.p,{children:`The feature this usage limit applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-17`,children:_jsx(_components.p,{children:`Whether this usage limit is enabled.`})}),_jsx(ParamField,{body:`limit`,type:`number`,required:true,id:`param-limit-7`,children:_jsx(_components.p,{children:`Maximum units allowed per interval.`})}),_jsx(ParamField,{body:`interval`,type:`'day' | 'week' | 'month' | 'year'`,required:true,id:`param-interval-26`,children:_jsx(_components.p,{children:`Interval for the cap, aligned to the customer’s billing cycle.`})}),_jsx(ParamField,{body:`anchor`,type:`'billing_cycle' | 'utc'`,id:`param-anchor-3`,children:_jsx(_components.p,{children:`Window alignment. ‘billing_cycle’ phases the interval to the customer’s renewal time; ‘utc’ aligns to the UTC calendar.`})}),_jsxs(ParamField,{body:`filter`,type:`object`,id:`param-filter-6`,children:[_jsx(_components.p,{children:`When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`properties.{key}`,type:`string`,required:true,id:`param-properties-key-6`})})]})]})}),_jsx(ParamField,{body:`usage_alerts`,type:`object[]`,id:`param-usage-alerts-3`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,id:`param-feature-id-29`,children:_jsx(_components.p,{children:`The feature ID this alert applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-18`,children:_jsx(_components.p,{children:`Whether this usage alert is enabled.`})}),_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-12`,children:_jsx(_components.p,{children:`The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage. remaining and remaining_percentage accept negative values with basis balance, to alert once the balance is overdrawn.`})}),_jsx(ParamField,{body:`threshold_type`,type:`'usage' | 'usage_percentage' | 'remaining' | 'remaining_percentage'`,required:true,id:`param-threshold-type-3`,children:_jsx(_components.p,{children:`Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.`})}),_jsx(ParamField,{body:`basis`,type:`'balance' | 'included' | 'recurring' | 'usage_limit'`,required:true,id:`param-basis-3`,children:_jsx(_components.p,{children:`What 100% means. balance: every grant on the feature. included: the plan allowance only. recurring: grants that reset. usage_limit: the cap of the usage limit with the same feature and filter.`})}),_jsxs(ParamField,{body:`filter`,type:`object`,id:`param-filter-7`,children:[_jsx(_components.p,{children:`Only valid with basis usage_limit. Points the alert at the usage limit carrying the same filter.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`properties.{key}`,type:`string`,required:true,id:`param-properties-key-7`})})]}),_jsx(ParamField,{body:`name`,type:`string`,id:`param-name-7`,children:_jsx(_components.p,{children:`Optional user-defined label to distinguish multiple alerts on the same feature.`})})]})}),_jsx(ParamField,{body:`overage_allowed`,type:`object[]`,id:`param-overage-allowed-3`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-30`,children:_jsx(_components.p,{children:`The feature ID this overage allowed control applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-19`,children:_jsx(_components.p,{children:`Whether overage is allowed for this feature.`})})]})})]})]}),_jsxs(ParamField,{body:`upsert_licenses`,type:`object[]`,id:`param-upsert-licenses-1`,children:[_jsx(_components.p,{children:`planLicenses created or overridden. Same shape as customize.upsert_licenses / licenses[] entries.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`license_plan_id`,type:`string`,required:true,id:`param-license-plan-id-2`}),_jsx(ParamField,{body:`version_slug`,type:`string`,id:`param-version-slug-2`}),_jsx(ParamField,{body:`included`,type:`integer`,id:`param-included-9`}),_jsx(ParamField,{body:`prepaid_only`,type:`boolean`,id:`param-prepaid-only-1`}),_jsx(ParamField,{body:`customize`,type:`object | null`,id:`param-customize-3`,children:_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`price`,type:`object | null`,id:`param-price-9`,children:[_jsx(_components.p,{children:`Base price configuration for a plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-34`,children:_jsx(_components.p,{children:`Base price amount for the plan, in major currency units (e.g. dollars).`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-27`,children:_jsx(_components.p,{children:`Billing interval (e.g. ‘month’, ‘year’).`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-23`}),_jsxs(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-16`,children:[_jsx(_components.p,{children:`Base price amounts in additional currencies. The base ‘amount’ is in the org’s default currency.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-16`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-35`,children:_jsx(_components.p,{children:`Price amount in this currency. Set explicitly per currency, not converted from the base amount.`})})]})]})]})]}),_jsx(ParamField,{body:`add_items`,type:`object[]`,id:`param-add-items-3`,children:_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`threshold_billing`,type:`object | null`,id:`param-threshold-billing-5`,children:[_jsx(_components.p,{children:`Bills this many feature units when outstanding overage reaches it.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-13`})})]}),_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-31`,children:_jsx(_components.p,{children:`The ID of the feature to configure.`})}),_jsx(ParamField,{body:`included`,type:`number`,id:`param-included-10`,children:_jsx(_components.p,{children:`Number of free units included. Balance resets to this each interval for consumable features.`})}),_jsx(ParamField,{body:`unlimited`,type:`boolean`,id:`param-unlimited-5`,children:_jsx(_components.p,{children:`If true, customer has unlimited access to this feature.`})}),_jsx(ParamField,{body:`pooled`,type:`boolean`,id:`param-pooled-5`,children:_jsx(_components.p,{children:`Whether entity-level grants contribute to a shared customer balance.`})}),_jsxs(ParamField,{body:`reset`,type:`object`,id:`param-reset-5`,children:[_jsx(_components.p,{children:`Reset configuration for consumable features. Omit for non-consumable features like seats.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`interval`,type:`'one_off' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-28`,children:_jsx(_components.p,{children:`Interval at which balance resets (e.g. ‘month’, ‘year’). For consumable features only.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-24`})]})]}),_jsxs(ParamField,{body:`price`,type:`object`,id:`param-price-10`,children:[_jsx(_components.p,{children:`Pricing for usage beyond included units. Omit for free features.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-36`,children:_jsx(_components.p,{children:`Price per billing_units after included usage. Either ‘amount’ or ‘tiers’ is required.`})}),_jsxs(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-17`,children:[_jsx(_components.p,{children:`Amounts in additional currencies for this flat price. The base ‘amount’ is in the org’s default currency. Only valid with ‘amount’, not ‘tiers’.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-17`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-37`,children:_jsx(_components.p,{children:`Price amount in this currency. Set explicitly per currency, not converted from the base amount.`})})]})]}),_jsxs(ParamField,{body:`tiers`,type:`object[]`,id:`param-tiers-15`,children:[_jsx(_components.p,{children:`Tiered pricing. Either ‘amount’ or ‘tiers’ is required.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-15`}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-38`}),_jsx(ParamField,{body:`flat_amount`,type:`number`,id:`param-flat-amount-10`}),_jsx(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-18`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-18`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-39`,children:_jsx(_components.p,{children:`Per-unit amount for this tier in this currency.`})}),_jsx(ParamField,{body:`flat_amount`,type:`number`,id:`param-flat-amount-11`,children:_jsx(_components.p,{children:`Flat amount for this tier in this currency, if the tier uses one.`})})]})})]})]}),_jsx(ParamField,{body:`tier_behavior`,type:`'graduated' | 'volume'`,id:`param-tier-behavior-15`,children:_jsx(_components.p,{children:`How tiers price usage. ‘graduated’ (default) charges each unit at the rate of the tier it falls in. ‘volume’ picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier’s rate plus its flat_amount.`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-29`,children:_jsx(_components.p,{children:`Billing interval. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-25`,children:_jsx(_components.p,{children:`Number of intervals per billing cycle. Defaults to 1.`})}),_jsx(ParamField,{body:`billing_units`,type:`number`,id:`param-billing-units-10`,children:_jsx(_components.p,{children:`Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).`})}),_jsx(ParamField,{body:`billing_method`,type:`'prepaid' | 'usage_based'`,required:true,id:`param-billing-method-8`,children:_jsx(_components.p,{children:`‘prepaid’ for upfront payment (seats), ‘usage_based’ for pay-as-you-go.`})}),_jsx(ParamField,{body:`max_purchase`,type:`number | null`,id:`param-max-purchase-5`,children:_jsx(_components.p,{children:`Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.`})})]})]}),_jsxs(ParamField,{body:`proration`,type:`object`,id:`param-proration-3`,children:[_jsx(_components.p,{children:`Proration settings for prepaid features. Controls mid-cycle quantity change billing.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`on_increase`,type:`'bill_immediately' | 'prorate_immediately' | 'prorate_next_cycle' | 'bill_next_cycle'`,required:true,id:`param-on-increase-3`,children:_jsx(_components.p,{children:`Billing behavior when quantity increases mid-cycle.`})}),_jsx(ParamField,{body:`on_decrease`,type:`'prorate' | 'prorate_immediately' | 'prorate_next_cycle' | 'none' | 'no_prorations'`,required:true,id:`param-on-decrease-3`,children:_jsx(_components.p,{children:`Credit behavior when quantity decreases mid-cycle.`})})]})]}),_jsxs(ParamField,{body:`rollover`,type:`object`,id:`param-rollover-5`,children:[_jsx(_components.p,{children:`Rollover config for unused units. If set, unused included units carry over.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`max`,type:`number`,id:`param-max-5`,children:_jsx(_components.p,{children:`Max rollover units. Omit for unlimited rollover.`})}),_jsx(ParamField,{body:`max_percentage`,type:`number`,id:`param-max-percentage-5`,children:_jsx(_components.p,{children:`Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.`})}),_jsx(ParamField,{body:`expiry_duration_type`,type:`'month' | 'forever'`,required:true,id:`param-expiry-duration-type-5`,children:_jsx(_components.p,{children:`When rolled over units expire.`})}),_jsx(ParamField,{body:`expiry_duration_length`,type:`number`,id:`param-expiry-duration-length-5`,children:_jsx(_components.p,{children:`Number of periods before expiry.`})})]})]}),_jsxs(ParamField,{body:`expiry`,type:`object`,id:`param-expiry-5`,children:[_jsx(_components.p,{children:`Purchased units expire this long after each purchase. One-off prepaid consumable items only.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`duration`,type:`'day' | 'week' | 'month' | 'year'`,required:true,id:`param-duration-5`}),_jsx(ParamField,{body:`length`,type:`number`,required:true,id:`param-length-5`})]})]}),_jsxs(ParamField,{body:`feature_override`,type:`object`,id:`param-feature-override-5`,children:[_jsx(_components.p,{children:`Overrides fields of this item’s feature for customers on this plan (e.g. a credit system’s credit_schema).`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`credit_schema`,type:`object | object | object[]`,id:`param-credit-schema-7`,children:[_jsxs(_components.p,{children:[`For credit system features: merges into the feature’s credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `,_jsx(_components.code,{children:`excluded: true`}),` removes it, and unlisted features keep the credit system’s rate.`]}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`metered_feature_id`,type:`string`,id:`param-metered-feature-id-7`,children:_jsx(_components.p,{children:`ID of the metered feature that draws from this credit system.`})}),_jsx(ParamField,{body:`billing_units`,type:`number`,id:`param-billing-units-11`,children:_jsx(_components.p,{children:`Number of metered-feature units priced together. Defaults to one when omitted.`})}),_jsxs(ParamField,{body:`dimensions.{key}`,type:`object`,id:`param-dimensions-key-5`,children:[_jsx(_components.p,{children:`Named rates chosen by event properties. The most specific match sets the rate; with no match the item’s own rate applies.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`match.{key}`,type:`string`,required:true,id:`param-match-key-10`,children:_jsx(_components.p,{children:`Event properties this entry applies to. Every key must equal the tracked property, compared as strings.`})}),_jsx(ParamField,{body:`priority`,type:`integer`,id:`param-priority-5`,children:_jsx(_components.p,{children:`Breaks ties between dimensions that match the same number of keys. Higher wins.`})}),_jsx(ParamField,{body:`tier_behavior`,type:`string`,required:true,id:`param-tier-behavior-16`}),_jsx(ParamField,{body:`tiers`,type:`object[]`,required:true,id:`param-tiers-16`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-16`,children:_jsx(_components.p,{children:`Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-17`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group within this tier.`})})]})})]})]}),_jsxs(ParamField,{body:`multipliers.{key}`,type:`object`,id:`param-multipliers-key-5`,children:[_jsx(_components.p,{children:`Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`match.{key}`,type:`string`,required:true,id:`param-match-key-11`,children:_jsx(_components.p,{children:`Event properties this entry applies to. Every key must equal the tracked property, compared as strings.`})}),_jsx(ParamField,{body:`factor`,type:`number`,id:`param-factor-5`,children:_jsx(_components.p,{children:`Multiplies the matched rate. All matching multipliers stack.`})}),_jsx(ParamField,{body:`add`,type:`number`,id:`param-add-5`,children:_jsx(_components.p,{children:`Added to the rate after every factor is applied, in credits per billing-unit group.`})})]})]}),_jsx(ParamField,{body:`tier_behavior`,type:`string`,id:`param-tier-behavior-17`}),_jsx(ParamField,{body:`tiers`,type:`object[]`,id:`param-tiers-17`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-17`,children:_jsx(_components.p,{children:`Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-18`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group within this tier.`})})]})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,id:`param-credit-cost-19`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group.`})}),_jsx(ParamField,{body:`excluded`,type:`true`,id:`param-excluded-5`,children:_jsx(_components.p,{children:`Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.`})})]})]}),_jsxs(ParamField,{body:`markups`,type:`object`,id:`param-markups-5`,children:[_jsx(_components.p,{children:`For AI credit system features: replaces the feature’s markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature’s.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`default_markup`,type:`number`,id:`param-default-markup-5`,children:_jsx(_components.p,{children:`Default percentage markup for customers on this plan. Use -100 to make usage free.`})}),_jsxs(ParamField,{body:`provider_markups.{key}`,type:`object | null`,id:`param-provider-markups-key-5`,children:[_jsx(_components.p,{children:`Per-provider markup percentages for customers on this plan.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`markup`,type:`number`,required:true,id:`param-markup-10`})})]}),_jsxs(ParamField,{body:`model_markups.{key}`,type:`object | null`,id:`param-model-markups-key-5`,children:[_jsx(_components.p,{children:`Per-model markup overrides for customers on this plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`markup`,type:`number`,id:`param-markup-11`}),_jsx(ParamField,{body:`input_cost`,type:`number`,id:`param-input-cost-5`}),_jsx(ParamField,{body:`output_cost`,type:`number`,id:`param-output-cost-5`})]})]})]})]})]})]})]})}),_jsx(ParamField,{body:`remove_items`,type:`object[]`,id:`param-remove-items-3`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,id:`param-feature-id-32`,children:_jsx(_components.p,{children:`Match items linked to this feature.`})}),_jsx(ParamField,{body:`billing_method`,type:`'prepaid' | 'usage_based'`,id:`param-billing-method-9`,children:_jsx(_components.p,{children:`Match items with this billing method (prepaid or usage_based).`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,id:`param-interval-30`,children:_jsx(_components.p,{children:`Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.`})}),_jsx(ParamField,{body:`interval_count`,type:`integer`,id:`param-interval-count-26`,children:_jsx(_components.p,{children:`Match items with this interval_count. Disambiguates between items that share an interval but differ in count.`})}),_jsx(ParamField,{body:`included`,type:`number`,id:`param-included-11`,children:_jsx(_components.p,{children:`Match items whose grant equals this included usage. Omitted is a wildcard.`})})]})})]})}),_jsx(ParamField,{body:`metadata`,type:`object`,id:`param-metadata-3`})]})]}),_jsxs(ParamField,{body:`remove_licenses`,type:`object[]`,id:`param-remove-licenses-1`,children:[_jsx(_components.p,{children:`planLicenses dropped from this plan.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`license_plan_id`,type:`string`,required:true,id:`param-license-plan-id-3`})})]})]})]}),_jsxs(ParamField,{body:`license_changes`,type:`object[]`,id:`param-license-changes`,children:[_jsx(_components.p,{children:`planLicenses created, updated, or removed on this plan. Omitted when none. Nested plan_change is core-only.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`license_plan_id`,type:`string`,required:true,id:`param-license-plan-id-4`,children:_jsx(_components.p,{children:`The plan offered as a license under this plan.`})}),_jsx(ParamField,{body:`version`,type:`integer`,required:true,id:`param-version-1`,children:_jsx(_components.p,{children:`The exact license-plan version pinned by this link.`})}),_jsx(ParamField,{body:`version_slug`,type:`string`,id:`param-version-slug-3`,children:_jsx(_components.p,{children:`Version slug of the license-plan row this link points at.`})}),_jsx(ParamField,{body:`included`,type:`number`,required:true,id:`param-included-12`,children:_jsx(_components.p,{children:`Number of license assignments included with this plan for free.`})}),_jsx(ParamField,{body:`metadata`,type:`object`,id:`param-metadata-4`,children:_jsx(_components.p,{children:`Arbitrary key-value metadata defined by you on this link.`})}),_jsxs(ParamField,{body:`plan`,type:`object`,id:`param-plan-1`,children:[_jsx(_components.p,{children:`The effective plan for this license link — the pinned version, with the link’s customize applied. Present when license plans are expanded.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`id`,type:`string`,required:true,id:`param-id-4`,children:_jsx(_components.p,{children:`Unique identifier for the plan.`})}),_jsx(ParamField,{body:`name`,type:`string`,required:true,id:`param-name-8`,children:_jsx(_components.p,{children:`Display name of the plan.`})}),_jsx(ParamField,{body:`description`,type:`string | null`,required:true,id:`param-description-2`,children:_jsx(_components.p,{children:`Optional description of the plan.`})}),_jsx(ParamField,{body:`group`,type:`string | null`,required:true,id:`param-group-2`,children:_jsx(_components.p,{children:`Group identifier for organizing related plans. Plans in the same group are mutually exclusive.`})}),_jsx(ParamField,{body:`version`,type:`number`,required:true,id:`param-version-2`,children:_jsx(_components.p,{children:`Version number of the plan. Incremented when plan configuration changes.`})}),_jsx(ParamField,{body:`version_slug`,type:`string | null`,id:`param-version-slug-4`,children:_jsx(_components.p,{children:`User-facing version identity. Defaults to v{n} when the version is minted.`})}),_jsx(ParamField,{body:`active`,type:`boolean`,id:`param-active-2`,children:_jsx(_components.p,{children:`Whether this is the active version of the plan. At most one version is active.`})}),_jsx(ParamField,{body:`add_on`,type:`boolean`,required:true,id:`param-add-on-2`,children:_jsx(_components.p,{children:`Whether this is an add-on plan that can be attached alongside a main plan.`})}),_jsx(ParamField,{body:`auto_enable`,type:`boolean`,required:true,id:`param-auto-enable-2`,children:_jsx(_components.p,{children:`If true, this plan is automatically attached when a customer is created. Used for free plans.`})}),_jsxs(ParamField,{body:`price`,type:`object | null`,required:true,id:`param-price-11`,children:[_jsx(_components.p,{children:`Base recurring price for the plan. Null for free plans or usage-only plans.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-40`,children:_jsx(_components.p,{children:`Base price amount for the plan, in major currency units (e.g. dollars).`})}),_jsxs(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-19`,children:[_jsx(_components.p,{children:`Base price amounts in additional currencies. The base ‘amount’ is in the org’s default currency.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-19`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-41`,children:_jsx(_components.p,{children:`Price amount in this currency. Set explicitly per currency, not converted from the base amount.`})})]})]}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-31`,children:_jsx(_components.p,{children:`Billing interval (e.g. ‘month’, ‘year’).`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-27`,children:_jsx(_components.p,{children:`Number of intervals per billing cycle. Defaults to 1.`})}),_jsxs(ParamField,{body:`display`,type:`object`,id:`param-display-7`,children:[_jsx(_components.p,{children:`Display text for showing this price in pricing pages.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`primary_text`,type:`string`,required:true,id:`param-primary-text-5`,children:_jsx(_components.p,{children:`Main display text (e.g. ‘$10’ or ‘100 messages’).`})}),_jsx(ParamField,{body:`secondary_text`,type:`string`,id:`param-secondary-text-5`,children:_jsx(_components.p,{children:`Secondary display text (e.g. ‘per month’ or ‘then $0.5 per 100’).`})})]})]}),_jsxs(ParamField,{body:`processors`,type:`object`,id:`param-processors-7`,children:[_jsx(_components.p,{children:`Payment processors this base price is connected to. Omitted when unset.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`stripe`,type:`object | null`,id:`param-stripe-7`,children:_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`price_id`,type:`string`,required:true,id:`param-price-id-5`,children:_jsx(_components.p,{children:`Stripe price ID. For prepaid with included > 0 this is the V2 price.`})})})})})]})]})]}),_jsxs(ParamField,{body:`items`,type:`object[]`,required:true,id:`param-items-1`,children:[_jsx(_components.p,{children:`Feature configurations included in this plan. Each item defines included units, pricing, and reset behavior for a feature.`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`threshold_billing`,type:`object | null`,id:`param-threshold-billing-6`,children:[_jsx(_components.p,{children:`Bills this many feature units when outstanding overage reaches it.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-14`})})]}),_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-33`,children:_jsx(_components.p,{children:`The ID of the feature this item configures.`})}),_jsxs(ParamField,{body:`feature`,type:`object`,id:`param-feature-2`,children:[_jsx(_components.p,{children:`The full feature object if expanded.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`id`,type:`string`,required:true,id:`param-id-5`,children:_jsx(_components.p,{children:`The ID of the feature, used to refer to it in other API calls like /track or /check.`})}),_jsx(ParamField,{body:`name`,type:`string | null`,id:`param-name-9`,children:_jsx(_components.p,{children:`The name of the feature.`})}),_jsx(ParamField,{body:`type`,type:`'static' | 'boolean' | 'single_use' | 'continuous_use' | 'credit_system' | 'ai_credit_system'`,required:true,id:`param-type-2`,children:_jsx(_components.p,{children:`The type of the feature`})}),_jsxs(ParamField,{body:`display`,type:`object | null`,id:`param-display-8`,children:[_jsx(_components.p,{children:`Singular and plural display names for the feature.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`singular`,type:`string`,required:true,id:`param-singular-2`,children:_jsx(_components.p,{children:`The singular display name for the feature.`})}),_jsx(ParamField,{body:`plural`,type:`string`,required:true,id:`param-plural-2`,children:_jsx(_components.p,{children:`The plural display name for the feature.`})})]})]}),_jsxs(ParamField,{body:`credit_schema`,type:`object[] | null`,id:`param-credit-schema-8`,children:[_jsx(_components.p,{children:`Credit cost schema for credit system features.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`metered_feature_id`,type:`string`,required:true,id:`param-metered-feature-id-8`,children:_jsx(_components.p,{children:`The ID of the metered feature (should be a single_use feature).`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-20`,children:_jsx(_components.p,{children:`The credit cost of the metered feature.`})})]})]}),_jsx(ParamField,{body:`archived`,type:`boolean | null`,id:`param-archived-4`,children:_jsx(_components.p,{children:`Whether or not the feature is archived.`})})]})]}),_jsx(ParamField,{body:`included`,type:`number`,required:true,id:`param-included-13`,children:_jsx(_components.p,{children:`Number of free units included. For consumable features, balance resets to this number each interval.`})}),_jsx(ParamField,{body:`unlimited`,type:`boolean`,required:true,id:`param-unlimited-6`,children:_jsx(_components.p,{children:`Whether the customer has unlimited access to this feature.`})}),_jsx(ParamField,{body:`pooled`,type:`boolean`,id:`param-pooled-6`,children:_jsx(_components.p,{children:`Whether entity-level grants contribute to a shared customer balance.`})}),_jsxs(ParamField,{body:`reset`,type:`object | null`,required:true,id:`param-reset-6`,children:[_jsx(_components.p,{children:`Reset configuration for consumable features. Null for non-consumable features like seats where usage persists across billing cycles.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`interval`,type:`'one_off' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-32`,children:_jsx(_components.p,{children:`The interval at which the feature balance resets (e.g. ‘month’, ‘year’). For consumable features, usage resets to 0 and included units are restored.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-28`,children:_jsx(_components.p,{children:`Number of intervals between resets. Defaults to 1.`})})]})]}),_jsxs(ParamField,{body:`price`,type:`object | null`,required:true,id:`param-price-12`,children:[_jsx(_components.p,{children:`Pricing configuration for usage beyond included units. Null if feature is entirely free.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-42`,children:_jsx(_components.p,{children:`Price per billing_units after included usage is consumed. Mutually exclusive with tiers.`})}),_jsxs(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-20`,children:[_jsx(_components.p,{children:`Amounts in additional currencies for this flat price. The base ‘amount’ is in the org’s default currency. Only valid with ‘amount’, not ‘tiers’ (tiered prices carry per-currency amounts on each tier).`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-20`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-43`,children:_jsx(_components.p,{children:`Price amount in this currency. Set explicitly per currency, not converted from the base amount.`})})]})]}),_jsxs(ParamField,{body:`tiers`,type:`object[]`,id:`param-tiers-18`,children:[_jsx(_components.p,{children:`Tiered pricing configuration. Each tier’s ‘to’ INCLUDES the included amount. Either ‘tiers’ or ‘amount’ is required.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-18`}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-44`}),_jsx(ParamField,{body:`flat_amount`,type:`number`,id:`param-flat-amount-12`}),_jsx(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-21`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-21`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-45`,children:_jsx(_components.p,{children:`Per-unit amount for this tier in this currency.`})}),_jsx(ParamField,{body:`flat_amount`,type:`number`,id:`param-flat-amount-13`,children:_jsx(_components.p,{children:`Flat amount for this tier in this currency, if the tier uses one.`})})]})})]})]}),_jsx(ParamField,{body:`tier_behavior`,type:`'graduated' | 'volume'`,id:`param-tier-behavior-18`,children:_jsx(_components.p,{children:`How tiers price usage. ‘graduated’ (default) charges each unit at the rate of the tier it falls in. ‘volume’ picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier’s rate plus its flat_amount.`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-33`,children:_jsx(_components.p,{children:`Billing interval for this price. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-29`,children:_jsx(_components.p,{children:`Number of intervals per billing cycle. Defaults to 1.`})}),_jsx(ParamField,{body:`billing_units`,type:`number`,required:true,id:`param-billing-units-12`,children:_jsx(_components.p,{children:`Number of units per price increment. Usage is rounded UP to the nearest billing_units when billed (e.g. billing_units=100 means 101 usage rounds to 200).`})}),_jsx(ParamField,{body:`billing_method`,type:`'prepaid' | 'usage_based'`,required:true,id:`param-billing-method-10`,children:_jsx(_components.p,{children:`‘prepaid’ for features like seats where customers pay upfront, ‘usage_based’ for pay-as-you-go after included usage.`})}),_jsx(ParamField,{body:`max_purchase`,type:`number | null`,required:true,id:`param-max-purchase-6`,children:_jsx(_components.p,{children:`Maximum units a customer can purchase beyond included. E.g. if included=100 and max_purchase=300, customer can use up to 400 total before usage is capped. Null for no limit.`})}),_jsxs(ParamField,{body:`processors`,type:`object`,id:`param-processors-8`,children:[_jsx(_components.p,{children:`Payment processors this item price is connected to. Omitted when unset.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`stripe`,type:`object | null`,id:`param-stripe-8`,children:_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`price_id`,type:`string`,required:true,id:`param-price-id-6`,children:_jsx(_components.p,{children:`Stripe price ID. For prepaid with included > 0 this is the V2 price.`})})})})})]})]})]}),_jsxs(ParamField,{body:`display`,type:`object`,id:`param-display-9`,children:[_jsx(_components.p,{children:`Display text for showing this item in pricing pages.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`primary_text`,type:`string`,required:true,id:`param-primary-text-6`,children:_jsx(_components.p,{children:`Main display text (e.g. ‘$10’ or ‘100 messages’).`})}),_jsx(ParamField,{body:`secondary_text`,type:`string`,id:`param-secondary-text-6`,children:_jsx(_components.p,{children:`Secondary display text (e.g. ‘per month’ or ‘then $0.5 per 100’).`})})]})]}),_jsxs(ParamField,{body:`rollover`,type:`object`,id:`param-rollover-6`,children:[_jsx(_components.p,{children:`Rollover configuration for unused units. If set, unused included units roll over to the next period.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`max`,type:`number | null`,required:true,id:`param-max-6`,children:_jsx(_components.p,{children:`Maximum rollover units. Null for unlimited rollover.`})}),_jsx(ParamField,{body:`max_percentage`,type:`number | null`,id:`param-max-percentage-6`,children:_jsx(_components.p,{children:`Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.`})}),_jsx(ParamField,{body:`expiry_duration_type`,type:`'month' | 'forever'`,required:true,id:`param-expiry-duration-type-6`,children:_jsx(_components.p,{children:`When rolled over units expire.`})}),_jsx(ParamField,{body:`expiry_duration_length`,type:`number`,id:`param-expiry-duration-length-6`,children:_jsx(_components.p,{children:`Number of periods before expiry.`})})]})]}),_jsxs(ParamField,{body:`expiry`,type:`object | null`,id:`param-expiry-6`,children:[_jsx(_components.p,{children:`Purchased units expire this long after each purchase. One-off prepaid consumable items only.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`duration`,type:`'day' | 'week' | 'month' | 'year'`,required:true,id:`param-duration-6`}),_jsx(ParamField,{body:`length`,type:`number`,required:true,id:`param-length-6`})]})]}),_jsxs(ParamField,{body:`feature_override`,type:`object`,id:`param-feature-override-6`,children:[_jsx(_components.p,{children:`Overrides fields of this item’s feature for customers on this plan (e.g. a credit system’s credit_schema).`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`credit_schema`,type:`object | object | object[]`,id:`param-credit-schema-9`,children:[_jsxs(_components.p,{children:[`For credit system features: merges into the feature’s credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `,_jsx(_components.code,{children:`excluded: true`}),` removes it, and unlisted features keep the credit system’s rate.`]}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`metered_feature_id`,type:`string`,id:`param-metered-feature-id-9`,children:_jsx(_components.p,{children:`ID of the metered feature that draws from this credit system.`})}),_jsx(ParamField,{body:`billing_units`,type:`number`,id:`param-billing-units-13`,children:_jsx(_components.p,{children:`Number of metered-feature units priced together. Defaults to one when omitted.`})}),_jsxs(ParamField,{body:`dimensions.{key}`,type:`object`,id:`param-dimensions-key-6`,children:[_jsx(_components.p,{children:`Named rates chosen by event properties. The most specific match sets the rate; with no match the item’s own rate applies.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`match.{key}`,type:`string`,required:true,id:`param-match-key-12`,children:_jsx(_components.p,{children:`Event properties this entry applies to. Every key must equal the tracked property, compared as strings.`})}),_jsx(ParamField,{body:`priority`,type:`integer`,id:`param-priority-6`,children:_jsx(_components.p,{children:`Breaks ties between dimensions that match the same number of keys. Higher wins.`})}),_jsx(ParamField,{body:`tier_behavior`,type:`string`,required:true,id:`param-tier-behavior-19`}),_jsx(ParamField,{body:`tiers`,type:`object[]`,required:true,id:`param-tiers-19`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-19`,children:_jsx(_components.p,{children:`Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-21`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group within this tier.`})})]})})]})]}),_jsxs(ParamField,{body:`multipliers.{key}`,type:`object`,id:`param-multipliers-key-6`,children:[_jsx(_components.p,{children:`Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`match.{key}`,type:`string`,required:true,id:`param-match-key-13`,children:_jsx(_components.p,{children:`Event properties this entry applies to. Every key must equal the tracked property, compared as strings.`})}),_jsx(ParamField,{body:`factor`,type:`number`,id:`param-factor-6`,children:_jsx(_components.p,{children:`Multiplies the matched rate. All matching multipliers stack.`})}),_jsx(ParamField,{body:`add`,type:`number`,id:`param-add-6`,children:_jsx(_components.p,{children:`Added to the rate after every factor is applied, in credits per billing-unit group.`})})]})]}),_jsx(ParamField,{body:`tier_behavior`,type:`string`,id:`param-tier-behavior-20`}),_jsx(ParamField,{body:`tiers`,type:`object[]`,id:`param-tiers-20`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-20`,children:_jsx(_components.p,{children:`Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-22`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group within this tier.`})})]})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,id:`param-credit-cost-23`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group.`})}),_jsx(ParamField,{body:`excluded`,type:`true`,id:`param-excluded-6`,children:_jsx(_components.p,{children:`Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.`})})]})]}),_jsxs(ParamField,{body:`markups`,type:`object`,id:`param-markups-6`,children:[_jsx(_components.p,{children:`For AI credit system features: replaces the feature’s markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature’s.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`default_markup`,type:`number`,id:`param-default-markup-6`,children:_jsx(_components.p,{children:`Default percentage markup for customers on this plan. Use -100 to make usage free.`})}),_jsxs(ParamField,{body:`provider_markups.{key}`,type:`object | null`,id:`param-provider-markups-key-6`,children:[_jsx(_components.p,{children:`Per-provider markup percentages for customers on this plan.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`markup`,type:`number`,required:true,id:`param-markup-12`})})]}),_jsxs(ParamField,{body:`model_markups.{key}`,type:`object | null`,id:`param-model-markups-key-6`,children:[_jsx(_components.p,{children:`Per-model markup overrides for customers on this plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`markup`,type:`number`,id:`param-markup-13`}),_jsx(ParamField,{body:`input_cost`,type:`number`,id:`param-input-cost-6`}),_jsx(ParamField,{body:`output_cost`,type:`number`,id:`param-output-cost-6`})]})]})]})]})]})]})]})]}),_jsxs(ParamField,{body:`processors`,type:`object`,id:`param-processors-9`,children:[_jsx(_components.p,{children:`Payment processors this plan is connected to. Omitted when unset.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`stripe`,type:`object | null`,id:`param-stripe-9`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`product_id`,type:`string`,required:true,id:`param-product-id-4`,children:_jsx(_components.p,{children:`Stripe product ID this plan is billed under.`})}),_jsx(ParamField,{body:`additional_product_ids`,type:`string[]`,id:`param-additional-product-ids-2`,children:_jsx(_components.p,{children:`Extra Stripe product IDs aliased to this plan.`})})]})}),_jsx(ParamField,{body:`revenuecat`,type:`object | null`,id:`param-revenuecat-2`,children:_jsx(Expandable,{title:`properties`,children:_jsxs(ParamField,{body:`products`,type:`object[]`,required:true,id:`param-products-2`,children:[_jsx(_components.p,{children:`Every RevenueCat product that maps to this plan. Replaces the current set.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`product_id`,type:`string`,required:true,id:`param-product-id-5`,children:_jsx(_components.p,{children:`RevenueCat product ID that grants this plan when purchased.`})}),_jsxs(ParamField,{body:`feature_quantities`,type:`object[]`,id:`param-feature-quantities-2`,children:[_jsx(_components.p,{children:`Prepaid quantities granted when this specific RevenueCat product is purchased, in feature units.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-34`}),_jsx(ParamField,{body:`quantity`,type:`number`,id:`param-quantity-6`})]})]})]})]})})})]})]}),_jsxs(ParamField,{body:`free_trial`,type:`object`,id:`param-free-trial-4`,children:[_jsx(_components.p,{children:`Free trial configuration. If set, new customers can try this plan before being charged.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`duration_length`,type:`number`,required:true,id:`param-duration-length-6`,children:_jsx(_components.p,{children:`Number of duration_type periods the trial lasts.`})}),_jsx(ParamField,{body:`duration_type`,type:`'day' | 'month' | 'year'`,required:true,id:`param-duration-type-6`,children:_jsx(_components.p,{children:`Unit of time for the trial duration (‘day’, ‘month’, ‘year’).`})}),_jsx(ParamField,{body:`card_required`,type:`boolean`,required:true,id:`param-card-required-6`,children:_jsx(_components.p,{children:`Whether a payment method is required to start the trial. If true, customer will be charged after trial ends.`})}),_jsx(ParamField,{body:`on_end`,type:`'bill' | 'revert'`,id:`param-on-end-6`,children:_jsx(_components.p,{children:`Behavior when the trial ends. ‘bill’ charges the customer (default). ‘revert’ expires the trial and restores the customer’s previous plan.`})})]})]}),_jsx(ParamField,{body:`created_at`,type:`number`,required:true,id:`param-created-at-1`,children:_jsx(_components.p,{children:`Unix timestamp (ms) when the plan was created.`})}),_jsx(ParamField,{body:`env`,type:`'sandbox' | 'live'`,required:true,id:`param-env-1`,children:_jsx(_components.p,{children:`Environment this plan belongs to (‘sandbox’ or ‘live’).`})}),_jsx(ParamField,{body:`archived`,type:`boolean`,required:true,id:`param-archived-5`,children:_jsx(_components.p,{children:`Whether the plan is archived. Archived plans cannot be attached to new customers.`})}),_jsxs(ParamField,{body:`config`,type:`object`,required:true,id:`param-config-2`,children:[_jsx(_components.p,{children:`Miscellaneous plan-level configuration flags.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`ignore_past_due`,type:`boolean`,required:true,id:`param-ignore-past-due-2`,children:_jsx(_components.p,{children:`If true, entitlements attached to this plan will still reset on schedule even when the customer’s product is in a past_due state.`})}),_jsx(ParamField,{body:`anchor_to_month_start`,type:`boolean`,id:`param-anchor-to-month-start-2`})]})]}),_jsxs(ParamField,{body:`billing_controls`,type:`object`,id:`param-billing-controls-4`,children:[_jsx(_components.p,{children:`Plan-level billing controls used as customer defaults.`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`auto_topups`,type:`object[]`,id:`param-auto-topups-4`,children:[_jsx(_components.p,{children:`List of auto top-up configurations per feature.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-35`,children:_jsx(_components.p,{children:`The ID of the feature (credit balance) to auto top-up.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-20`,children:_jsx(_components.p,{children:`Whether auto top-up is enabled.`})}),_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-15`,children:_jsx(_components.p,{children:`When the balance drops below this threshold, an auto top-up will be purchased.`})}),_jsx(ParamField,{body:`quantity`,type:`number`,required:true,id:`param-quantity-7`,children:_jsx(_components.p,{children:`Amount of credits to add per auto top-up.`})}),_jsxs(ParamField,{body:`purchase_limit`,type:`object`,id:`param-purchase-limit-4`,children:[_jsx(_components.p,{children:`Optional limit on auto top-ups per window, by number of top-ups or amount charged.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`limit_type`,type:`'count' | 'amount'`,id:`param-limit-type-8`,children:_jsxs(_components.p,{children:[`What `,_jsx(_components.code,{children:`limit`}),` caps: the number of auto top-ups (`,_jsx(_components.code,{children:`count`}),`, default) or the total amount charged for them, in the customer’s currency (`,_jsx(_components.code,{children:`amount`}),`).`]})}),_jsx(ParamField,{body:`interval`,type:`'hour' | 'day' | 'week' | 'month'`,required:true,id:`param-interval-34`,children:_jsx(_components.p,{children:`The time interval for the purchase limit window.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,required:true,id:`param-interval-count-30`,children:_jsx(_components.p,{children:`Number of intervals in the purchase limit window.`})}),_jsx(ParamField,{body:`limit`,type:`number`,required:true,id:`param-limit-8`,children:_jsx(_components.p,{children:`Maximum allowed within the interval: a number of auto top-ups when limit_type is count, or a total charge (e.g. 500 for $500, pre-tax) when limit_type is amount.`})})]})]}),_jsx(ParamField,{body:`invoice_mode`,type:`boolean`,id:`param-invoice-mode-4`,children:_jsx(_components.p,{children:`When true, auto top-up creates a send_invoice invoice instead of auto-charging.`})})]})]}),_jsxs(ParamField,{body:`spend_limits`,type:`object[]`,id:`param-spend-limits-4`,children:[_jsx(_components.p,{children:`List of overage spend limits per feature (caps overage spend).`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,id:`param-feature-id-36`,children:_jsx(_components.p,{children:`Optional feature ID this spend limit applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-21`,children:_jsx(_components.p,{children:`Whether the overage spend limit is enabled.`})}),_jsx(ParamField,{body:`limit_type`,type:`'absolute' | 'usage_percentage'`,id:`param-limit-type-9`,children:_jsx(_components.p,{children:`How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.`})}),_jsx(ParamField,{body:`overage_limit`,type:`number`,id:`param-overage-limit-4`,children:_jsx(_components.p,{children:`Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.`})}),_jsx(ParamField,{body:`skip_overage_billing`,type:`boolean`,id:`param-skip-overage-billing-4`,children:_jsx(_components.p,{children:`When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.`})})]})]}),_jsxs(ParamField,{body:`usage_limits`,type:`object[]`,id:`param-usage-limits-4`,children:[_jsx(_components.p,{children:`List of hard usage caps per feature (max units per interval).`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-37`,children:_jsx(_components.p,{children:`The feature this usage limit applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-22`,children:_jsx(_components.p,{children:`Whether this usage limit is enabled.`})}),_jsx(ParamField,{body:`limit`,type:`number`,required:true,id:`param-limit-9`,children:_jsx(_components.p,{children:`Maximum units allowed per interval.`})}),_jsx(ParamField,{body:`interval`,type:`'day' | 'week' | 'month' | 'year'`,required:true,id:`param-interval-35`,children:_jsx(_components.p,{children:`Interval for the cap, aligned to the customer’s billing cycle.`})}),_jsx(ParamField,{body:`anchor`,type:`'billing_cycle' | 'utc'`,id:`param-anchor-4`,children:_jsx(_components.p,{children:`Window alignment. ‘billing_cycle’ phases the interval to the customer’s renewal time; ‘utc’ aligns to the UTC calendar.`})}),_jsxs(ParamField,{body:`filter`,type:`object`,id:`param-filter-8`,children:[_jsx(_components.p,{children:`When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`properties.{key}`,type:`string`,required:true,id:`param-properties-key-8`})})]})]})]}),_jsxs(ParamField,{body:`usage_alerts`,type:`object[]`,id:`param-usage-alerts-4`,children:[_jsx(_components.p,{children:`List of usage alert configurations per feature.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,id:`param-feature-id-38`,children:_jsx(_components.p,{children:`The feature ID this alert applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-23`,children:_jsx(_components.p,{children:`Whether this usage alert is enabled.`})}),_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-16`,children:_jsx(_components.p,{children:`The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage. remaining and remaining_percentage accept negative values with basis balance, to alert once the balance is overdrawn.`})}),_jsx(ParamField,{body:`threshold_type`,type:`'usage' | 'usage_percentage' | 'remaining' | 'remaining_percentage'`,required:true,id:`param-threshold-type-4`,children:_jsx(_components.p,{children:`Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.`})}),_jsx(ParamField,{body:`basis`,type:`'balance' | 'included' | 'recurring' | 'usage_limit'`,required:true,id:`param-basis-4`,children:_jsx(_components.p,{children:`What 100% means. balance: every grant on the feature. included: the plan allowance only. recurring: grants that reset. usage_limit: the cap of the usage limit with the same feature and filter.`})}),_jsxs(ParamField,{body:`filter`,type:`object`,id:`param-filter-9`,children:[_jsx(_components.p,{children:`Only valid with basis usage_limit. Points the alert at the usage limit carrying the same filter.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`properties.{key}`,type:`string`,required:true,id:`param-properties-key-9`})})]}),_jsx(ParamField,{body:`name`,type:`string`,id:`param-name-10`,children:_jsx(_components.p,{children:`Optional user-defined label to distinguish multiple alerts on the same feature.`})})]})]}),_jsxs(ParamField,{body:`overage_allowed`,type:`object[]`,id:`param-overage-allowed-4`,children:[_jsx(_components.p,{children:`List of overage allowed controls per feature. When enabled, usage can exceed balance.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-39`,children:_jsx(_components.p,{children:`The feature ID this overage allowed control applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-24`,children:_jsx(_components.p,{children:`Whether overage is allowed for this feature.`})})]})]})]})]}),_jsx(ParamField,{body:`metadata`,type:`object`,required:true,id:`param-metadata-5`,children:_jsx(_components.p,{children:`Arbitrary key-value metadata defined by you for your own use. Shared across all versions of the plan.`})}),_jsx(ParamField,{body:`customer_eligibility`,type:`object`,id:`param-customer-eligibility-1`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`trial_available`,type:`boolean`,id:`param-trial-available-1`,children:_jsx(_components.p,{children:`Whether the trial on this plan is available to this customer. For example, if the customer used the trial in the past, this will be false.`})}),_jsx(ParamField,{body:`status`,type:`'active' | 'scheduled'`,id:`param-status-4`,children:_jsx(_components.p,{children:`The customer’s current status with this plan. ‘active’ if attached, ‘scheduled’ if pending activation.`})}),_jsx(ParamField,{body:`canceling`,type:`boolean`,id:`param-canceling-1`,children:_jsx(_components.p,{children:`Whether the customer’s active instance of this plan is set to cancel.`})}),_jsx(ParamField,{body:`trialing`,type:`boolean`,id:`param-trialing-1`,children:_jsx(_components.p,{children:`Whether the customer is currently on a free trial of this plan.`})}),_jsx(ParamField,{body:`attach_action`,type:`'activate' | 'upgrade' | 'downgrade' | 'none' | 'purchase'`,required:true,id:`param-attach-action-1`,children:_jsx(_components.p,{children:`The action that would occur if this plan were attached to the customer.`})})]})}),_jsx(ParamField,{body:`base_variant_id`,type:`string | null`,required:true,id:`param-base-variant-id-2`,children:_jsx(_components.p,{children:`Deprecated. Use variant_details.base_plan_id instead. If this is a variant, the ID of the base plan it was created from.`})}),_jsxs(ParamField,{body:`variant_details`,type:`object`,id:`param-variant-details-1`,children:[_jsx(_components.p,{children:`Details about how this variant relates to its latest base plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`base_plan_id`,type:`string`,required:true,id:`param-base-plan-id-1`,children:_jsx(_components.p,{children:`The ID of the base plan this variant was derived from.`})}),_jsxs(ParamField,{body:`customize`,type:`object`,id:`param-customize-4`,children:[_jsx(_components.p,{children:`The customization that transforms the base plan into this variant.`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`price`,type:`object | null`,id:`param-price-13`,children:[_jsx(_components.p,{children:`Base price configuration for a plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-46`,children:_jsx(_components.p,{children:`Base price amount for the plan, in major currency units (e.g. dollars).`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-36`,children:_jsx(_components.p,{children:`Billing interval (e.g. ‘month’, ‘year’).`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-31`}),_jsxs(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-22`,children:[_jsx(_components.p,{children:`Base price amounts in additional currencies. The base ‘amount’ is in the org’s default currency.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-22`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-47`,children:_jsx(_components.p,{children:`Price amount in this currency. Set explicitly per currency, not converted from the base amount.`})})]})]})]})]}),_jsxs(ParamField,{body:`add_items`,type:`object[]`,id:`param-add-items-4`,children:[_jsx(_components.p,{children:`Items to add to the plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`threshold_billing`,type:`object | null`,id:`param-threshold-billing-7`,children:[_jsx(_components.p,{children:`Bills this many feature units when outstanding overage reaches it.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-17`})})]}),_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-40`,children:_jsx(_components.p,{children:`The ID of the feature to configure.`})}),_jsx(ParamField,{body:`included`,type:`number`,id:`param-included-14`,children:_jsx(_components.p,{children:`Number of free units included. Balance resets to this each interval for consumable features.`})}),_jsx(ParamField,{body:`unlimited`,type:`boolean`,id:`param-unlimited-7`,children:_jsx(_components.p,{children:`If true, customer has unlimited access to this feature.`})}),_jsx(ParamField,{body:`pooled`,type:`boolean`,id:`param-pooled-7`,children:_jsx(_components.p,{children:`Whether entity-level grants contribute to a shared customer balance.`})}),_jsxs(ParamField,{body:`reset`,type:`object`,id:`param-reset-7`,children:[_jsx(_components.p,{children:`Reset configuration for consumable features. Omit for non-consumable features like seats.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`interval`,type:`'one_off' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-37`,children:_jsx(_components.p,{children:`Interval at which balance resets (e.g. ‘month’, ‘year’). For consumable features only.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-32`})]})]}),_jsxs(ParamField,{body:`price`,type:`object`,id:`param-price-14`,children:[_jsx(_components.p,{children:`Pricing for usage beyond included units. Omit for free features.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-48`,children:_jsx(_components.p,{children:`Price per billing_units after included usage. Either ‘amount’ or ‘tiers’ is required.`})}),_jsxs(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-23`,children:[_jsx(_components.p,{children:`Amounts in additional currencies for this flat price. The base ‘amount’ is in the org’s default currency. Only valid with ‘amount’, not ‘tiers’.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-23`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-49`,children:_jsx(_components.p,{children:`Price amount in this currency. Set explicitly per currency, not converted from the base amount.`})})]})]}),_jsxs(ParamField,{body:`tiers`,type:`object[]`,id:`param-tiers-21`,children:[_jsx(_components.p,{children:`Tiered pricing. Either ‘amount’ or ‘tiers’ is required.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-21`}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-50`}),_jsx(ParamField,{body:`flat_amount`,type:`number`,id:`param-flat-amount-14`}),_jsx(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-24`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-24`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-51`,children:_jsx(_components.p,{children:`Per-unit amount for this tier in this currency.`})}),_jsx(ParamField,{body:`flat_amount`,type:`number`,id:`param-flat-amount-15`,children:_jsx(_components.p,{children:`Flat amount for this tier in this currency, if the tier uses one.`})})]})})]})]}),_jsx(ParamField,{body:`tier_behavior`,type:`'graduated' | 'volume'`,id:`param-tier-behavior-21`,children:_jsx(_components.p,{children:`How tiers price usage. ‘graduated’ (default) charges each unit at the rate of the tier it falls in. ‘volume’ picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier’s rate plus its flat_amount.`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-38`,children:_jsx(_components.p,{children:`Billing interval. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-33`,children:_jsx(_components.p,{children:`Number of intervals per billing cycle. Defaults to 1.`})}),_jsx(ParamField,{body:`billing_units`,type:`number`,id:`param-billing-units-14`,children:_jsx(_components.p,{children:`Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).`})}),_jsx(ParamField,{body:`billing_method`,type:`'prepaid' | 'usage_based'`,required:true,id:`param-billing-method-11`,children:_jsx(_components.p,{children:`‘prepaid’ for upfront payment (seats), ‘usage_based’ for pay-as-you-go.`})}),_jsx(ParamField,{body:`max_purchase`,type:`number | null`,id:`param-max-purchase-7`,children:_jsx(_components.p,{children:`Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.`})})]})]}),_jsxs(ParamField,{body:`proration`,type:`object`,id:`param-proration-4`,children:[_jsx(_components.p,{children:`Proration settings for prepaid features. Controls mid-cycle quantity change billing.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`on_increase`,type:`'bill_immediately' | 'prorate_immediately' | 'prorate_next_cycle' | 'bill_next_cycle'`,required:true,id:`param-on-increase-4`,children:_jsx(_components.p,{children:`Billing behavior when quantity increases mid-cycle.`})}),_jsx(ParamField,{body:`on_decrease`,type:`'prorate' | 'prorate_immediately' | 'prorate_next_cycle' | 'none' | 'no_prorations'`,required:true,id:`param-on-decrease-4`,children:_jsx(_components.p,{children:`Credit behavior when quantity decreases mid-cycle.`})})]})]}),_jsxs(ParamField,{body:`rollover`,type:`object`,id:`param-rollover-7`,children:[_jsx(_components.p,{children:`Rollover config for unused units. If set, unused included units carry over.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`max`,type:`number`,id:`param-max-7`,children:_jsx(_components.p,{children:`Max rollover units. Omit for unlimited rollover.`})}),_jsx(ParamField,{body:`max_percentage`,type:`number`,id:`param-max-percentage-7`,children:_jsx(_components.p,{children:`Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.`})}),_jsx(ParamField,{body:`expiry_duration_type`,type:`'month' | 'forever'`,required:true,id:`param-expiry-duration-type-7`,children:_jsx(_components.p,{children:`When rolled over units expire.`})}),_jsx(ParamField,{body:`expiry_duration_length`,type:`number`,id:`param-expiry-duration-length-7`,children:_jsx(_components.p,{children:`Number of periods before expiry.`})})]})]}),_jsxs(ParamField,{body:`expiry`,type:`object`,id:`param-expiry-7`,children:[_jsx(_components.p,{children:`Purchased units expire this long after each purchase. One-off prepaid consumable items only.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`duration`,type:`'day' | 'week' | 'month' | 'year'`,required:true,id:`param-duration-7`}),_jsx(ParamField,{body:`length`,type:`number`,required:true,id:`param-length-7`})]})]}),_jsxs(ParamField,{body:`feature_override`,type:`object`,id:`param-feature-override-7`,children:[_jsx(_components.p,{children:`Overrides fields of this item’s feature for customers on this plan (e.g. a credit system’s credit_schema).`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`credit_schema`,type:`object | object | object[]`,id:`param-credit-schema-10`,children:[_jsxs(_components.p,{children:[`For credit system features: merges into the feature’s credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `,_jsx(_components.code,{children:`excluded: true`}),` removes it, and unlisted features keep the credit system’s rate.`]}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`metered_feature_id`,type:`string`,id:`param-metered-feature-id-10`,children:_jsx(_components.p,{children:`ID of the metered feature that draws from this credit system.`})}),_jsx(ParamField,{body:`billing_units`,type:`number`,id:`param-billing-units-15`,children:_jsx(_components.p,{children:`Number of metered-feature units priced together. Defaults to one when omitted.`})}),_jsxs(ParamField,{body:`dimensions.{key}`,type:`object`,id:`param-dimensions-key-7`,children:[_jsx(_components.p,{children:`Named rates chosen by event properties. The most specific match sets the rate; with no match the item’s own rate applies.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`match.{key}`,type:`string`,required:true,id:`param-match-key-14`,children:_jsx(_components.p,{children:`Event properties this entry applies to. Every key must equal the tracked property, compared as strings.`})}),_jsx(ParamField,{body:`priority`,type:`integer`,id:`param-priority-7`,children:_jsx(_components.p,{children:`Breaks ties between dimensions that match the same number of keys. Higher wins.`})}),_jsx(ParamField,{body:`tier_behavior`,type:`string`,required:true,id:`param-tier-behavior-22`}),_jsx(ParamField,{body:`tiers`,type:`object[]`,required:true,id:`param-tiers-22`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-22`,children:_jsx(_components.p,{children:`Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-24`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group within this tier.`})})]})})]})]}),_jsxs(ParamField,{body:`multipliers.{key}`,type:`object`,id:`param-multipliers-key-7`,children:[_jsx(_components.p,{children:`Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`match.{key}`,type:`string`,required:true,id:`param-match-key-15`,children:_jsx(_components.p,{children:`Event properties this entry applies to. Every key must equal the tracked property, compared as strings.`})}),_jsx(ParamField,{body:`factor`,type:`number`,id:`param-factor-7`,children:_jsx(_components.p,{children:`Multiplies the matched rate. All matching multipliers stack.`})}),_jsx(ParamField,{body:`add`,type:`number`,id:`param-add-7`,children:_jsx(_components.p,{children:`Added to the rate after every factor is applied, in credits per billing-unit group.`})})]})]}),_jsx(ParamField,{body:`tier_behavior`,type:`string`,id:`param-tier-behavior-23`}),_jsx(ParamField,{body:`tiers`,type:`object[]`,id:`param-tiers-23`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-23`,children:_jsx(_components.p,{children:`Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-25`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group within this tier.`})})]})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,id:`param-credit-cost-26`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group.`})}),_jsx(ParamField,{body:`excluded`,type:`true`,id:`param-excluded-7`,children:_jsx(_components.p,{children:`Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.`})})]})]}),_jsxs(ParamField,{body:`markups`,type:`object`,id:`param-markups-7`,children:[_jsx(_components.p,{children:`For AI credit system features: replaces the feature’s markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature’s.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`default_markup`,type:`number`,id:`param-default-markup-7`,children:_jsx(_components.p,{children:`Default percentage markup for customers on this plan. Use -100 to make usage free.`})}),_jsxs(ParamField,{body:`provider_markups.{key}`,type:`object | null`,id:`param-provider-markups-key-7`,children:[_jsx(_components.p,{children:`Per-provider markup percentages for customers on this plan.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`markup`,type:`number`,required:true,id:`param-markup-14`})})]}),_jsxs(ParamField,{body:`model_markups.{key}`,type:`object | null`,id:`param-model-markups-key-7`,children:[_jsx(_components.p,{children:`Per-model markup overrides for customers on this plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`markup`,type:`number`,id:`param-markup-15`}),_jsx(ParamField,{body:`input_cost`,type:`number`,id:`param-input-cost-7`}),_jsx(ParamField,{body:`output_cost`,type:`number`,id:`param-output-cost-7`})]})]})]})]})]})]})]})]}),_jsxs(ParamField,{body:`remove_items`,type:`object[]`,id:`param-remove-items-4`,children:[_jsx(_components.p,{children:`Filters selecting items to remove from the plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,id:`param-feature-id-41`,children:_jsx(_components.p,{children:`Match items linked to this feature.`})}),_jsx(ParamField,{body:`billing_method`,type:`'prepaid' | 'usage_based'`,id:`param-billing-method-12`,children:_jsx(_components.p,{children:`Match items with this billing method (prepaid or usage_based).`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,id:`param-interval-39`,children:_jsx(_components.p,{children:`Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.`})}),_jsx(ParamField,{body:`interval_count`,type:`integer`,id:`param-interval-count-34`,children:_jsx(_components.p,{children:`Match items with this interval_count. Disambiguates between items that share an interval but differ in count.`})}),_jsx(ParamField,{body:`included`,type:`number`,id:`param-included-15`,children:_jsx(_components.p,{children:`Match items whose grant equals this included usage. Omitted is a wildcard.`})})]})]}),_jsxs(ParamField,{body:`free_trial`,type:`object | null`,id:`param-free-trial-5`,children:[_jsx(_components.p,{children:`Free trial configuration for a plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`duration_length`,type:`number`,required:true,id:`param-duration-length-7`,children:_jsx(_components.p,{children:`Number of duration_type periods the trial lasts.`})}),_jsx(ParamField,{body:`duration_type`,type:`'day' | 'month' | 'year'`,required:true,id:`param-duration-type-7`,children:_jsx(_components.p,{children:`Unit of time for the trial (‘day’, ‘month’, ‘year’).`})}),_jsx(ParamField,{body:`card_required`,type:`boolean`,required:true,id:`param-card-required-7`,children:_jsx(_components.p,{children:`If true, a payment method is required to start the trial and the customer is charged when it ends. Defaults to false.`})}),_jsx(ParamField,{body:`on_end`,type:`'bill' | 'revert'`,id:`param-on-end-7`})]})]}),_jsxs(ParamField,{body:`billing_controls`,type:`object`,id:`param-billing-controls-5`,children:[_jsx(_components.p,{children:`Override the plan’s billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`auto_topups`,type:`object[]`,id:`param-auto-topups-5`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-42`,children:_jsx(_components.p,{children:`The ID of the feature (credit balance) to auto top-up.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-25`,children:_jsx(_components.p,{children:`Whether auto top-up is enabled.`})}),_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-18`,children:_jsx(_components.p,{children:`When the balance drops below this threshold, an auto top-up will be purchased.`})}),_jsx(ParamField,{body:`quantity`,type:`number`,required:true,id:`param-quantity-8`,children:_jsx(_components.p,{children:`Amount of credits to add per auto top-up.`})}),_jsxs(ParamField,{body:`purchase_limit`,type:`object`,id:`param-purchase-limit-5`,children:[_jsx(_components.p,{children:`Optional rate limit to cap how often auto top-ups occur. Pass count or amount to set the current window’s consumed top-ups or charged amount.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`limit_type`,type:`'count' | 'amount'`,id:`param-limit-type-10`,children:_jsxs(_components.p,{children:[`What `,_jsx(_components.code,{children:`limit`}),` caps: the number of auto top-ups (`,_jsx(_components.code,{children:`count`}),`, default) or the total amount charged for them, in the customer’s currency (`,_jsx(_components.code,{children:`amount`}),`).`]})}),_jsx(ParamField,{body:`interval`,type:`'hour' | 'day' | 'week' | 'month'`,required:true,id:`param-interval-40`,children:_jsx(_components.p,{children:`The time interval for the purchase limit window.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,required:true,id:`param-interval-count-35`,children:_jsx(_components.p,{children:`Number of intervals in the purchase limit window.`})}),_jsx(ParamField,{body:`limit`,type:`number`,required:true,id:`param-limit-10`,children:_jsx(_components.p,{children:`Maximum allowed within the interval: a number of auto top-ups when limit_type is count, or a total charge (e.g. 500 for $500, pre-tax) when limit_type is amount.`})}),_jsx(ParamField,{body:`count`,type:`number`,id:`param-count-2`,children:_jsx(_components.p,{children:`Set the current window’s consumed auto top-up count. Omit to leave runtime state unchanged.`})}),_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-52`,children:_jsx(_components.p,{children:`Set the amount already charged by auto top-ups in the current window. Omit to leave runtime state unchanged.`})})]})]}),_jsx(ParamField,{body:`invoice_mode`,type:`boolean`,id:`param-invoice-mode-5`,children:_jsx(_components.p,{children:`When true, auto top-up creates a send_invoice invoice instead of auto-charging.`})})]})}),_jsx(ParamField,{body:`spend_limits`,type:`object[]`,id:`param-spend-limits-5`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,id:`param-feature-id-43`,children:_jsx(_components.p,{children:`Optional feature ID this spend limit applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-26`,children:_jsx(_components.p,{children:`Whether the overage spend limit is enabled.`})}),_jsx(ParamField,{body:`limit_type`,type:`'absolute' | 'usage_percentage'`,id:`param-limit-type-11`,children:_jsx(_components.p,{children:`How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.`})}),_jsx(ParamField,{body:`overage_limit`,type:`number`,id:`param-overage-limit-5`,children:_jsx(_components.p,{children:`Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.`})}),_jsx(ParamField,{body:`skip_overage_billing`,type:`boolean`,id:`param-skip-overage-billing-5`,children:_jsx(_components.p,{children:`When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.`})})]})}),_jsx(ParamField,{body:`usage_limits`,type:`object[]`,id:`param-usage-limits-5`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-44`,children:_jsx(_components.p,{children:`The feature this usage limit applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-27`,children:_jsx(_components.p,{children:`Whether this usage limit is enabled.`})}),_jsx(ParamField,{body:`limit`,type:`number`,required:true,id:`param-limit-11`,children:_jsx(_components.p,{children:`Maximum units allowed per interval.`})}),_jsx(ParamField,{body:`interval`,type:`'day' | 'week' | 'month' | 'year'`,required:true,id:`param-interval-41`,children:_jsx(_components.p,{children:`Interval for the cap, aligned to the customer’s billing cycle.`})}),_jsx(ParamField,{body:`anchor`,type:`'billing_cycle' | 'utc'`,id:`param-anchor-5`,children:_jsx(_components.p,{children:`Window alignment. ‘billing_cycle’ phases the interval to the customer’s renewal time; ‘utc’ aligns to the UTC calendar.`})}),_jsxs(ParamField,{body:`filter`,type:`object`,id:`param-filter-10`,children:[_jsx(_components.p,{children:`When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`properties.{key}`,type:`string`,required:true,id:`param-properties-key-10`})})]})]})}),_jsx(ParamField,{body:`usage_alerts`,type:`object[]`,id:`param-usage-alerts-5`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,id:`param-feature-id-45`,children:_jsx(_components.p,{children:`The feature ID this alert applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-28`,children:_jsx(_components.p,{children:`Whether this usage alert is enabled.`})}),_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-19`,children:_jsx(_components.p,{children:`The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage. remaining and remaining_percentage accept negative values with basis balance, to alert once the balance is overdrawn.`})}),_jsx(ParamField,{body:`threshold_type`,type:`'usage' | 'usage_percentage' | 'remaining' | 'remaining_percentage'`,required:true,id:`param-threshold-type-5`,children:_jsx(_components.p,{children:`Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.`})}),_jsx(ParamField,{body:`basis`,type:`'balance' | 'included' | 'recurring' | 'usage_limit'`,required:true,id:`param-basis-5`,children:_jsx(_components.p,{children:`What 100% means. balance: every grant on the feature. included: the plan allowance only. recurring: grants that reset. usage_limit: the cap of the usage limit with the same feature and filter.`})}),_jsxs(ParamField,{body:`filter`,type:`object`,id:`param-filter-11`,children:[_jsx(_components.p,{children:`Only valid with basis usage_limit. Points the alert at the usage limit carrying the same filter.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`properties.{key}`,type:`string`,required:true,id:`param-properties-key-11`})})]}),_jsx(ParamField,{body:`name`,type:`string`,id:`param-name-11`,children:_jsx(_components.p,{children:`Optional user-defined label to distinguish multiple alerts on the same feature.`})})]})}),_jsx(ParamField,{body:`overage_allowed`,type:`object[]`,id:`param-overage-allowed-5`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-46`,children:_jsx(_components.p,{children:`The feature ID this overage allowed control applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-29`,children:_jsx(_components.p,{children:`Whether overage is allowed for this feature.`})})]})})]})]}),_jsxs(ParamField,{body:`upsert_licenses`,type:`object[]`,id:`param-upsert-licenses-2`,children:[_jsx(_components.p,{children:`License links to add or override for this customer, keyed by license_plan_id. Omitted fields inherit the plan catalog link (included defaults to 1 when the license is not in the catalog). A bare entry restores the license to pure catalog inheritance.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`license_plan_id`,type:`string`,required:true,id:`param-license-plan-id-5`}),_jsx(ParamField,{body:`version_slug`,type:`string`,id:`param-version-slug-5`}),_jsx(ParamField,{body:`included`,type:`integer`,id:`param-included-16`}),_jsx(ParamField,{body:`prepaid_only`,type:`boolean`,id:`param-prepaid-only-2`}),_jsx(ParamField,{body:`customize`,type:`object | null`,id:`param-customize-5`,children:_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`price`,type:`object | null`,id:`param-price-15`,children:[_jsx(_components.p,{children:`Base price configuration for a plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-53`,children:_jsx(_components.p,{children:`Base price amount for the plan, in major currency units (e.g. dollars).`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-42`,children:_jsx(_components.p,{children:`Billing interval (e.g. ‘month’, ‘year’).`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-36`}),_jsxs(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-25`,children:[_jsx(_components.p,{children:`Base price amounts in additional currencies. The base ‘amount’ is in the org’s default currency.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-25`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-54`,children:_jsx(_components.p,{children:`Price amount in this currency. Set explicitly per currency, not converted from the base amount.`})})]})]})]})]}),_jsx(ParamField,{body:`add_items`,type:`object[]`,id:`param-add-items-5`,children:_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`threshold_billing`,type:`object | null`,id:`param-threshold-billing-8`,children:[_jsx(_components.p,{children:`Bills this many feature units when outstanding overage reaches it.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-20`})})]}),_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-47`,children:_jsx(_components.p,{children:`The ID of the feature to configure.`})}),_jsx(ParamField,{body:`included`,type:`number`,id:`param-included-17`,children:_jsx(_components.p,{children:`Number of free units included. Balance resets to this each interval for consumable features.`})}),_jsx(ParamField,{body:`unlimited`,type:`boolean`,id:`param-unlimited-8`,children:_jsx(_components.p,{children:`If true, customer has unlimited access to this feature.`})}),_jsx(ParamField,{body:`pooled`,type:`boolean`,id:`param-pooled-8`,children:_jsx(_components.p,{children:`Whether entity-level grants contribute to a shared customer balance.`})}),_jsxs(ParamField,{body:`reset`,type:`object`,id:`param-reset-8`,children:[_jsx(_components.p,{children:`Reset configuration for consumable features. Omit for non-consumable features like seats.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`interval`,type:`'one_off' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-43`,children:_jsx(_components.p,{children:`Interval at which balance resets (e.g. ‘month’, ‘year’). For consumable features only.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-37`})]})]}),_jsxs(ParamField,{body:`price`,type:`object`,id:`param-price-16`,children:[_jsx(_components.p,{children:`Pricing for usage beyond included units. Omit for free features.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-55`,children:_jsx(_components.p,{children:`Price per billing_units after included usage. Either ‘amount’ or ‘tiers’ is required.`})}),_jsxs(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-26`,children:[_jsx(_components.p,{children:`Amounts in additional currencies for this flat price. The base ‘amount’ is in the org’s default currency. Only valid with ‘amount’, not ‘tiers’.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-26`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-56`,children:_jsx(_components.p,{children:`Price amount in this currency. Set explicitly per currency, not converted from the base amount.`})})]})]}),_jsxs(ParamField,{body:`tiers`,type:`object[]`,id:`param-tiers-24`,children:[_jsx(_components.p,{children:`Tiered pricing. Either ‘amount’ or ‘tiers’ is required.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-24`}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-57`}),_jsx(ParamField,{body:`flat_amount`,type:`number`,id:`param-flat-amount-16`}),_jsx(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-27`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-27`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-58`,children:_jsx(_components.p,{children:`Per-unit amount for this tier in this currency.`})}),_jsx(ParamField,{body:`flat_amount`,type:`number`,id:`param-flat-amount-17`,children:_jsx(_components.p,{children:`Flat amount for this tier in this currency, if the tier uses one.`})})]})})]})]}),_jsx(ParamField,{body:`tier_behavior`,type:`'graduated' | 'volume'`,id:`param-tier-behavior-24`,children:_jsx(_components.p,{children:`How tiers price usage. ‘graduated’ (default) charges each unit at the rate of the tier it falls in. ‘volume’ picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier’s rate plus its flat_amount.`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-44`,children:_jsx(_components.p,{children:`Billing interval. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-38`,children:_jsx(_components.p,{children:`Number of intervals per billing cycle. Defaults to 1.`})}),_jsx(ParamField,{body:`billing_units`,type:`number`,id:`param-billing-units-16`,children:_jsx(_components.p,{children:`Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).`})}),_jsx(ParamField,{body:`billing_method`,type:`'prepaid' | 'usage_based'`,required:true,id:`param-billing-method-13`,children:_jsx(_components.p,{children:`‘prepaid’ for upfront payment (seats), ‘usage_based’ for pay-as-you-go.`})}),_jsx(ParamField,{body:`max_purchase`,type:`number | null`,id:`param-max-purchase-8`,children:_jsx(_components.p,{children:`Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.`})})]})]}),_jsxs(ParamField,{body:`proration`,type:`object`,id:`param-proration-5`,children:[_jsx(_components.p,{children:`Proration settings for prepaid features. Controls mid-cycle quantity change billing.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`on_increase`,type:`'bill_immediately' | 'prorate_immediately' | 'prorate_next_cycle' | 'bill_next_cycle'`,required:true,id:`param-on-increase-5`,children:_jsx(_components.p,{children:`Billing behavior when quantity increases mid-cycle.`})}),_jsx(ParamField,{body:`on_decrease`,type:`'prorate' | 'prorate_immediately' | 'prorate_next_cycle' | 'none' | 'no_prorations'`,required:true,id:`param-on-decrease-5`,children:_jsx(_components.p,{children:`Credit behavior when quantity decreases mid-cycle.`})})]})]}),_jsxs(ParamField,{body:`rollover`,type:`object`,id:`param-rollover-8`,children:[_jsx(_components.p,{children:`Rollover config for unused units. If set, unused included units carry over.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`max`,type:`number`,id:`param-max-8`,children:_jsx(_components.p,{children:`Max rollover units. Omit for unlimited rollover.`})}),_jsx(ParamField,{body:`max_percentage`,type:`number`,id:`param-max-percentage-8`,children:_jsx(_components.p,{children:`Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.`})}),_jsx(ParamField,{body:`expiry_duration_type`,type:`'month' | 'forever'`,required:true,id:`param-expiry-duration-type-8`,children:_jsx(_components.p,{children:`When rolled over units expire.`})}),_jsx(ParamField,{body:`expiry_duration_length`,type:`number`,id:`param-expiry-duration-length-8`,children:_jsx(_components.p,{children:`Number of periods before expiry.`})})]})]}),_jsxs(ParamField,{body:`expiry`,type:`object`,id:`param-expiry-8`,children:[_jsx(_components.p,{children:`Purchased units expire this long after each purchase. One-off prepaid consumable items only.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`duration`,type:`'day' | 'week' | 'month' | 'year'`,required:true,id:`param-duration-8`}),_jsx(ParamField,{body:`length`,type:`number`,required:true,id:`param-length-8`})]})]}),_jsxs(ParamField,{body:`feature_override`,type:`object`,id:`param-feature-override-8`,children:[_jsx(_components.p,{children:`Overrides fields of this item’s feature for customers on this plan (e.g. a credit system’s credit_schema).`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`credit_schema`,type:`object | object | object[]`,id:`param-credit-schema-11`,children:[_jsxs(_components.p,{children:[`For credit system features: merges into the feature’s credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `,_jsx(_components.code,{children:`excluded: true`}),` removes it, and unlisted features keep the credit system’s rate.`]}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`metered_feature_id`,type:`string`,id:`param-metered-feature-id-11`,children:_jsx(_components.p,{children:`ID of the metered feature that draws from this credit system.`})}),_jsx(ParamField,{body:`billing_units`,type:`number`,id:`param-billing-units-17`,children:_jsx(_components.p,{children:`Number of metered-feature units priced together. Defaults to one when omitted.`})}),_jsxs(ParamField,{body:`dimensions.{key}`,type:`object`,id:`param-dimensions-key-8`,children:[_jsx(_components.p,{children:`Named rates chosen by event properties. The most specific match sets the rate; with no match the item’s own rate applies.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`match.{key}`,type:`string`,required:true,id:`param-match-key-16`,children:_jsx(_components.p,{children:`Event properties this entry applies to. Every key must equal the tracked property, compared as strings.`})}),_jsx(ParamField,{body:`priority`,type:`integer`,id:`param-priority-8`,children:_jsx(_components.p,{children:`Breaks ties between dimensions that match the same number of keys. Higher wins.`})}),_jsx(ParamField,{body:`tier_behavior`,type:`string`,required:true,id:`param-tier-behavior-25`}),_jsx(ParamField,{body:`tiers`,type:`object[]`,required:true,id:`param-tiers-25`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-25`,children:_jsx(_components.p,{children:`Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-27`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group within this tier.`})})]})})]})]}),_jsxs(ParamField,{body:`multipliers.{key}`,type:`object`,id:`param-multipliers-key-8`,children:[_jsx(_components.p,{children:`Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`match.{key}`,type:`string`,required:true,id:`param-match-key-17`,children:_jsx(_components.p,{children:`Event properties this entry applies to. Every key must equal the tracked property, compared as strings.`})}),_jsx(ParamField,{body:`factor`,type:`number`,id:`param-factor-8`,children:_jsx(_components.p,{children:`Multiplies the matched rate. All matching multipliers stack.`})}),_jsx(ParamField,{body:`add`,type:`number`,id:`param-add-8`,children:_jsx(_components.p,{children:`Added to the rate after every factor is applied, in credits per billing-unit group.`})})]})]}),_jsx(ParamField,{body:`tier_behavior`,type:`string`,id:`param-tier-behavior-26`}),_jsx(ParamField,{body:`tiers`,type:`object[]`,id:`param-tiers-26`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-26`,children:_jsx(_components.p,{children:`Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-28`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group within this tier.`})})]})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,id:`param-credit-cost-29`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group.`})}),_jsx(ParamField,{body:`excluded`,type:`true`,id:`param-excluded-8`,children:_jsx(_components.p,{children:`Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.`})})]})]}),_jsxs(ParamField,{body:`markups`,type:`object`,id:`param-markups-8`,children:[_jsx(_components.p,{children:`For AI credit system features: replaces the feature’s markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature’s.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`default_markup`,type:`number`,id:`param-default-markup-8`,children:_jsx(_components.p,{children:`Default percentage markup for customers on this plan. Use -100 to make usage free.`})}),_jsxs(ParamField,{body:`provider_markups.{key}`,type:`object | null`,id:`param-provider-markups-key-8`,children:[_jsx(_components.p,{children:`Per-provider markup percentages for customers on this plan.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`markup`,type:`number`,required:true,id:`param-markup-16`})})]}),_jsxs(ParamField,{body:`model_markups.{key}`,type:`object | null`,id:`param-model-markups-key-8`,children:[_jsx(_components.p,{children:`Per-model markup overrides for customers on this plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`markup`,type:`number`,id:`param-markup-17`}),_jsx(ParamField,{body:`input_cost`,type:`number`,id:`param-input-cost-8`}),_jsx(ParamField,{body:`output_cost`,type:`number`,id:`param-output-cost-8`})]})]})]})]})]})]})]})}),_jsx(ParamField,{body:`remove_items`,type:`object[]`,id:`param-remove-items-5`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,id:`param-feature-id-48`,children:_jsx(_components.p,{children:`Match items linked to this feature.`})}),_jsx(ParamField,{body:`billing_method`,type:`'prepaid' | 'usage_based'`,id:`param-billing-method-14`,children:_jsx(_components.p,{children:`Match items with this billing method (prepaid or usage_based).`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,id:`param-interval-45`,children:_jsx(_components.p,{children:`Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.`})}),_jsx(ParamField,{body:`interval_count`,type:`integer`,id:`param-interval-count-39`,children:_jsx(_components.p,{children:`Match items with this interval_count. Disambiguates between items that share an interval but differ in count.`})}),_jsx(ParamField,{body:`included`,type:`number`,id:`param-included-18`,children:_jsx(_components.p,{children:`Match items whose grant equals this included usage. Omitted is a wildcard.`})})]})})]})}),_jsx(ParamField,{body:`metadata`,type:`object`,id:`param-metadata-6`})]})]}),_jsxs(ParamField,{body:`remove_licenses`,type:`object[]`,id:`param-remove-licenses-2`,children:[_jsx(_components.p,{children:`License links to drop, keyed by license_plan_id. Parallel to remove_items.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`license_plan_id`,type:`string`,required:true,id:`param-license-plan-id-6`})})]})]})]})]})]})]})]}),_jsx(ParamField,{body:`action`,type:`'created' | 'updated' | 'removed'`,required:true,id:`param-action-2`,children:_jsx(_components.p,{children:`created = new planLicense; updated = row or effective content changed; removed = dropped.`})}),_jsxs(ParamField,{body:`previous_attributes`,type:`object | null`,required:true,id:`param-previous-attributes-2`,children:[_jsx(_components.p,{children:`Previous included / prepaid_only / version. Null when created or removed, or when no row scalar changed.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`version`,type:`integer`,id:`param-version-3`,children:_jsx(_components.p,{children:`The exact license-plan version pinned by this link.`})}),_jsx(ParamField,{body:`version_slug`,type:`string`,id:`param-version-slug-6`,children:_jsx(_components.p,{children:`Version slug of the license-plan row this link points at.`})}),_jsx(ParamField,{body:`included`,type:`number`,id:`param-included-19`,children:_jsx(_components.p,{children:`Number of license assignments included with this plan for free.`})})]})]}),_jsxs(ParamField,{body:`plan_change`,type:`object | null`,id:`param-plan-change-1`,children:[_jsx(_components.p,{children:`Diff of the license’s effective plan. Null when created, removed, or the effective content is unchanged.`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`plan`,type:`object`,id:`param-plan-2`,children:[_jsx(_components.p,{children:`The plan after the change. Omitted unless the caller expands it.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`id`,type:`string`,required:true,id:`param-id-6`,children:_jsx(_components.p,{children:`Unique identifier for the plan.`})}),_jsx(ParamField,{body:`name`,type:`string`,required:true,id:`param-name-12`,children:_jsx(_components.p,{children:`Display name of the plan.`})}),_jsx(ParamField,{body:`description`,type:`string | null`,required:true,id:`param-description-3`,children:_jsx(_components.p,{children:`Optional description of the plan.`})}),_jsx(ParamField,{body:`group`,type:`string | null`,required:true,id:`param-group-3`,children:_jsx(_components.p,{children:`Group identifier for organizing related plans. Plans in the same group are mutually exclusive.`})}),_jsx(ParamField,{body:`version`,type:`number`,required:true,id:`param-version-4`,children:_jsx(_components.p,{children:`Version number of the plan. Incremented when plan configuration changes.`})}),_jsx(ParamField,{body:`version_slug`,type:`string | null`,id:`param-version-slug-7`,children:_jsx(_components.p,{children:`User-facing version identity. Defaults to v{n} when the version is minted.`})}),_jsx(ParamField,{body:`active`,type:`boolean`,id:`param-active-3`,children:_jsx(_components.p,{children:`Whether this is the active version of the plan. At most one version is active.`})}),_jsx(ParamField,{body:`add_on`,type:`boolean`,required:true,id:`param-add-on-3`,children:_jsx(_components.p,{children:`Whether this is an add-on plan that can be attached alongside a main plan.`})}),_jsx(ParamField,{body:`auto_enable`,type:`boolean`,required:true,id:`param-auto-enable-3`,children:_jsx(_components.p,{children:`If true, this plan is automatically attached when a customer is created. Used for free plans.`})}),_jsxs(ParamField,{body:`price`,type:`object | null`,required:true,id:`param-price-17`,children:[_jsx(_components.p,{children:`Base recurring price for the plan. Null for free plans or usage-only plans.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-59`,children:_jsx(_components.p,{children:`Base price amount for the plan, in major currency units (e.g. dollars).`})}),_jsxs(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-28`,children:[_jsx(_components.p,{children:`Base price amounts in additional currencies. The base ‘amount’ is in the org’s default currency.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-28`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-60`,children:_jsx(_components.p,{children:`Price amount in this currency. Set explicitly per currency, not converted from the base amount.`})})]})]}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-46`,children:_jsx(_components.p,{children:`Billing interval (e.g. ‘month’, ‘year’).`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-40`,children:_jsx(_components.p,{children:`Number of intervals per billing cycle. Defaults to 1.`})}),_jsxs(ParamField,{body:`display`,type:`object`,id:`param-display-10`,children:[_jsx(_components.p,{children:`Display text for showing this price in pricing pages.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`primary_text`,type:`string`,required:true,id:`param-primary-text-7`,children:_jsx(_components.p,{children:`Main display text (e.g. ‘$10’ or ‘100 messages’).`})}),_jsx(ParamField,{body:`secondary_text`,type:`string`,id:`param-secondary-text-7`,children:_jsx(_components.p,{children:`Secondary display text (e.g. ‘per month’ or ‘then $0.5 per 100’).`})})]})]}),_jsxs(ParamField,{body:`processors`,type:`object`,id:`param-processors-10`,children:[_jsx(_components.p,{children:`Payment processors this base price is connected to. Omitted when unset.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`stripe`,type:`object | null`,id:`param-stripe-10`,children:_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`price_id`,type:`string`,required:true,id:`param-price-id-7`,children:_jsx(_components.p,{children:`Stripe price ID. For prepaid with included > 0 this is the V2 price.`})})})})})]})]})]}),_jsxs(ParamField,{body:`items`,type:`object[]`,required:true,id:`param-items-2`,children:[_jsx(_components.p,{children:`Feature configurations included in this plan. Each item defines included units, pricing, and reset behavior for a feature.`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`threshold_billing`,type:`object | null`,id:`param-threshold-billing-9`,children:[_jsx(_components.p,{children:`Bills this many feature units when outstanding overage reaches it.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-21`})})]}),_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-49`,children:_jsx(_components.p,{children:`The ID of the feature this item configures.`})}),_jsxs(ParamField,{body:`feature`,type:`object`,id:`param-feature-3`,children:[_jsx(_components.p,{children:`The full feature object if expanded.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`id`,type:`string`,required:true,id:`param-id-7`,children:_jsx(_components.p,{children:`The ID of the feature, used to refer to it in other API calls like /track or /check.`})}),_jsx(ParamField,{body:`name`,type:`string | null`,id:`param-name-13`,children:_jsx(_components.p,{children:`The name of the feature.`})}),_jsx(ParamField,{body:`type`,type:`'static' | 'boolean' | 'single_use' | 'continuous_use' | 'credit_system' | 'ai_credit_system'`,required:true,id:`param-type-3`,children:_jsx(_components.p,{children:`The type of the feature`})}),_jsxs(ParamField,{body:`display`,type:`object | null`,id:`param-display-11`,children:[_jsx(_components.p,{children:`Singular and plural display names for the feature.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`singular`,type:`string`,required:true,id:`param-singular-3`,children:_jsx(_components.p,{children:`The singular display name for the feature.`})}),_jsx(ParamField,{body:`plural`,type:`string`,required:true,id:`param-plural-3`,children:_jsx(_components.p,{children:`The plural display name for the feature.`})})]})]}),_jsxs(ParamField,{body:`credit_schema`,type:`object[] | null`,id:`param-credit-schema-12`,children:[_jsx(_components.p,{children:`Credit cost schema for credit system features.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`metered_feature_id`,type:`string`,required:true,id:`param-metered-feature-id-12`,children:_jsx(_components.p,{children:`The ID of the metered feature (should be a single_use feature).`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-30`,children:_jsx(_components.p,{children:`The credit cost of the metered feature.`})})]})]}),_jsx(ParamField,{body:`archived`,type:`boolean | null`,id:`param-archived-6`,children:_jsx(_components.p,{children:`Whether or not the feature is archived.`})})]})]}),_jsx(ParamField,{body:`included`,type:`number`,required:true,id:`param-included-20`,children:_jsx(_components.p,{children:`Number of free units included. For consumable features, balance resets to this number each interval.`})}),_jsx(ParamField,{body:`unlimited`,type:`boolean`,required:true,id:`param-unlimited-9`,children:_jsx(_components.p,{children:`Whether the customer has unlimited access to this feature.`})}),_jsx(ParamField,{body:`pooled`,type:`boolean`,id:`param-pooled-9`,children:_jsx(_components.p,{children:`Whether entity-level grants contribute to a shared customer balance.`})}),_jsxs(ParamField,{body:`reset`,type:`object | null`,required:true,id:`param-reset-9`,children:[_jsx(_components.p,{children:`Reset configuration for consumable features. Null for non-consumable features like seats where usage persists across billing cycles.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`interval`,type:`'one_off' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-47`,children:_jsx(_components.p,{children:`The interval at which the feature balance resets (e.g. ‘month’, ‘year’). For consumable features, usage resets to 0 and included units are restored.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-41`,children:_jsx(_components.p,{children:`Number of intervals between resets. Defaults to 1.`})})]})]}),_jsxs(ParamField,{body:`price`,type:`object | null`,required:true,id:`param-price-18`,children:[_jsx(_components.p,{children:`Pricing configuration for usage beyond included units. Null if feature is entirely free.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-61`,children:_jsx(_components.p,{children:`Price per billing_units after included usage is consumed. Mutually exclusive with tiers.`})}),_jsxs(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-29`,children:[_jsx(_components.p,{children:`Amounts in additional currencies for this flat price. The base ‘amount’ is in the org’s default currency. Only valid with ‘amount’, not ‘tiers’ (tiered prices carry per-currency amounts on each tier).`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-29`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-62`,children:_jsx(_components.p,{children:`Price amount in this currency. Set explicitly per currency, not converted from the base amount.`})})]})]}),_jsxs(ParamField,{body:`tiers`,type:`object[]`,id:`param-tiers-27`,children:[_jsx(_components.p,{children:`Tiered pricing configuration. Each tier’s ‘to’ INCLUDES the included amount. Either ‘tiers’ or ‘amount’ is required.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-27`}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-63`}),_jsx(ParamField,{body:`flat_amount`,type:`number`,id:`param-flat-amount-18`}),_jsx(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-30`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-30`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-64`,children:_jsx(_components.p,{children:`Per-unit amount for this tier in this currency.`})}),_jsx(ParamField,{body:`flat_amount`,type:`number`,id:`param-flat-amount-19`,children:_jsx(_components.p,{children:`Flat amount for this tier in this currency, if the tier uses one.`})})]})})]})]}),_jsx(ParamField,{body:`tier_behavior`,type:`'graduated' | 'volume'`,id:`param-tier-behavior-27`,children:_jsx(_components.p,{children:`How tiers price usage. ‘graduated’ (default) charges each unit at the rate of the tier it falls in. ‘volume’ picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier’s rate plus its flat_amount.`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-48`,children:_jsx(_components.p,{children:`Billing interval for this price. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-42`,children:_jsx(_components.p,{children:`Number of intervals per billing cycle. Defaults to 1.`})}),_jsx(ParamField,{body:`billing_units`,type:`number`,required:true,id:`param-billing-units-18`,children:_jsx(_components.p,{children:`Number of units per price increment. Usage is rounded UP to the nearest billing_units when billed (e.g. billing_units=100 means 101 usage rounds to 200).`})}),_jsx(ParamField,{body:`billing_method`,type:`'prepaid' | 'usage_based'`,required:true,id:`param-billing-method-15`,children:_jsx(_components.p,{children:`‘prepaid’ for features like seats where customers pay upfront, ‘usage_based’ for pay-as-you-go after included usage.`})}),_jsx(ParamField,{body:`max_purchase`,type:`number | null`,required:true,id:`param-max-purchase-9`,children:_jsx(_components.p,{children:`Maximum units a customer can purchase beyond included. E.g. if included=100 and max_purchase=300, customer can use up to 400 total before usage is capped. Null for no limit.`})}),_jsxs(ParamField,{body:`processors`,type:`object`,id:`param-processors-11`,children:[_jsx(_components.p,{children:`Payment processors this item price is connected to. Omitted when unset.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`stripe`,type:`object | null`,id:`param-stripe-11`,children:_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`price_id`,type:`string`,required:true,id:`param-price-id-8`,children:_jsx(_components.p,{children:`Stripe price ID. For prepaid with included > 0 this is the V2 price.`})})})})})]})]})]}),_jsxs(ParamField,{body:`display`,type:`object`,id:`param-display-12`,children:[_jsx(_components.p,{children:`Display text for showing this item in pricing pages.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`primary_text`,type:`string`,required:true,id:`param-primary-text-8`,children:_jsx(_components.p,{children:`Main display text (e.g. ‘$10’ or ‘100 messages’).`})}),_jsx(ParamField,{body:`secondary_text`,type:`string`,id:`param-secondary-text-8`,children:_jsx(_components.p,{children:`Secondary display text (e.g. ‘per month’ or ‘then $0.5 per 100’).`})})]})]}),_jsxs(ParamField,{body:`rollover`,type:`object`,id:`param-rollover-9`,children:[_jsx(_components.p,{children:`Rollover configuration for unused units. If set, unused included units roll over to the next period.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`max`,type:`number | null`,required:true,id:`param-max-9`,children:_jsx(_components.p,{children:`Maximum rollover units. Null for unlimited rollover.`})}),_jsx(ParamField,{body:`max_percentage`,type:`number | null`,id:`param-max-percentage-9`,children:_jsx(_components.p,{children:`Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.`})}),_jsx(ParamField,{body:`expiry_duration_type`,type:`'month' | 'forever'`,required:true,id:`param-expiry-duration-type-9`,children:_jsx(_components.p,{children:`When rolled over units expire.`})}),_jsx(ParamField,{body:`expiry_duration_length`,type:`number`,id:`param-expiry-duration-length-9`,children:_jsx(_components.p,{children:`Number of periods before expiry.`})})]})]}),_jsxs(ParamField,{body:`expiry`,type:`object | null`,id:`param-expiry-9`,children:[_jsx(_components.p,{children:`Purchased units expire this long after each purchase. One-off prepaid consumable items only.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`duration`,type:`'day' | 'week' | 'month' | 'year'`,required:true,id:`param-duration-9`}),_jsx(ParamField,{body:`length`,type:`number`,required:true,id:`param-length-9`})]})]}),_jsxs(ParamField,{body:`feature_override`,type:`object`,id:`param-feature-override-9`,children:[_jsx(_components.p,{children:`Overrides fields of this item’s feature for customers on this plan (e.g. a credit system’s credit_schema).`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`credit_schema`,type:`object | object | object[]`,id:`param-credit-schema-13`,children:[_jsxs(_components.p,{children:[`For credit system features: merges into the feature’s credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `,_jsx(_components.code,{children:`excluded: true`}),` removes it, and unlisted features keep the credit system’s rate.`]}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`metered_feature_id`,type:`string`,id:`param-metered-feature-id-13`,children:_jsx(_components.p,{children:`ID of the metered feature that draws from this credit system.`})}),_jsx(ParamField,{body:`billing_units`,type:`number`,id:`param-billing-units-19`,children:_jsx(_components.p,{children:`Number of metered-feature units priced together. Defaults to one when omitted.`})}),_jsxs(ParamField,{body:`dimensions.{key}`,type:`object`,id:`param-dimensions-key-9`,children:[_jsx(_components.p,{children:`Named rates chosen by event properties. The most specific match sets the rate; with no match the item’s own rate applies.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`match.{key}`,type:`string`,required:true,id:`param-match-key-18`,children:_jsx(_components.p,{children:`Event properties this entry applies to. Every key must equal the tracked property, compared as strings.`})}),_jsx(ParamField,{body:`priority`,type:`integer`,id:`param-priority-9`,children:_jsx(_components.p,{children:`Breaks ties between dimensions that match the same number of keys. Higher wins.`})}),_jsx(ParamField,{body:`tier_behavior`,type:`string`,required:true,id:`param-tier-behavior-28`}),_jsx(ParamField,{body:`tiers`,type:`object[]`,required:true,id:`param-tiers-28`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-28`,children:_jsx(_components.p,{children:`Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-31`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group within this tier.`})})]})})]})]}),_jsxs(ParamField,{body:`multipliers.{key}`,type:`object`,id:`param-multipliers-key-9`,children:[_jsx(_components.p,{children:`Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`match.{key}`,type:`string`,required:true,id:`param-match-key-19`,children:_jsx(_components.p,{children:`Event properties this entry applies to. Every key must equal the tracked property, compared as strings.`})}),_jsx(ParamField,{body:`factor`,type:`number`,id:`param-factor-9`,children:_jsx(_components.p,{children:`Multiplies the matched rate. All matching multipliers stack.`})}),_jsx(ParamField,{body:`add`,type:`number`,id:`param-add-9`,children:_jsx(_components.p,{children:`Added to the rate after every factor is applied, in credits per billing-unit group.`})})]})]}),_jsx(ParamField,{body:`tier_behavior`,type:`string`,id:`param-tier-behavior-29`}),_jsx(ParamField,{body:`tiers`,type:`object[]`,id:`param-tiers-29`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-29`,children:_jsx(_components.p,{children:`Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-32`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group within this tier.`})})]})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,id:`param-credit-cost-33`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group.`})}),_jsx(ParamField,{body:`excluded`,type:`true`,id:`param-excluded-9`,children:_jsx(_components.p,{children:`Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.`})})]})]}),_jsxs(ParamField,{body:`markups`,type:`object`,id:`param-markups-9`,children:[_jsx(_components.p,{children:`For AI credit system features: replaces the feature’s markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature’s.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`default_markup`,type:`number`,id:`param-default-markup-9`,children:_jsx(_components.p,{children:`Default percentage markup for customers on this plan. Use -100 to make usage free.`})}),_jsxs(ParamField,{body:`provider_markups.{key}`,type:`object | null`,id:`param-provider-markups-key-9`,children:[_jsx(_components.p,{children:`Per-provider markup percentages for customers on this plan.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`markup`,type:`number`,required:true,id:`param-markup-18`})})]}),_jsxs(ParamField,{body:`model_markups.{key}`,type:`object | null`,id:`param-model-markups-key-9`,children:[_jsx(_components.p,{children:`Per-model markup overrides for customers on this plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`markup`,type:`number`,id:`param-markup-19`}),_jsx(ParamField,{body:`input_cost`,type:`number`,id:`param-input-cost-9`}),_jsx(ParamField,{body:`output_cost`,type:`number`,id:`param-output-cost-9`})]})]})]})]})]})]})]})]}),_jsxs(ParamField,{body:`processors`,type:`object`,id:`param-processors-12`,children:[_jsx(_components.p,{children:`Payment processors this plan is connected to. Omitted when unset.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`stripe`,type:`object | null`,id:`param-stripe-12`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`product_id`,type:`string`,required:true,id:`param-product-id-6`,children:_jsx(_components.p,{children:`Stripe product ID this plan is billed under.`})}),_jsx(ParamField,{body:`additional_product_ids`,type:`string[]`,id:`param-additional-product-ids-3`,children:_jsx(_components.p,{children:`Extra Stripe product IDs aliased to this plan.`})})]})}),_jsx(ParamField,{body:`revenuecat`,type:`object | null`,id:`param-revenuecat-3`,children:_jsx(Expandable,{title:`properties`,children:_jsxs(ParamField,{body:`products`,type:`object[]`,required:true,id:`param-products-3`,children:[_jsx(_components.p,{children:`Every RevenueCat product that maps to this plan. Replaces the current set.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`product_id`,type:`string`,required:true,id:`param-product-id-7`,children:_jsx(_components.p,{children:`RevenueCat product ID that grants this plan when purchased.`})}),_jsxs(ParamField,{body:`feature_quantities`,type:`object[]`,id:`param-feature-quantities-3`,children:[_jsx(_components.p,{children:`Prepaid quantities granted when this specific RevenueCat product is purchased, in feature units.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-50`}),_jsx(ParamField,{body:`quantity`,type:`number`,id:`param-quantity-9`})]})]})]})]})})})]})]}),_jsxs(ParamField,{body:`free_trial`,type:`object`,id:`param-free-trial-6`,children:[_jsx(_components.p,{children:`Free trial configuration. If set, new customers can try this plan before being charged.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`duration_length`,type:`number`,required:true,id:`param-duration-length-8`,children:_jsx(_components.p,{children:`Number of duration_type periods the trial lasts.`})}),_jsx(ParamField,{body:`duration_type`,type:`'day' | 'month' | 'year'`,required:true,id:`param-duration-type-8`,children:_jsx(_components.p,{children:`Unit of time for the trial duration (‘day’, ‘month’, ‘year’).`})}),_jsx(ParamField,{body:`card_required`,type:`boolean`,required:true,id:`param-card-required-8`,children:_jsx(_components.p,{children:`Whether a payment method is required to start the trial. If true, customer will be charged after trial ends.`})}),_jsx(ParamField,{body:`on_end`,type:`'bill' | 'revert'`,id:`param-on-end-8`,children:_jsx(_components.p,{children:`Behavior when the trial ends. ‘bill’ charges the customer (default). ‘revert’ expires the trial and restores the customer’s previous plan.`})})]})]}),_jsx(ParamField,{body:`created_at`,type:`number`,required:true,id:`param-created-at-2`,children:_jsx(_components.p,{children:`Unix timestamp (ms) when the plan was created.`})}),_jsx(ParamField,{body:`env`,type:`'sandbox' | 'live'`,required:true,id:`param-env-2`,children:_jsx(_components.p,{children:`Environment this plan belongs to (‘sandbox’ or ‘live’).`})}),_jsx(ParamField,{body:`archived`,type:`boolean`,required:true,id:`param-archived-7`,children:_jsx(_components.p,{children:`Whether the plan is archived. Archived plans cannot be attached to new customers.`})}),_jsxs(ParamField,{body:`config`,type:`object`,required:true,id:`param-config-3`,children:[_jsx(_components.p,{children:`Miscellaneous plan-level configuration flags.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`ignore_past_due`,type:`boolean`,required:true,id:`param-ignore-past-due-3`,children:_jsx(_components.p,{children:`If true, entitlements attached to this plan will still reset on schedule even when the customer’s product is in a past_due state.`})}),_jsx(ParamField,{body:`anchor_to_month_start`,type:`boolean`,id:`param-anchor-to-month-start-3`})]})]}),_jsxs(ParamField,{body:`billing_controls`,type:`object`,id:`param-billing-controls-6`,children:[_jsx(_components.p,{children:`Plan-level billing controls used as customer defaults.`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`auto_topups`,type:`object[]`,id:`param-auto-topups-6`,children:[_jsx(_components.p,{children:`List of auto top-up configurations per feature.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-51`,children:_jsx(_components.p,{children:`The ID of the feature (credit balance) to auto top-up.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-30`,children:_jsx(_components.p,{children:`Whether auto top-up is enabled.`})}),_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-22`,children:_jsx(_components.p,{children:`When the balance drops below this threshold, an auto top-up will be purchased.`})}),_jsx(ParamField,{body:`quantity`,type:`number`,required:true,id:`param-quantity-10`,children:_jsx(_components.p,{children:`Amount of credits to add per auto top-up.`})}),_jsxs(ParamField,{body:`purchase_limit`,type:`object`,id:`param-purchase-limit-6`,children:[_jsx(_components.p,{children:`Optional limit on auto top-ups per window, by number of top-ups or amount charged.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`limit_type`,type:`'count' | 'amount'`,id:`param-limit-type-12`,children:_jsxs(_components.p,{children:[`What `,_jsx(_components.code,{children:`limit`}),` caps: the number of auto top-ups (`,_jsx(_components.code,{children:`count`}),`, default) or the total amount charged for them, in the customer’s currency (`,_jsx(_components.code,{children:`amount`}),`).`]})}),_jsx(ParamField,{body:`interval`,type:`'hour' | 'day' | 'week' | 'month'`,required:true,id:`param-interval-49`,children:_jsx(_components.p,{children:`The time interval for the purchase limit window.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,required:true,id:`param-interval-count-43`,children:_jsx(_components.p,{children:`Number of intervals in the purchase limit window.`})}),_jsx(ParamField,{body:`limit`,type:`number`,required:true,id:`param-limit-12`,children:_jsx(_components.p,{children:`Maximum allowed within the interval: a number of auto top-ups when limit_type is count, or a total charge (e.g. 500 for $500, pre-tax) when limit_type is amount.`})})]})]}),_jsx(ParamField,{body:`invoice_mode`,type:`boolean`,id:`param-invoice-mode-6`,children:_jsx(_components.p,{children:`When true, auto top-up creates a send_invoice invoice instead of auto-charging.`})})]})]}),_jsxs(ParamField,{body:`spend_limits`,type:`object[]`,id:`param-spend-limits-6`,children:[_jsx(_components.p,{children:`List of overage spend limits per feature (caps overage spend).`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,id:`param-feature-id-52`,children:_jsx(_components.p,{children:`Optional feature ID this spend limit applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-31`,children:_jsx(_components.p,{children:`Whether the overage spend limit is enabled.`})}),_jsx(ParamField,{body:`limit_type`,type:`'absolute' | 'usage_percentage'`,id:`param-limit-type-13`,children:_jsx(_components.p,{children:`How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.`})}),_jsx(ParamField,{body:`overage_limit`,type:`number`,id:`param-overage-limit-6`,children:_jsx(_components.p,{children:`Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.`})}),_jsx(ParamField,{body:`skip_overage_billing`,type:`boolean`,id:`param-skip-overage-billing-6`,children:_jsx(_components.p,{children:`When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.`})})]})]}),_jsxs(ParamField,{body:`usage_limits`,type:`object[]`,id:`param-usage-limits-6`,children:[_jsx(_components.p,{children:`List of hard usage caps per feature (max units per interval).`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-53`,children:_jsx(_components.p,{children:`The feature this usage limit applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-32`,children:_jsx(_components.p,{children:`Whether this usage limit is enabled.`})}),_jsx(ParamField,{body:`limit`,type:`number`,required:true,id:`param-limit-13`,children:_jsx(_components.p,{children:`Maximum units allowed per interval.`})}),_jsx(ParamField,{body:`interval`,type:`'day' | 'week' | 'month' | 'year'`,required:true,id:`param-interval-50`,children:_jsx(_components.p,{children:`Interval for the cap, aligned to the customer’s billing cycle.`})}),_jsx(ParamField,{body:`anchor`,type:`'billing_cycle' | 'utc'`,id:`param-anchor-6`,children:_jsx(_components.p,{children:`Window alignment. ‘billing_cycle’ phases the interval to the customer’s renewal time; ‘utc’ aligns to the UTC calendar.`})}),_jsxs(ParamField,{body:`filter`,type:`object`,id:`param-filter-12`,children:[_jsx(_components.p,{children:`When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`properties.{key}`,type:`string`,required:true,id:`param-properties-key-12`})})]})]})]}),_jsxs(ParamField,{body:`usage_alerts`,type:`object[]`,id:`param-usage-alerts-6`,children:[_jsx(_components.p,{children:`List of usage alert configurations per feature.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,id:`param-feature-id-54`,children:_jsx(_components.p,{children:`The feature ID this alert applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-33`,children:_jsx(_components.p,{children:`Whether this usage alert is enabled.`})}),_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-23`,children:_jsx(_components.p,{children:`The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage. remaining and remaining_percentage accept negative values with basis balance, to alert once the balance is overdrawn.`})}),_jsx(ParamField,{body:`threshold_type`,type:`'usage' | 'usage_percentage' | 'remaining' | 'remaining_percentage'`,required:true,id:`param-threshold-type-6`,children:_jsx(_components.p,{children:`Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.`})}),_jsx(ParamField,{body:`basis`,type:`'balance' | 'included' | 'recurring' | 'usage_limit'`,required:true,id:`param-basis-6`,children:_jsx(_components.p,{children:`What 100% means. balance: every grant on the feature. included: the plan allowance only. recurring: grants that reset. usage_limit: the cap of the usage limit with the same feature and filter.`})}),_jsxs(ParamField,{body:`filter`,type:`object`,id:`param-filter-13`,children:[_jsx(_components.p,{children:`Only valid with basis usage_limit. Points the alert at the usage limit carrying the same filter.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`properties.{key}`,type:`string`,required:true,id:`param-properties-key-13`})})]}),_jsx(ParamField,{body:`name`,type:`string`,id:`param-name-14`,children:_jsx(_components.p,{children:`Optional user-defined label to distinguish multiple alerts on the same feature.`})})]})]}),_jsxs(ParamField,{body:`overage_allowed`,type:`object[]`,id:`param-overage-allowed-6`,children:[_jsx(_components.p,{children:`List of overage allowed controls per feature. When enabled, usage can exceed balance.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-55`,children:_jsx(_components.p,{children:`The feature ID this overage allowed control applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-34`,children:_jsx(_components.p,{children:`Whether overage is allowed for this feature.`})})]})]})]})]}),_jsx(ParamField,{body:`metadata`,type:`object`,required:true,id:`param-metadata-7`,children:_jsx(_components.p,{children:`Arbitrary key-value metadata defined by you for your own use. Shared across all versions of the plan.`})}),_jsx(ParamField,{body:`customer_eligibility`,type:`object`,id:`param-customer-eligibility-2`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`trial_available`,type:`boolean`,id:`param-trial-available-2`,children:_jsx(_components.p,{children:`Whether the trial on this plan is available to this customer. For example, if the customer used the trial in the past, this will be false.`})}),_jsx(ParamField,{body:`status`,type:`'active' | 'scheduled'`,id:`param-status-5`,children:_jsx(_components.p,{children:`The customer’s current status with this plan. ‘active’ if attached, ‘scheduled’ if pending activation.`})}),_jsx(ParamField,{body:`canceling`,type:`boolean`,id:`param-canceling-2`,children:_jsx(_components.p,{children:`Whether the customer’s active instance of this plan is set to cancel.`})}),_jsx(ParamField,{body:`trialing`,type:`boolean`,id:`param-trialing-2`,children:_jsx(_components.p,{children:`Whether the customer is currently on a free trial of this plan.`})}),_jsx(ParamField,{body:`attach_action`,type:`'activate' | 'upgrade' | 'downgrade' | 'none' | 'purchase'`,required:true,id:`param-attach-action-2`,children:_jsx(_components.p,{children:`The action that would occur if this plan were attached to the customer.`})})]})}),_jsx(ParamField,{body:`base_variant_id`,type:`string | null`,required:true,id:`param-base-variant-id-3`,children:_jsx(_components.p,{children:`Deprecated. Use variant_details.base_plan_id instead. If this is a variant, the ID of the base plan it was created from.`})}),_jsxs(ParamField,{body:`variant_details`,type:`object`,id:`param-variant-details-2`,children:[_jsx(_components.p,{children:`Details about how this variant relates to its latest base plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`base_plan_id`,type:`string`,required:true,id:`param-base-plan-id-2`,children:_jsx(_components.p,{children:`The ID of the base plan this variant was derived from.`})}),_jsxs(ParamField,{body:`customize`,type:`object`,id:`param-customize-6`,children:[_jsx(_components.p,{children:`The customization that transforms the base plan into this variant.`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`price`,type:`object | null`,id:`param-price-19`,children:[_jsx(_components.p,{children:`Base price configuration for a plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-65`,children:_jsx(_components.p,{children:`Base price amount for the plan, in major currency units (e.g. dollars).`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-51`,children:_jsx(_components.p,{children:`Billing interval (e.g. ‘month’, ‘year’).`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-44`}),_jsxs(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-31`,children:[_jsx(_components.p,{children:`Base price amounts in additional currencies. The base ‘amount’ is in the org’s default currency.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-31`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-66`,children:_jsx(_components.p,{children:`Price amount in this currency. Set explicitly per currency, not converted from the base amount.`})})]})]})]})]}),_jsxs(ParamField,{body:`add_items`,type:`object[]`,id:`param-add-items-6`,children:[_jsx(_components.p,{children:`Items to add to the plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`threshold_billing`,type:`object | null`,id:`param-threshold-billing-10`,children:[_jsx(_components.p,{children:`Bills this many feature units when outstanding overage reaches it.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-24`})})]}),_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-56`,children:_jsx(_components.p,{children:`The ID of the feature to configure.`})}),_jsx(ParamField,{body:`included`,type:`number`,id:`param-included-21`,children:_jsx(_components.p,{children:`Number of free units included. Balance resets to this each interval for consumable features.`})}),_jsx(ParamField,{body:`unlimited`,type:`boolean`,id:`param-unlimited-10`,children:_jsx(_components.p,{children:`If true, customer has unlimited access to this feature.`})}),_jsx(ParamField,{body:`pooled`,type:`boolean`,id:`param-pooled-10`,children:_jsx(_components.p,{children:`Whether entity-level grants contribute to a shared customer balance.`})}),_jsxs(ParamField,{body:`reset`,type:`object`,id:`param-reset-10`,children:[_jsx(_components.p,{children:`Reset configuration for consumable features. Omit for non-consumable features like seats.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`interval`,type:`'one_off' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-52`,children:_jsx(_components.p,{children:`Interval at which balance resets (e.g. ‘month’, ‘year’). For consumable features only.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-45`})]})]}),_jsxs(ParamField,{body:`price`,type:`object`,id:`param-price-20`,children:[_jsx(_components.p,{children:`Pricing for usage beyond included units. Omit for free features.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-67`,children:_jsx(_components.p,{children:`Price per billing_units after included usage. Either ‘amount’ or ‘tiers’ is required.`})}),_jsxs(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-32`,children:[_jsx(_components.p,{children:`Amounts in additional currencies for this flat price. The base ‘amount’ is in the org’s default currency. Only valid with ‘amount’, not ‘tiers’.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-32`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-68`,children:_jsx(_components.p,{children:`Price amount in this currency. Set explicitly per currency, not converted from the base amount.`})})]})]}),_jsxs(ParamField,{body:`tiers`,type:`object[]`,id:`param-tiers-30`,children:[_jsx(_components.p,{children:`Tiered pricing. Either ‘amount’ or ‘tiers’ is required.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-30`}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-69`}),_jsx(ParamField,{body:`flat_amount`,type:`number`,id:`param-flat-amount-20`}),_jsx(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-33`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-33`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-70`,children:_jsx(_components.p,{children:`Per-unit amount for this tier in this currency.`})}),_jsx(ParamField,{body:`flat_amount`,type:`number`,id:`param-flat-amount-21`,children:_jsx(_components.p,{children:`Flat amount for this tier in this currency, if the tier uses one.`})})]})})]})]}),_jsx(ParamField,{body:`tier_behavior`,type:`'graduated' | 'volume'`,id:`param-tier-behavior-30`,children:_jsx(_components.p,{children:`How tiers price usage. ‘graduated’ (default) charges each unit at the rate of the tier it falls in. ‘volume’ picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier’s rate plus its flat_amount.`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-53`,children:_jsx(_components.p,{children:`Billing interval. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-46`,children:_jsx(_components.p,{children:`Number of intervals per billing cycle. Defaults to 1.`})}),_jsx(ParamField,{body:`billing_units`,type:`number`,id:`param-billing-units-20`,children:_jsx(_components.p,{children:`Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).`})}),_jsx(ParamField,{body:`billing_method`,type:`'prepaid' | 'usage_based'`,required:true,id:`param-billing-method-16`,children:_jsx(_components.p,{children:`‘prepaid’ for upfront payment (seats), ‘usage_based’ for pay-as-you-go.`})}),_jsx(ParamField,{body:`max_purchase`,type:`number | null`,id:`param-max-purchase-10`,children:_jsx(_components.p,{children:`Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.`})})]})]}),_jsxs(ParamField,{body:`proration`,type:`object`,id:`param-proration-6`,children:[_jsx(_components.p,{children:`Proration settings for prepaid features. Controls mid-cycle quantity change billing.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`on_increase`,type:`'bill_immediately' | 'prorate_immediately' | 'prorate_next_cycle' | 'bill_next_cycle'`,required:true,id:`param-on-increase-6`,children:_jsx(_components.p,{children:`Billing behavior when quantity increases mid-cycle.`})}),_jsx(ParamField,{body:`on_decrease`,type:`'prorate' | 'prorate_immediately' | 'prorate_next_cycle' | 'none' | 'no_prorations'`,required:true,id:`param-on-decrease-6`,children:_jsx(_components.p,{children:`Credit behavior when quantity decreases mid-cycle.`})})]})]}),_jsxs(ParamField,{body:`rollover`,type:`object`,id:`param-rollover-10`,children:[_jsx(_components.p,{children:`Rollover config for unused units. If set, unused included units carry over.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`max`,type:`number`,id:`param-max-10`,children:_jsx(_components.p,{children:`Max rollover units. Omit for unlimited rollover.`})}),_jsx(ParamField,{body:`max_percentage`,type:`number`,id:`param-max-percentage-10`,children:_jsx(_components.p,{children:`Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.`})}),_jsx(ParamField,{body:`expiry_duration_type`,type:`'month' | 'forever'`,required:true,id:`param-expiry-duration-type-10`,children:_jsx(_components.p,{children:`When rolled over units expire.`})}),_jsx(ParamField,{body:`expiry_duration_length`,type:`number`,id:`param-expiry-duration-length-10`,children:_jsx(_components.p,{children:`Number of periods before expiry.`})})]})]}),_jsxs(ParamField,{body:`expiry`,type:`object`,id:`param-expiry-10`,children:[_jsx(_components.p,{children:`Purchased units expire this long after each purchase. One-off prepaid consumable items only.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`duration`,type:`'day' | 'week' | 'month' | 'year'`,required:true,id:`param-duration-10`}),_jsx(ParamField,{body:`length`,type:`number`,required:true,id:`param-length-10`})]})]}),_jsxs(ParamField,{body:`feature_override`,type:`object`,id:`param-feature-override-10`,children:[_jsx(_components.p,{children:`Overrides fields of this item’s feature for customers on this plan (e.g. a credit system’s credit_schema).`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`credit_schema`,type:`object | object | object[]`,id:`param-credit-schema-14`,children:[_jsxs(_components.p,{children:[`For credit system features: merges into the feature’s credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `,_jsx(_components.code,{children:`excluded: true`}),` removes it, and unlisted features keep the credit system’s rate.`]}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`metered_feature_id`,type:`string`,id:`param-metered-feature-id-14`,children:_jsx(_components.p,{children:`ID of the metered feature that draws from this credit system.`})}),_jsx(ParamField,{body:`billing_units`,type:`number`,id:`param-billing-units-21`,children:_jsx(_components.p,{children:`Number of metered-feature units priced together. Defaults to one when omitted.`})}),_jsxs(ParamField,{body:`dimensions.{key}`,type:`object`,id:`param-dimensions-key-10`,children:[_jsx(_components.p,{children:`Named rates chosen by event properties. The most specific match sets the rate; with no match the item’s own rate applies.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`match.{key}`,type:`string`,required:true,id:`param-match-key-20`,children:_jsx(_components.p,{children:`Event properties this entry applies to. Every key must equal the tracked property, compared as strings.`})}),_jsx(ParamField,{body:`priority`,type:`integer`,id:`param-priority-10`,children:_jsx(_components.p,{children:`Breaks ties between dimensions that match the same number of keys. Higher wins.`})}),_jsx(ParamField,{body:`tier_behavior`,type:`string`,required:true,id:`param-tier-behavior-31`}),_jsx(ParamField,{body:`tiers`,type:`object[]`,required:true,id:`param-tiers-31`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-31`,children:_jsx(_components.p,{children:`Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-34`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group within this tier.`})})]})})]})]}),_jsxs(ParamField,{body:`multipliers.{key}`,type:`object`,id:`param-multipliers-key-10`,children:[_jsx(_components.p,{children:`Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`match.{key}`,type:`string`,required:true,id:`param-match-key-21`,children:_jsx(_components.p,{children:`Event properties this entry applies to. Every key must equal the tracked property, compared as strings.`})}),_jsx(ParamField,{body:`factor`,type:`number`,id:`param-factor-10`,children:_jsx(_components.p,{children:`Multiplies the matched rate. All matching multipliers stack.`})}),_jsx(ParamField,{body:`add`,type:`number`,id:`param-add-10`,children:_jsx(_components.p,{children:`Added to the rate after every factor is applied, in credits per billing-unit group.`})})]})]}),_jsx(ParamField,{body:`tier_behavior`,type:`string`,id:`param-tier-behavior-32`}),_jsx(ParamField,{body:`tiers`,type:`object[]`,id:`param-tiers-32`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-32`,children:_jsx(_components.p,{children:`Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-35`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group within this tier.`})})]})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,id:`param-credit-cost-36`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group.`})}),_jsx(ParamField,{body:`excluded`,type:`true`,id:`param-excluded-10`,children:_jsx(_components.p,{children:`Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.`})})]})]}),_jsxs(ParamField,{body:`markups`,type:`object`,id:`param-markups-10`,children:[_jsx(_components.p,{children:`For AI credit system features: replaces the feature’s markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature’s.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`default_markup`,type:`number`,id:`param-default-markup-10`,children:_jsx(_components.p,{children:`Default percentage markup for customers on this plan. Use -100 to make usage free.`})}),_jsxs(ParamField,{body:`provider_markups.{key}`,type:`object | null`,id:`param-provider-markups-key-10`,children:[_jsx(_components.p,{children:`Per-provider markup percentages for customers on this plan.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`markup`,type:`number`,required:true,id:`param-markup-20`})})]}),_jsxs(ParamField,{body:`model_markups.{key}`,type:`object | null`,id:`param-model-markups-key-10`,children:[_jsx(_components.p,{children:`Per-model markup overrides for customers on this plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`markup`,type:`number`,id:`param-markup-21`}),_jsx(ParamField,{body:`input_cost`,type:`number`,id:`param-input-cost-10`}),_jsx(ParamField,{body:`output_cost`,type:`number`,id:`param-output-cost-10`})]})]})]})]})]})]})]})]}),_jsxs(ParamField,{body:`remove_items`,type:`object[]`,id:`param-remove-items-6`,children:[_jsx(_components.p,{children:`Filters selecting items to remove from the plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,id:`param-feature-id-57`,children:_jsx(_components.p,{children:`Match items linked to this feature.`})}),_jsx(ParamField,{body:`billing_method`,type:`'prepaid' | 'usage_based'`,id:`param-billing-method-17`,children:_jsx(_components.p,{children:`Match items with this billing method (prepaid or usage_based).`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,id:`param-interval-54`,children:_jsx(_components.p,{children:`Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.`})}),_jsx(ParamField,{body:`interval_count`,type:`integer`,id:`param-interval-count-47`,children:_jsx(_components.p,{children:`Match items with this interval_count. Disambiguates between items that share an interval but differ in count.`})}),_jsx(ParamField,{body:`included`,type:`number`,id:`param-included-22`,children:_jsx(_components.p,{children:`Match items whose grant equals this included usage. Omitted is a wildcard.`})})]})]}),_jsxs(ParamField,{body:`free_trial`,type:`object | null`,id:`param-free-trial-7`,children:[_jsx(_components.p,{children:`Free trial configuration for a plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`duration_length`,type:`number`,required:true,id:`param-duration-length-9`,children:_jsx(_components.p,{children:`Number of duration_type periods the trial lasts.`})}),_jsx(ParamField,{body:`duration_type`,type:`'day' | 'month' | 'year'`,required:true,id:`param-duration-type-9`,children:_jsx(_components.p,{children:`Unit of time for the trial (‘day’, ‘month’, ‘year’).`})}),_jsx(ParamField,{body:`card_required`,type:`boolean`,required:true,id:`param-card-required-9`,children:_jsx(_components.p,{children:`If true, a payment method is required to start the trial and the customer is charged when it ends. Defaults to false.`})}),_jsx(ParamField,{body:`on_end`,type:`'bill' | 'revert'`,id:`param-on-end-9`})]})]}),_jsxs(ParamField,{body:`billing_controls`,type:`object`,id:`param-billing-controls-7`,children:[_jsx(_components.p,{children:`Override the plan’s billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`auto_topups`,type:`object[]`,id:`param-auto-topups-7`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-58`,children:_jsx(_components.p,{children:`The ID of the feature (credit balance) to auto top-up.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-35`,children:_jsx(_components.p,{children:`Whether auto top-up is enabled.`})}),_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-25`,children:_jsx(_components.p,{children:`When the balance drops below this threshold, an auto top-up will be purchased.`})}),_jsx(ParamField,{body:`quantity`,type:`number`,required:true,id:`param-quantity-11`,children:_jsx(_components.p,{children:`Amount of credits to add per auto top-up.`})}),_jsxs(ParamField,{body:`purchase_limit`,type:`object`,id:`param-purchase-limit-7`,children:[_jsx(_components.p,{children:`Optional rate limit to cap how often auto top-ups occur. Pass count or amount to set the current window’s consumed top-ups or charged amount.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`limit_type`,type:`'count' | 'amount'`,id:`param-limit-type-14`,children:_jsxs(_components.p,{children:[`What `,_jsx(_components.code,{children:`limit`}),` caps: the number of auto top-ups (`,_jsx(_components.code,{children:`count`}),`, default) or the total amount charged for them, in the customer’s currency (`,_jsx(_components.code,{children:`amount`}),`).`]})}),_jsx(ParamField,{body:`interval`,type:`'hour' | 'day' | 'week' | 'month'`,required:true,id:`param-interval-55`,children:_jsx(_components.p,{children:`The time interval for the purchase limit window.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,required:true,id:`param-interval-count-48`,children:_jsx(_components.p,{children:`Number of intervals in the purchase limit window.`})}),_jsx(ParamField,{body:`limit`,type:`number`,required:true,id:`param-limit-14`,children:_jsx(_components.p,{children:`Maximum allowed within the interval: a number of auto top-ups when limit_type is count, or a total charge (e.g. 500 for $500, pre-tax) when limit_type is amount.`})}),_jsx(ParamField,{body:`count`,type:`number`,id:`param-count-3`,children:_jsx(_components.p,{children:`Set the current window’s consumed auto top-up count. Omit to leave runtime state unchanged.`})}),_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-71`,children:_jsx(_components.p,{children:`Set the amount already charged by auto top-ups in the current window. Omit to leave runtime state unchanged.`})})]})]}),_jsx(ParamField,{body:`invoice_mode`,type:`boolean`,id:`param-invoice-mode-7`,children:_jsx(_components.p,{children:`When true, auto top-up creates a send_invoice invoice instead of auto-charging.`})})]})}),_jsx(ParamField,{body:`spend_limits`,type:`object[]`,id:`param-spend-limits-7`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,id:`param-feature-id-59`,children:_jsx(_components.p,{children:`Optional feature ID this spend limit applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-36`,children:_jsx(_components.p,{children:`Whether the overage spend limit is enabled.`})}),_jsx(ParamField,{body:`limit_type`,type:`'absolute' | 'usage_percentage'`,id:`param-limit-type-15`,children:_jsx(_components.p,{children:`How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.`})}),_jsx(ParamField,{body:`overage_limit`,type:`number`,id:`param-overage-limit-7`,children:_jsx(_components.p,{children:`Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.`})}),_jsx(ParamField,{body:`skip_overage_billing`,type:`boolean`,id:`param-skip-overage-billing-7`,children:_jsx(_components.p,{children:`When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.`})})]})}),_jsx(ParamField,{body:`usage_limits`,type:`object[]`,id:`param-usage-limits-7`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-60`,children:_jsx(_components.p,{children:`The feature this usage limit applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-37`,children:_jsx(_components.p,{children:`Whether this usage limit is enabled.`})}),_jsx(ParamField,{body:`limit`,type:`number`,required:true,id:`param-limit-15`,children:_jsx(_components.p,{children:`Maximum units allowed per interval.`})}),_jsx(ParamField,{body:`interval`,type:`'day' | 'week' | 'month' | 'year'`,required:true,id:`param-interval-56`,children:_jsx(_components.p,{children:`Interval for the cap, aligned to the customer’s billing cycle.`})}),_jsx(ParamField,{body:`anchor`,type:`'billing_cycle' | 'utc'`,id:`param-anchor-7`,children:_jsx(_components.p,{children:`Window alignment. ‘billing_cycle’ phases the interval to the customer’s renewal time; ‘utc’ aligns to the UTC calendar.`})}),_jsxs(ParamField,{body:`filter`,type:`object`,id:`param-filter-14`,children:[_jsx(_components.p,{children:`When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`properties.{key}`,type:`string`,required:true,id:`param-properties-key-14`})})]})]})}),_jsx(ParamField,{body:`usage_alerts`,type:`object[]`,id:`param-usage-alerts-7`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,id:`param-feature-id-61`,children:_jsx(_components.p,{children:`The feature ID this alert applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-38`,children:_jsx(_components.p,{children:`Whether this usage alert is enabled.`})}),_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-26`,children:_jsx(_components.p,{children:`The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage. remaining and remaining_percentage accept negative values with basis balance, to alert once the balance is overdrawn.`})}),_jsx(ParamField,{body:`threshold_type`,type:`'usage' | 'usage_percentage' | 'remaining' | 'remaining_percentage'`,required:true,id:`param-threshold-type-7`,children:_jsx(_components.p,{children:`Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.`})}),_jsx(ParamField,{body:`basis`,type:`'balance' | 'included' | 'recurring' | 'usage_limit'`,required:true,id:`param-basis-7`,children:_jsx(_components.p,{children:`What 100% means. balance: every grant on the feature. included: the plan allowance only. recurring: grants that reset. usage_limit: the cap of the usage limit with the same feature and filter.`})}),_jsxs(ParamField,{body:`filter`,type:`object`,id:`param-filter-15`,children:[_jsx(_components.p,{children:`Only valid with basis usage_limit. Points the alert at the usage limit carrying the same filter.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`properties.{key}`,type:`string`,required:true,id:`param-properties-key-15`})})]}),_jsx(ParamField,{body:`name`,type:`string`,id:`param-name-15`,children:_jsx(_components.p,{children:`Optional user-defined label to distinguish multiple alerts on the same feature.`})})]})}),_jsx(ParamField,{body:`overage_allowed`,type:`object[]`,id:`param-overage-allowed-7`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-62`,children:_jsx(_components.p,{children:`The feature ID this overage allowed control applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-39`,children:_jsx(_components.p,{children:`Whether overage is allowed for this feature.`})})]})})]})]}),_jsxs(ParamField,{body:`upsert_licenses`,type:`object[]`,id:`param-upsert-licenses-3`,children:[_jsx(_components.p,{children:`License links to add or override for this customer, keyed by license_plan_id. Omitted fields inherit the plan catalog link (included defaults to 1 when the license is not in the catalog). A bare entry restores the license to pure catalog inheritance.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`license_plan_id`,type:`string`,required:true,id:`param-license-plan-id-7`}),_jsx(ParamField,{body:`version_slug`,type:`string`,id:`param-version-slug-8`}),_jsx(ParamField,{body:`included`,type:`integer`,id:`param-included-23`}),_jsx(ParamField,{body:`prepaid_only`,type:`boolean`,id:`param-prepaid-only-3`}),_jsx(ParamField,{body:`customize`,type:`object | null`,id:`param-customize-7`,children:_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`price`,type:`object | null`,id:`param-price-21`,children:[_jsx(_components.p,{children:`Base price configuration for a plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-72`,children:_jsx(_components.p,{children:`Base price amount for the plan, in major currency units (e.g. dollars).`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-57`,children:_jsx(_components.p,{children:`Billing interval (e.g. ‘month’, ‘year’).`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-49`}),_jsxs(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-34`,children:[_jsx(_components.p,{children:`Base price amounts in additional currencies. The base ‘amount’ is in the org’s default currency.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-34`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-73`,children:_jsx(_components.p,{children:`Price amount in this currency. Set explicitly per currency, not converted from the base amount.`})})]})]})]})]}),_jsx(ParamField,{body:`add_items`,type:`object[]`,id:`param-add-items-7`,children:_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`threshold_billing`,type:`object | null`,id:`param-threshold-billing-11`,children:[_jsx(_components.p,{children:`Bills this many feature units when outstanding overage reaches it.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-27`})})]}),_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-63`,children:_jsx(_components.p,{children:`The ID of the feature to configure.`})}),_jsx(ParamField,{body:`included`,type:`number`,id:`param-included-24`,children:_jsx(_components.p,{children:`Number of free units included. Balance resets to this each interval for consumable features.`})}),_jsx(ParamField,{body:`unlimited`,type:`boolean`,id:`param-unlimited-11`,children:_jsx(_components.p,{children:`If true, customer has unlimited access to this feature.`})}),_jsx(ParamField,{body:`pooled`,type:`boolean`,id:`param-pooled-11`,children:_jsx(_components.p,{children:`Whether entity-level grants contribute to a shared customer balance.`})}),_jsxs(ParamField,{body:`reset`,type:`object`,id:`param-reset-11`,children:[_jsx(_components.p,{children:`Reset configuration for consumable features. Omit for non-consumable features like seats.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`interval`,type:`'one_off' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-58`,children:_jsx(_components.p,{children:`Interval at which balance resets (e.g. ‘month’, ‘year’). For consumable features only.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-50`})]})]}),_jsxs(ParamField,{body:`price`,type:`object`,id:`param-price-22`,children:[_jsx(_components.p,{children:`Pricing for usage beyond included units. Omit for free features.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-74`,children:_jsx(_components.p,{children:`Price per billing_units after included usage. Either ‘amount’ or ‘tiers’ is required.`})}),_jsxs(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-35`,children:[_jsx(_components.p,{children:`Amounts in additional currencies for this flat price. The base ‘amount’ is in the org’s default currency. Only valid with ‘amount’, not ‘tiers’.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-35`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-75`,children:_jsx(_components.p,{children:`Price amount in this currency. Set explicitly per currency, not converted from the base amount.`})})]})]}),_jsxs(ParamField,{body:`tiers`,type:`object[]`,id:`param-tiers-33`,children:[_jsx(_components.p,{children:`Tiered pricing. Either ‘amount’ or ‘tiers’ is required.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-33`}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-76`}),_jsx(ParamField,{body:`flat_amount`,type:`number`,id:`param-flat-amount-22`}),_jsx(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-36`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-36`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-77`,children:_jsx(_components.p,{children:`Per-unit amount for this tier in this currency.`})}),_jsx(ParamField,{body:`flat_amount`,type:`number`,id:`param-flat-amount-23`,children:_jsx(_components.p,{children:`Flat amount for this tier in this currency, if the tier uses one.`})})]})})]})]}),_jsx(ParamField,{body:`tier_behavior`,type:`'graduated' | 'volume'`,id:`param-tier-behavior-33`,children:_jsx(_components.p,{children:`How tiers price usage. ‘graduated’ (default) charges each unit at the rate of the tier it falls in. ‘volume’ picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier’s rate plus its flat_amount.`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-59`,children:_jsx(_components.p,{children:`Billing interval. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-51`,children:_jsx(_components.p,{children:`Number of intervals per billing cycle. Defaults to 1.`})}),_jsx(ParamField,{body:`billing_units`,type:`number`,id:`param-billing-units-22`,children:_jsx(_components.p,{children:`Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).`})}),_jsx(ParamField,{body:`billing_method`,type:`'prepaid' | 'usage_based'`,required:true,id:`param-billing-method-18`,children:_jsx(_components.p,{children:`‘prepaid’ for upfront payment (seats), ‘usage_based’ for pay-as-you-go.`})}),_jsx(ParamField,{body:`max_purchase`,type:`number | null`,id:`param-max-purchase-11`,children:_jsx(_components.p,{children:`Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.`})})]})]}),_jsxs(ParamField,{body:`proration`,type:`object`,id:`param-proration-7`,children:[_jsx(_components.p,{children:`Proration settings for prepaid features. Controls mid-cycle quantity change billing.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`on_increase`,type:`'bill_immediately' | 'prorate_immediately' | 'prorate_next_cycle' | 'bill_next_cycle'`,required:true,id:`param-on-increase-7`,children:_jsx(_components.p,{children:`Billing behavior when quantity increases mid-cycle.`})}),_jsx(ParamField,{body:`on_decrease`,type:`'prorate' | 'prorate_immediately' | 'prorate_next_cycle' | 'none' | 'no_prorations'`,required:true,id:`param-on-decrease-7`,children:_jsx(_components.p,{children:`Credit behavior when quantity decreases mid-cycle.`})})]})]}),_jsxs(ParamField,{body:`rollover`,type:`object`,id:`param-rollover-11`,children:[_jsx(_components.p,{children:`Rollover config for unused units. If set, unused included units carry over.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`max`,type:`number`,id:`param-max-11`,children:_jsx(_components.p,{children:`Max rollover units. Omit for unlimited rollover.`})}),_jsx(ParamField,{body:`max_percentage`,type:`number`,id:`param-max-percentage-11`,children:_jsx(_components.p,{children:`Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.`})}),_jsx(ParamField,{body:`expiry_duration_type`,type:`'month' | 'forever'`,required:true,id:`param-expiry-duration-type-11`,children:_jsx(_components.p,{children:`When rolled over units expire.`})}),_jsx(ParamField,{body:`expiry_duration_length`,type:`number`,id:`param-expiry-duration-length-11`,children:_jsx(_components.p,{children:`Number of periods before expiry.`})})]})]}),_jsxs(ParamField,{body:`expiry`,type:`object`,id:`param-expiry-11`,children:[_jsx(_components.p,{children:`Purchased units expire this long after each purchase. One-off prepaid consumable items only.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`duration`,type:`'day' | 'week' | 'month' | 'year'`,required:true,id:`param-duration-11`}),_jsx(ParamField,{body:`length`,type:`number`,required:true,id:`param-length-11`})]})]}),_jsxs(ParamField,{body:`feature_override`,type:`object`,id:`param-feature-override-11`,children:[_jsx(_components.p,{children:`Overrides fields of this item’s feature for customers on this plan (e.g. a credit system’s credit_schema).`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`credit_schema`,type:`object | object | object[]`,id:`param-credit-schema-15`,children:[_jsxs(_components.p,{children:[`For credit system features: merges into the feature’s credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `,_jsx(_components.code,{children:`excluded: true`}),` removes it, and unlisted features keep the credit system’s rate.`]}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`metered_feature_id`,type:`string`,id:`param-metered-feature-id-15`,children:_jsx(_components.p,{children:`ID of the metered feature that draws from this credit system.`})}),_jsx(ParamField,{body:`billing_units`,type:`number`,id:`param-billing-units-23`,children:_jsx(_components.p,{children:`Number of metered-feature units priced together. Defaults to one when omitted.`})}),_jsxs(ParamField,{body:`dimensions.{key}`,type:`object`,id:`param-dimensions-key-11`,children:[_jsx(_components.p,{children:`Named rates chosen by event properties. The most specific match sets the rate; with no match the item’s own rate applies.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`match.{key}`,type:`string`,required:true,id:`param-match-key-22`,children:_jsx(_components.p,{children:`Event properties this entry applies to. Every key must equal the tracked property, compared as strings.`})}),_jsx(ParamField,{body:`priority`,type:`integer`,id:`param-priority-11`,children:_jsx(_components.p,{children:`Breaks ties between dimensions that match the same number of keys. Higher wins.`})}),_jsx(ParamField,{body:`tier_behavior`,type:`string`,required:true,id:`param-tier-behavior-34`}),_jsx(ParamField,{body:`tiers`,type:`object[]`,required:true,id:`param-tiers-34`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-34`,children:_jsx(_components.p,{children:`Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-37`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group within this tier.`})})]})})]})]}),_jsxs(ParamField,{body:`multipliers.{key}`,type:`object`,id:`param-multipliers-key-11`,children:[_jsx(_components.p,{children:`Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`match.{key}`,type:`string`,required:true,id:`param-match-key-23`,children:_jsx(_components.p,{children:`Event properties this entry applies to. Every key must equal the tracked property, compared as strings.`})}),_jsx(ParamField,{body:`factor`,type:`number`,id:`param-factor-11`,children:_jsx(_components.p,{children:`Multiplies the matched rate. All matching multipliers stack.`})}),_jsx(ParamField,{body:`add`,type:`number`,id:`param-add-11`,children:_jsx(_components.p,{children:`Added to the rate after every factor is applied, in credits per billing-unit group.`})})]})]}),_jsx(ParamField,{body:`tier_behavior`,type:`string`,id:`param-tier-behavior-35`}),_jsx(ParamField,{body:`tiers`,type:`object[]`,id:`param-tiers-35`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-35`,children:_jsx(_components.p,{children:`Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-38`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group within this tier.`})})]})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,id:`param-credit-cost-39`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group.`})}),_jsx(ParamField,{body:`excluded`,type:`true`,id:`param-excluded-11`,children:_jsx(_components.p,{children:`Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.`})})]})]}),_jsxs(ParamField,{body:`markups`,type:`object`,id:`param-markups-11`,children:[_jsx(_components.p,{children:`For AI credit system features: replaces the feature’s markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature’s.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`default_markup`,type:`number`,id:`param-default-markup-11`,children:_jsx(_components.p,{children:`Default percentage markup for customers on this plan. Use -100 to make usage free.`})}),_jsxs(ParamField,{body:`provider_markups.{key}`,type:`object | null`,id:`param-provider-markups-key-11`,children:[_jsx(_components.p,{children:`Per-provider markup percentages for customers on this plan.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`markup`,type:`number`,required:true,id:`param-markup-22`})})]}),_jsxs(ParamField,{body:`model_markups.{key}`,type:`object | null`,id:`param-model-markups-key-11`,children:[_jsx(_components.p,{children:`Per-model markup overrides for customers on this plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`markup`,type:`number`,id:`param-markup-23`}),_jsx(ParamField,{body:`input_cost`,type:`number`,id:`param-input-cost-11`}),_jsx(ParamField,{body:`output_cost`,type:`number`,id:`param-output-cost-11`})]})]})]})]})]})]})]})}),_jsx(ParamField,{body:`remove_items`,type:`object[]`,id:`param-remove-items-7`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,id:`param-feature-id-64`,children:_jsx(_components.p,{children:`Match items linked to this feature.`})}),_jsx(ParamField,{body:`billing_method`,type:`'prepaid' | 'usage_based'`,id:`param-billing-method-19`,children:_jsx(_components.p,{children:`Match items with this billing method (prepaid or usage_based).`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,id:`param-interval-60`,children:_jsx(_components.p,{children:`Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.`})}),_jsx(ParamField,{body:`interval_count`,type:`integer`,id:`param-interval-count-52`,children:_jsx(_components.p,{children:`Match items with this interval_count. Disambiguates between items that share an interval but differ in count.`})}),_jsx(ParamField,{body:`included`,type:`number`,id:`param-included-25`,children:_jsx(_components.p,{children:`Match items whose grant equals this included usage. Omitted is a wildcard.`})})]})})]})}),_jsx(ParamField,{body:`metadata`,type:`object`,id:`param-metadata-8`})]})]}),_jsxs(ParamField,{body:`remove_licenses`,type:`object[]`,id:`param-remove-licenses-3`,children:[_jsx(_components.p,{children:`License links to drop, keyed by license_plan_id. Parallel to remove_items.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`license_plan_id`,type:`string`,required:true,id:`param-license-plan-id-8`})})]})]})]})]})]})]})]}),_jsxs(ParamField,{body:`previous_attributes`,type:`object | null`,required:true,id:`param-previous-attributes-3`,children:[_jsx(_components.p,{children:`Sparse map of scalar plan fields that changed, holding their previous values. Null when the plan is new.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`id`,type:`string | null`,id:`param-id-8`,children:_jsx(_components.p,{children:`Unique identifier for the plan.`})}),_jsx(ParamField,{body:`name`,type:`string | null`,id:`param-name-16`,children:_jsx(_components.p,{children:`Display name of the plan.`})}),_jsx(ParamField,{body:`description`,type:`string | null | null`,id:`param-description-4`,children:_jsx(_components.p,{children:`Optional description of the plan.`})}),_jsx(ParamField,{body:`group`,type:`string | null | null`,id:`param-group-4`,children:_jsx(_components.p,{children:`Group identifier for organizing related plans. Plans in the same group are mutually exclusive.`})}),_jsx(ParamField,{body:`add_on`,type:`boolean | null`,id:`param-add-on-4`,children:_jsx(_components.p,{children:`Whether this is an add-on plan that can be attached alongside a main plan.`})}),_jsx(ParamField,{body:`auto_enable`,type:`boolean | null`,id:`param-auto-enable-4`,children:_jsx(_components.p,{children:`If true, this plan is automatically attached when a customer is created. Used for free plans.`})}),_jsxs(ParamField,{body:`config`,type:`object | null`,id:`param-config-4`,children:[_jsx(_components.p,{children:`Miscellaneous plan-level configuration flags.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`ignore_past_due`,type:`boolean`,required:true,id:`param-ignore-past-due-4`,children:_jsx(_components.p,{children:`If true, entitlements attached to this plan will still reset on schedule even when the customer’s product is in a past_due state.`})}),_jsx(ParamField,{body:`anchor_to_month_start`,type:`boolean`,id:`param-anchor-to-month-start-4`})]})]}),_jsx(ParamField,{body:`active`,type:`boolean | null`,id:`param-active-4`,children:_jsx(_components.p,{children:`Whether this is the active version of the plan. At most one version is active.`})}),_jsx(ParamField,{body:`archived`,type:`boolean | null`,id:`param-archived-8`,children:_jsx(_components.p,{children:`Whether the plan is archived. Archived plans cannot be attached to new customers.`})}),_jsx(ParamField,{body:`metadata`,type:`object | null`,id:`param-metadata-9`,children:_jsx(_components.p,{children:`Arbitrary key-value metadata defined by you for your own use. Shared across all versions of the plan.`})}),_jsxs(ParamField,{body:`processors`,type:`object | null`,id:`param-processors-13`,children:[_jsx(_components.p,{children:`Previous payment processors when they changed. Null when the plan had none.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`stripe`,type:`object | null`,id:`param-stripe-13`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`product_id`,type:`string`,required:true,id:`param-product-id-8`,children:_jsx(_components.p,{children:`Stripe product ID this plan is billed under.`})}),_jsx(ParamField,{body:`additional_product_ids`,type:`string[]`,id:`param-additional-product-ids-4`,children:_jsx(_components.p,{children:`Extra Stripe product IDs aliased to this plan.`})})]})}),_jsx(ParamField,{body:`revenuecat`,type:`object | null`,id:`param-revenuecat-4`,children:_jsx(Expandable,{title:`properties`,children:_jsxs(ParamField,{body:`products`,type:`object[]`,required:true,id:`param-products-4`,children:[_jsx(_components.p,{children:`Every RevenueCat product that maps to this plan. Replaces the current set.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`product_id`,type:`string`,required:true,id:`param-product-id-9`,children:_jsx(_components.p,{children:`RevenueCat product ID that grants this plan when purchased.`})}),_jsxs(ParamField,{body:`feature_quantities`,type:`object[]`,id:`param-feature-quantities-4`,children:[_jsx(_components.p,{children:`Prepaid quantities granted when this specific RevenueCat product is purchased, in feature units.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-65`}),_jsx(ParamField,{body:`quantity`,type:`number`,id:`param-quantity-12`})]})]})]})]})})})]})]}),_jsx(ParamField,{body:`base_variant_id`,type:`string | null`,id:`param-base-variant-id-4`,children:_jsx(_components.p,{children:`The base plan this variant pointed at before this update re-anchored it. Null when it was standalone.`})}),_jsx(ParamField,{body:`base_version`,type:`integer | null`,id:`param-base-version-1`,children:_jsx(_components.p,{children:`The base row version this variant pointed at before this update. Null when it was standalone.`})}),_jsx(ParamField,{body:`base_version_slug`,type:`string | null`,id:`param-base-version-slug-1`,children:_jsx(_components.p,{children:`The base row version slug this variant pointed at before this update. Null when it was standalone.`})}),_jsxs(ParamField,{body:`free_trial`,type:`object | null`,id:`param-free-trial-8`,children:[_jsx(_components.p,{children:`Previous free trial when it changed. Null when the plan had none.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`duration_length`,type:`number`,required:true,id:`param-duration-length-10`,children:_jsx(_components.p,{children:`Number of duration_type periods the trial lasts.`})}),_jsx(ParamField,{body:`duration_type`,type:`'day' | 'month' | 'year'`,required:true,id:`param-duration-type-10`,children:_jsx(_components.p,{children:`Unit of time for the trial duration (‘day’, ‘month’, ‘year’).`})}),_jsx(ParamField,{body:`card_required`,type:`boolean`,required:true,id:`param-card-required-10`,children:_jsx(_components.p,{children:`Whether a payment method is required to start the trial. If true, customer will be charged after trial ends.`})}),_jsx(ParamField,{body:`on_end`,type:`'bill' | 'revert'`,id:`param-on-end-10`,children:_jsx(_components.p,{children:`Behavior when the trial ends. ‘bill’ charges the customer (default). ‘revert’ expires the trial and restores the customer’s previous plan.`})})]})]}),_jsxs(ParamField,{body:`billing_controls`,type:`object | null`,id:`param-billing-controls-8`,children:[_jsx(_components.p,{children:`Sparse previous billing_controls — only keys that changed. Null when unset; a null lane was unset before.`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`auto_topups`,type:`object[] | null`,id:`param-auto-topups-8`,children:[_jsx(_components.p,{children:`List of auto top-up configurations per feature.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-66`,children:_jsx(_components.p,{children:`The ID of the feature (credit balance) to auto top-up.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-40`,children:_jsx(_components.p,{children:`Whether auto top-up is enabled.`})}),_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-28`,children:_jsx(_components.p,{children:`When the balance drops below this threshold, an auto top-up will be purchased.`})}),_jsx(ParamField,{body:`quantity`,type:`number`,required:true,id:`param-quantity-13`,children:_jsx(_components.p,{children:`Amount of credits to add per auto top-up.`})}),_jsxs(ParamField,{body:`purchase_limit`,type:`object`,id:`param-purchase-limit-8`,children:[_jsx(_components.p,{children:`Optional limit on auto top-ups per window, by number of top-ups or amount charged.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`limit_type`,type:`'count' | 'amount'`,id:`param-limit-type-16`,children:_jsxs(_components.p,{children:[`What `,_jsx(_components.code,{children:`limit`}),` caps: the number of auto top-ups (`,_jsx(_components.code,{children:`count`}),`, default) or the total amount charged for them, in the customer’s currency (`,_jsx(_components.code,{children:`amount`}),`).`]})}),_jsx(ParamField,{body:`interval`,type:`'hour' | 'day' | 'week' | 'month'`,required:true,id:`param-interval-61`,children:_jsx(_components.p,{children:`The time interval for the purchase limit window.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,required:true,id:`param-interval-count-53`,children:_jsx(_components.p,{children:`Number of intervals in the purchase limit window.`})}),_jsx(ParamField,{body:`limit`,type:`number`,required:true,id:`param-limit-16`,children:_jsx(_components.p,{children:`Maximum allowed within the interval: a number of auto top-ups when limit_type is count, or a total charge (e.g. 500 for $500, pre-tax) when limit_type is amount.`})})]})]}),_jsx(ParamField,{body:`invoice_mode`,type:`boolean`,id:`param-invoice-mode-8`,children:_jsx(_components.p,{children:`When true, auto top-up creates a send_invoice invoice instead of auto-charging.`})})]})]}),_jsxs(ParamField,{body:`spend_limits`,type:`object[] | null`,id:`param-spend-limits-8`,children:[_jsx(_components.p,{children:`List of overage spend limits per feature (caps overage spend).`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,id:`param-feature-id-67`,children:_jsx(_components.p,{children:`Optional feature ID this spend limit applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-41`,children:_jsx(_components.p,{children:`Whether the overage spend limit is enabled.`})}),_jsx(ParamField,{body:`limit_type`,type:`'absolute' | 'usage_percentage'`,id:`param-limit-type-17`,children:_jsx(_components.p,{children:`How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.`})}),_jsx(ParamField,{body:`overage_limit`,type:`number`,id:`param-overage-limit-8`,children:_jsx(_components.p,{children:`Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.`})}),_jsx(ParamField,{body:`skip_overage_billing`,type:`boolean`,id:`param-skip-overage-billing-8`,children:_jsx(_components.p,{children:`When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.`})})]})]}),_jsxs(ParamField,{body:`usage_limits`,type:`object[] | null`,id:`param-usage-limits-8`,children:[_jsx(_components.p,{children:`List of hard usage caps per feature (max units per interval).`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-68`,children:_jsx(_components.p,{children:`The feature this usage limit applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-42`,children:_jsx(_components.p,{children:`Whether this usage limit is enabled.`})}),_jsx(ParamField,{body:`limit`,type:`number`,required:true,id:`param-limit-17`,children:_jsx(_components.p,{children:`Maximum units allowed per interval.`})}),_jsx(ParamField,{body:`interval`,type:`'day' | 'week' | 'month' | 'year'`,required:true,id:`param-interval-62`,children:_jsx(_components.p,{children:`Interval for the cap, aligned to the customer’s billing cycle.`})}),_jsx(ParamField,{body:`anchor`,type:`'billing_cycle' | 'utc'`,id:`param-anchor-8`,children:_jsx(_components.p,{children:`Window alignment. ‘billing_cycle’ phases the interval to the customer’s renewal time; ‘utc’ aligns to the UTC calendar.`})}),_jsxs(ParamField,{body:`filter`,type:`object`,id:`param-filter-16`,children:[_jsx(_components.p,{children:`When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`properties.{key}`,type:`string`,required:true,id:`param-properties-key-16`})})]})]})]}),_jsxs(ParamField,{body:`usage_alerts`,type:`object[] | null`,id:`param-usage-alerts-8`,children:[_jsx(_components.p,{children:`List of usage alert configurations per feature.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,id:`param-feature-id-69`,children:_jsx(_components.p,{children:`The feature ID this alert applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-43`,children:_jsx(_components.p,{children:`Whether this usage alert is enabled.`})}),_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-29`,children:_jsx(_components.p,{children:`The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage. remaining and remaining_percentage accept negative values with basis balance, to alert once the balance is overdrawn.`})}),_jsx(ParamField,{body:`threshold_type`,type:`'usage' | 'usage_percentage' | 'remaining' | 'remaining_percentage'`,required:true,id:`param-threshold-type-8`,children:_jsx(_components.p,{children:`Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.`})}),_jsx(ParamField,{body:`basis`,type:`'balance' | 'included' | 'recurring' | 'usage_limit'`,required:true,id:`param-basis-8`,children:_jsx(_components.p,{children:`What 100% means. balance: every grant on the feature. included: the plan allowance only. recurring: grants that reset. usage_limit: the cap of the usage limit with the same feature and filter.`})}),_jsxs(ParamField,{body:`filter`,type:`object`,id:`param-filter-17`,children:[_jsx(_components.p,{children:`Only valid with basis usage_limit. Points the alert at the usage limit carrying the same filter.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`properties.{key}`,type:`string`,required:true,id:`param-properties-key-17`})})]}),_jsx(ParamField,{body:`name`,type:`string`,id:`param-name-17`,children:_jsx(_components.p,{children:`Optional user-defined label to distinguish multiple alerts on the same feature.`})})]})]}),_jsxs(ParamField,{body:`overage_allowed`,type:`object[] | null`,id:`param-overage-allowed-8`,children:[_jsx(_components.p,{children:`List of overage allowed controls per feature. When enabled, usage can exceed balance.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-70`,children:_jsx(_components.p,{children:`The feature ID this overage allowed control applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-44`,children:_jsx(_components.p,{children:`Whether overage is allowed for this feature.`})})]})]})]})]})]})]}),_jsxs(ParamField,{body:`price_change`,type:`object`,id:`param-price-change-1`,children:[_jsx(_components.p,{children:`Present when the plan’s price changed.`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`previous`,type:`object | null | null`,required:true,id:`param-previous-2`,children:[_jsx(_components.p,{children:`Base recurring price for the plan. Null for free plans or usage-only plans.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-78`,children:_jsx(_components.p,{children:`Base price amount for the plan, in major currency units (e.g. dollars).`})}),_jsxs(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-37`,children:[_jsx(_components.p,{children:`Base price amounts in additional currencies. The base ‘amount’ is in the org’s default currency.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-37`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-79`,children:_jsx(_components.p,{children:`Price amount in this currency. Set explicitly per currency, not converted from the base amount.`})})]})]}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-63`,children:_jsx(_components.p,{children:`Billing interval (e.g. ‘month’, ‘year’).`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-54`,children:_jsx(_components.p,{children:`Number of intervals per billing cycle. Defaults to 1.`})}),_jsxs(ParamField,{body:`display`,type:`object`,id:`param-display-13`,children:[_jsx(_components.p,{children:`Display text for showing this price in pricing pages.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`primary_text`,type:`string`,required:true,id:`param-primary-text-9`,children:_jsx(_components.p,{children:`Main display text (e.g. ‘$10’ or ‘100 messages’).`})}),_jsx(ParamField,{body:`secondary_text`,type:`string`,id:`param-secondary-text-9`,children:_jsx(_components.p,{children:`Secondary display text (e.g. ‘per month’ or ‘then $0.5 per 100’).`})})]})]}),_jsxs(ParamField,{body:`processors`,type:`object`,id:`param-processors-14`,children:[_jsx(_components.p,{children:`Payment processors this base price is connected to. Omitted when unset.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`stripe`,type:`object | null`,id:`param-stripe-14`,children:_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`price_id`,type:`string`,required:true,id:`param-price-id-9`,children:_jsx(_components.p,{children:`Stripe price ID. For prepaid with included > 0 this is the V2 price.`})})})})})]})]})]}),_jsxs(ParamField,{body:`current`,type:`object | null`,required:true,id:`param-current-2`,children:[_jsx(_components.p,{children:`The plan’s price after the change.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-80`,children:_jsx(_components.p,{children:`Base price amount for the plan, in major currency units (e.g. dollars).`})}),_jsxs(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-38`,children:[_jsx(_components.p,{children:`Base price amounts in additional currencies. The base ‘amount’ is in the org’s default currency.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-38`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-81`,children:_jsx(_components.p,{children:`Price amount in this currency. Set explicitly per currency, not converted from the base amount.`})})]})]}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-64`,children:_jsx(_components.p,{children:`Billing interval (e.g. ‘month’, ‘year’).`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-55`,children:_jsx(_components.p,{children:`Number of intervals per billing cycle. Defaults to 1.`})}),_jsxs(ParamField,{body:`display`,type:`object`,id:`param-display-14`,children:[_jsx(_components.p,{children:`Display text for showing this price in pricing pages.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`primary_text`,type:`string`,required:true,id:`param-primary-text-10`,children:_jsx(_components.p,{children:`Main display text (e.g. ‘$10’ or ‘100 messages’).`})}),_jsx(ParamField,{body:`secondary_text`,type:`string`,id:`param-secondary-text-10`,children:_jsx(_components.p,{children:`Secondary display text (e.g. ‘per month’ or ‘then $0.5 per 100’).`})})]})]}),_jsxs(ParamField,{body:`processors`,type:`object`,id:`param-processors-15`,children:[_jsx(_components.p,{children:`Payment processors this base price is connected to. Omitted when unset.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`stripe`,type:`object | null`,id:`param-stripe-15`,children:_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`price_id`,type:`string`,required:true,id:`param-price-id-10`,children:_jsx(_components.p,{children:`Stripe price ID. For prepaid with included > 0 this is the V2 price.`})})})})})]})]})]})]})]}),_jsxs(ParamField,{body:`free_trial_change`,type:`object`,id:`param-free-trial-change-1`,children:[_jsx(_components.p,{children:`Present when the plan’s free trial changed.`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`previous`,type:`object | null`,required:true,id:`param-previous-3`,children:[_jsx(_components.p,{children:`The plan’s free trial before the change. Null when none.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`duration_length`,type:`number`,required:true,id:`param-duration-length-11`,children:_jsx(_components.p,{children:`Number of duration_type periods the trial lasts.`})}),_jsx(ParamField,{body:`duration_type`,type:`'day' | 'month' | 'year'`,required:true,id:`param-duration-type-11`,children:_jsx(_components.p,{children:`Unit of time for the trial duration (‘day’, ‘month’, ‘year’).`})}),_jsx(ParamField,{body:`card_required`,type:`boolean`,required:true,id:`param-card-required-11`,children:_jsx(_components.p,{children:`Whether a payment method is required to start the trial. If true, customer will be charged after trial ends.`})}),_jsx(ParamField,{body:`on_end`,type:`'bill' | 'revert'`,id:`param-on-end-11`,children:_jsx(_components.p,{children:`Behavior when the trial ends. ‘bill’ charges the customer (default). ‘revert’ expires the trial and restores the customer’s previous plan.`})})]})]}),_jsxs(ParamField,{body:`current`,type:`object | null`,required:true,id:`param-current-3`,children:[_jsx(_components.p,{children:`The plan’s free trial after the change. Null when none.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`duration_length`,type:`number`,required:true,id:`param-duration-length-12`,children:_jsx(_components.p,{children:`Number of duration_type periods the trial lasts.`})}),_jsx(ParamField,{body:`duration_type`,type:`'day' | 'month' | 'year'`,required:true,id:`param-duration-type-12`,children:_jsx(_components.p,{children:`Unit of time for the trial duration (‘day’, ‘month’, ‘year’).`})}),_jsx(ParamField,{body:`card_required`,type:`boolean`,required:true,id:`param-card-required-12`,children:_jsx(_components.p,{children:`Whether a payment method is required to start the trial. If true, customer will be charged after trial ends.`})}),_jsx(ParamField,{body:`on_end`,type:`'bill' | 'revert'`,id:`param-on-end-12`,children:_jsx(_components.p,{children:`Behavior when the trial ends. ‘bill’ charges the customer (default). ‘revert’ expires the trial and restores the customer’s previous plan.`})})]})]})]})]}),_jsxs(ParamField,{body:`item_changes`,type:`object[]`,required:true,id:`param-item-changes-1`,children:[_jsx(_components.p,{children:`Feature items added to or removed from the plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`action`,type:`'created' | 'deleted'`,required:true,id:`param-action-3`,children:_jsx(_components.p,{children:`Whether the item was added to or removed from the plan.`})}),_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-71`,children:_jsx(_components.p,{children:`The ID of the feature that was added or removed.`})}),_jsxs(ParamField,{body:`item`,type:`object`,required:true,id:`param-item-1`,children:[_jsx(_components.p,{children:`The plan item snapshot that was added or removed.`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`threshold_billing`,type:`object | null`,id:`param-threshold-billing-12`,children:[_jsx(_components.p,{children:`Bills this many feature units when outstanding overage reaches it.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-30`})})]}),_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-72`,children:_jsx(_components.p,{children:`The ID of the feature this item configures.`})}),_jsxs(ParamField,{body:`feature`,type:`object`,id:`param-feature-4`,children:[_jsx(_components.p,{children:`The full feature object if expanded.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`id`,type:`string`,required:true,id:`param-id-9`,children:_jsx(_components.p,{children:`The ID of the feature, used to refer to it in other API calls like /track or /check.`})}),_jsx(ParamField,{body:`name`,type:`string | null`,id:`param-name-18`,children:_jsx(_components.p,{children:`The name of the feature.`})}),_jsx(ParamField,{body:`type`,type:`'static' | 'boolean' | 'single_use' | 'continuous_use' | 'credit_system' | 'ai_credit_system'`,required:true,id:`param-type-4`,children:_jsx(_components.p,{children:`The type of the feature`})}),_jsxs(ParamField,{body:`display`,type:`object | null`,id:`param-display-15`,children:[_jsx(_components.p,{children:`Singular and plural display names for the feature.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`singular`,type:`string`,required:true,id:`param-singular-4`,children:_jsx(_components.p,{children:`The singular display name for the feature.`})}),_jsx(ParamField,{body:`plural`,type:`string`,required:true,id:`param-plural-4`,children:_jsx(_components.p,{children:`The plural display name for the feature.`})})]})]}),_jsxs(ParamField,{body:`credit_schema`,type:`object[] | null`,id:`param-credit-schema-16`,children:[_jsx(_components.p,{children:`Credit cost schema for credit system features.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`metered_feature_id`,type:`string`,required:true,id:`param-metered-feature-id-16`,children:_jsx(_components.p,{children:`The ID of the metered feature (should be a single_use feature).`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-40`,children:_jsx(_components.p,{children:`The credit cost of the metered feature.`})})]})]}),_jsx(ParamField,{body:`archived`,type:`boolean | null`,id:`param-archived-9`,children:_jsx(_components.p,{children:`Whether or not the feature is archived.`})})]})]}),_jsx(ParamField,{body:`included`,type:`number`,required:true,id:`param-included-26`,children:_jsx(_components.p,{children:`Number of free units included. For consumable features, balance resets to this number each interval.`})}),_jsx(ParamField,{body:`unlimited`,type:`boolean`,required:true,id:`param-unlimited-12`,children:_jsx(_components.p,{children:`Whether the customer has unlimited access to this feature.`})}),_jsx(ParamField,{body:`pooled`,type:`boolean`,id:`param-pooled-12`,children:_jsx(_components.p,{children:`Whether entity-level grants contribute to a shared customer balance.`})}),_jsxs(ParamField,{body:`reset`,type:`object | null`,required:true,id:`param-reset-12`,children:[_jsx(_components.p,{children:`Reset configuration for consumable features. Null for non-consumable features like seats where usage persists across billing cycles.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`interval`,type:`'one_off' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-65`,children:_jsx(_components.p,{children:`The interval at which the feature balance resets (e.g. ‘month’, ‘year’). For consumable features, usage resets to 0 and included units are restored.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-56`,children:_jsx(_components.p,{children:`Number of intervals between resets. Defaults to 1.`})})]})]}),_jsxs(ParamField,{body:`price`,type:`object | null`,required:true,id:`param-price-23`,children:[_jsx(_components.p,{children:`Pricing configuration for usage beyond included units. Null if feature is entirely free.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-82`,children:_jsx(_components.p,{children:`Price per billing_units after included usage is consumed. Mutually exclusive with tiers.`})}),_jsxs(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-39`,children:[_jsx(_components.p,{children:`Amounts in additional currencies for this flat price. The base ‘amount’ is in the org’s default currency. Only valid with ‘amount’, not ‘tiers’ (tiered prices carry per-currency amounts on each tier).`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-39`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-83`,children:_jsx(_components.p,{children:`Price amount in this currency. Set explicitly per currency, not converted from the base amount.`})})]})]}),_jsxs(ParamField,{body:`tiers`,type:`object[]`,id:`param-tiers-36`,children:[_jsx(_components.p,{children:`Tiered pricing configuration. Each tier’s ‘to’ INCLUDES the included amount. Either ‘tiers’ or ‘amount’ is required.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-36`}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-84`}),_jsx(ParamField,{body:`flat_amount`,type:`number`,id:`param-flat-amount-24`}),_jsx(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-40`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-40`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-85`,children:_jsx(_components.p,{children:`Per-unit amount for this tier in this currency.`})}),_jsx(ParamField,{body:`flat_amount`,type:`number`,id:`param-flat-amount-25`,children:_jsx(_components.p,{children:`Flat amount for this tier in this currency, if the tier uses one.`})})]})})]})]}),_jsx(ParamField,{body:`tier_behavior`,type:`'graduated' | 'volume'`,id:`param-tier-behavior-36`,children:_jsx(_components.p,{children:`How tiers price usage. ‘graduated’ (default) charges each unit at the rate of the tier it falls in. ‘volume’ picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier’s rate plus its flat_amount.`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-66`,children:_jsx(_components.p,{children:`Billing interval for this price. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-57`,children:_jsx(_components.p,{children:`Number of intervals per billing cycle. Defaults to 1.`})}),_jsx(ParamField,{body:`billing_units`,type:`number`,required:true,id:`param-billing-units-24`,children:_jsx(_components.p,{children:`Number of units per price increment. Usage is rounded UP to the nearest billing_units when billed (e.g. billing_units=100 means 101 usage rounds to 200).`})}),_jsx(ParamField,{body:`billing_method`,type:`'prepaid' | 'usage_based'`,required:true,id:`param-billing-method-20`,children:_jsx(_components.p,{children:`‘prepaid’ for features like seats where customers pay upfront, ‘usage_based’ for pay-as-you-go after included usage.`})}),_jsx(ParamField,{body:`max_purchase`,type:`number | null`,required:true,id:`param-max-purchase-12`,children:_jsx(_components.p,{children:`Maximum units a customer can purchase beyond included. E.g. if included=100 and max_purchase=300, customer can use up to 400 total before usage is capped. Null for no limit.`})}),_jsxs(ParamField,{body:`processors`,type:`object`,id:`param-processors-16`,children:[_jsx(_components.p,{children:`Payment processors this item price is connected to. Omitted when unset.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`stripe`,type:`object | null`,id:`param-stripe-16`,children:_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`price_id`,type:`string`,required:true,id:`param-price-id-11`,children:_jsx(_components.p,{children:`Stripe price ID. For prepaid with included > 0 this is the V2 price.`})})})})})]})]})]}),_jsxs(ParamField,{body:`display`,type:`object`,id:`param-display-16`,children:[_jsx(_components.p,{children:`Display text for showing this item in pricing pages.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`primary_text`,type:`string`,required:true,id:`param-primary-text-11`,children:_jsx(_components.p,{children:`Main display text (e.g. ‘$10’ or ‘100 messages’).`})}),_jsx(ParamField,{body:`secondary_text`,type:`string`,id:`param-secondary-text-11`,children:_jsx(_components.p,{children:`Secondary display text (e.g. ‘per month’ or ‘then $0.5 per 100’).`})})]})]}),_jsxs(ParamField,{body:`rollover`,type:`object`,id:`param-rollover-12`,children:[_jsx(_components.p,{children:`Rollover configuration for unused units. If set, unused included units roll over to the next period.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`max`,type:`number | null`,required:true,id:`param-max-12`,children:_jsx(_components.p,{children:`Maximum rollover units. Null for unlimited rollover.`})}),_jsx(ParamField,{body:`max_percentage`,type:`number | null`,id:`param-max-percentage-12`,children:_jsx(_components.p,{children:`Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.`})}),_jsx(ParamField,{body:`expiry_duration_type`,type:`'month' | 'forever'`,required:true,id:`param-expiry-duration-type-12`,children:_jsx(_components.p,{children:`When rolled over units expire.`})}),_jsx(ParamField,{body:`expiry_duration_length`,type:`number`,id:`param-expiry-duration-length-12`,children:_jsx(_components.p,{children:`Number of periods before expiry.`})})]})]}),_jsxs(ParamField,{body:`expiry`,type:`object | null`,id:`param-expiry-12`,children:[_jsx(_components.p,{children:`Purchased units expire this long after each purchase. One-off prepaid consumable items only.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`duration`,type:`'day' | 'week' | 'month' | 'year'`,required:true,id:`param-duration-12`}),_jsx(ParamField,{body:`length`,type:`number`,required:true,id:`param-length-12`})]})]}),_jsxs(ParamField,{body:`feature_override`,type:`object`,id:`param-feature-override-12`,children:[_jsx(_components.p,{children:`Overrides fields of this item’s feature for customers on this plan (e.g. a credit system’s credit_schema).`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`credit_schema`,type:`object | object | object[]`,id:`param-credit-schema-17`,children:[_jsxs(_components.p,{children:[`For credit system features: merges into the feature’s credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `,_jsx(_components.code,{children:`excluded: true`}),` removes it, and unlisted features keep the credit system’s rate.`]}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`metered_feature_id`,type:`string`,id:`param-metered-feature-id-17`,children:_jsx(_components.p,{children:`ID of the metered feature that draws from this credit system.`})}),_jsx(ParamField,{body:`billing_units`,type:`number`,id:`param-billing-units-25`,children:_jsx(_components.p,{children:`Number of metered-feature units priced together. Defaults to one when omitted.`})}),_jsxs(ParamField,{body:`dimensions.{key}`,type:`object`,id:`param-dimensions-key-12`,children:[_jsx(_components.p,{children:`Named rates chosen by event properties. The most specific match sets the rate; with no match the item’s own rate applies.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`match.{key}`,type:`string`,required:true,id:`param-match-key-24`,children:_jsx(_components.p,{children:`Event properties this entry applies to. Every key must equal the tracked property, compared as strings.`})}),_jsx(ParamField,{body:`priority`,type:`integer`,id:`param-priority-12`,children:_jsx(_components.p,{children:`Breaks ties between dimensions that match the same number of keys. Higher wins.`})}),_jsx(ParamField,{body:`tier_behavior`,type:`string`,required:true,id:`param-tier-behavior-37`}),_jsx(ParamField,{body:`tiers`,type:`object[]`,required:true,id:`param-tiers-37`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-37`,children:_jsx(_components.p,{children:`Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-41`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group within this tier.`})})]})})]})]}),_jsxs(ParamField,{body:`multipliers.{key}`,type:`object`,id:`param-multipliers-key-12`,children:[_jsx(_components.p,{children:`Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`match.{key}`,type:`string`,required:true,id:`param-match-key-25`,children:_jsx(_components.p,{children:`Event properties this entry applies to. Every key must equal the tracked property, compared as strings.`})}),_jsx(ParamField,{body:`factor`,type:`number`,id:`param-factor-12`,children:_jsx(_components.p,{children:`Multiplies the matched rate. All matching multipliers stack.`})}),_jsx(ParamField,{body:`add`,type:`number`,id:`param-add-12`,children:_jsx(_components.p,{children:`Added to the rate after every factor is applied, in credits per billing-unit group.`})})]})]}),_jsx(ParamField,{body:`tier_behavior`,type:`string`,id:`param-tier-behavior-38`}),_jsx(ParamField,{body:`tiers`,type:`object[]`,id:`param-tiers-38`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-38`,children:_jsx(_components.p,{children:`Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-42`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group within this tier.`})})]})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,id:`param-credit-cost-43`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group.`})}),_jsx(ParamField,{body:`excluded`,type:`true`,id:`param-excluded-12`,children:_jsx(_components.p,{children:`Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.`})})]})]}),_jsxs(ParamField,{body:`markups`,type:`object`,id:`param-markups-12`,children:[_jsx(_components.p,{children:`For AI credit system features: replaces the feature’s markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature’s.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`default_markup`,type:`number`,id:`param-default-markup-12`,children:_jsx(_components.p,{children:`Default percentage markup for customers on this plan. Use -100 to make usage free.`})}),_jsxs(ParamField,{body:`provider_markups.{key}`,type:`object | null`,id:`param-provider-markups-key-12`,children:[_jsx(_components.p,{children:`Per-provider markup percentages for customers on this plan.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`markup`,type:`number`,required:true,id:`param-markup-24`})})]}),_jsxs(ParamField,{body:`model_markups.{key}`,type:`object | null`,id:`param-model-markups-key-12`,children:[_jsx(_components.p,{children:`Per-model markup overrides for customers on this plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`markup`,type:`number`,id:`param-markup-25`}),_jsx(ParamField,{body:`input_cost`,type:`number`,id:`param-input-cost-12`}),_jsx(ParamField,{body:`output_cost`,type:`number`,id:`param-output-cost-12`})]})]})]})]})]})]})]})]})]})]}),_jsxs(ParamField,{body:`customize`,type:`object`,id:`param-customize-8`,children:[_jsx(_components.p,{children:`Params that would transform the previous plan into the current one. Omitted when nothing customizable changed.`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`price`,type:`object | null`,id:`param-price-24`,children:[_jsx(_components.p,{children:`Base price configuration for a plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-86`,children:_jsx(_components.p,{children:`Base price amount for the plan, in major currency units (e.g. dollars).`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-67`,children:_jsx(_components.p,{children:`Billing interval (e.g. ‘month’, ‘year’).`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-58`}),_jsxs(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-41`,children:[_jsx(_components.p,{children:`Base price amounts in additional currencies. The base ‘amount’ is in the org’s default currency.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-41`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-87`,children:_jsx(_components.p,{children:`Price amount in this currency. Set explicitly per currency, not converted from the base amount.`})})]})]})]})]}),_jsxs(ParamField,{body:`add_items`,type:`object[]`,id:`param-add-items-8`,children:[_jsx(_components.p,{children:`Items to add to the plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`threshold_billing`,type:`object | null`,id:`param-threshold-billing-13`,children:[_jsx(_components.p,{children:`Bills this many feature units when outstanding overage reaches it.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-31`})})]}),_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-73`,children:_jsx(_components.p,{children:`The ID of the feature to configure.`})}),_jsx(ParamField,{body:`included`,type:`number`,id:`param-included-27`,children:_jsx(_components.p,{children:`Number of free units included. Balance resets to this each interval for consumable features.`})}),_jsx(ParamField,{body:`unlimited`,type:`boolean`,id:`param-unlimited-13`,children:_jsx(_components.p,{children:`If true, customer has unlimited access to this feature.`})}),_jsx(ParamField,{body:`pooled`,type:`boolean`,id:`param-pooled-13`,children:_jsx(_components.p,{children:`Whether entity-level grants contribute to a shared customer balance.`})}),_jsxs(ParamField,{body:`reset`,type:`object`,id:`param-reset-13`,children:[_jsx(_components.p,{children:`Reset configuration for consumable features. Omit for non-consumable features like seats.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`interval`,type:`'one_off' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-68`,children:_jsx(_components.p,{children:`Interval at which balance resets (e.g. ‘month’, ‘year’). For consumable features only.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-59`})]})]}),_jsxs(ParamField,{body:`price`,type:`object`,id:`param-price-25`,children:[_jsx(_components.p,{children:`Pricing for usage beyond included units. Omit for free features.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-88`,children:_jsx(_components.p,{children:`Price per billing_units after included usage. Either ‘amount’ or ‘tiers’ is required.`})}),_jsxs(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-42`,children:[_jsx(_components.p,{children:`Amounts in additional currencies for this flat price. The base ‘amount’ is in the org’s default currency. Only valid with ‘amount’, not ‘tiers’.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-42`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-89`,children:_jsx(_components.p,{children:`Price amount in this currency. Set explicitly per currency, not converted from the base amount.`})})]})]}),_jsxs(ParamField,{body:`tiers`,type:`object[]`,id:`param-tiers-39`,children:[_jsx(_components.p,{children:`Tiered pricing. Either ‘amount’ or ‘tiers’ is required.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-39`}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-90`}),_jsx(ParamField,{body:`flat_amount`,type:`number`,id:`param-flat-amount-26`}),_jsx(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-43`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-43`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-91`,children:_jsx(_components.p,{children:`Per-unit amount for this tier in this currency.`})}),_jsx(ParamField,{body:`flat_amount`,type:`number`,id:`param-flat-amount-27`,children:_jsx(_components.p,{children:`Flat amount for this tier in this currency, if the tier uses one.`})})]})})]})]}),_jsx(ParamField,{body:`tier_behavior`,type:`'graduated' | 'volume'`,id:`param-tier-behavior-39`,children:_jsx(_components.p,{children:`How tiers price usage. ‘graduated’ (default) charges each unit at the rate of the tier it falls in. ‘volume’ picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier’s rate plus its flat_amount.`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-69`,children:_jsx(_components.p,{children:`Billing interval. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-60`,children:_jsx(_components.p,{children:`Number of intervals per billing cycle. Defaults to 1.`})}),_jsx(ParamField,{body:`billing_units`,type:`number`,id:`param-billing-units-26`,children:_jsx(_components.p,{children:`Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).`})}),_jsx(ParamField,{body:`billing_method`,type:`'prepaid' | 'usage_based'`,required:true,id:`param-billing-method-21`,children:_jsx(_components.p,{children:`‘prepaid’ for upfront payment (seats), ‘usage_based’ for pay-as-you-go.`})}),_jsx(ParamField,{body:`max_purchase`,type:`number | null`,id:`param-max-purchase-13`,children:_jsx(_components.p,{children:`Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.`})})]})]}),_jsxs(ParamField,{body:`proration`,type:`object`,id:`param-proration-8`,children:[_jsx(_components.p,{children:`Proration settings for prepaid features. Controls mid-cycle quantity change billing.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`on_increase`,type:`'bill_immediately' | 'prorate_immediately' | 'prorate_next_cycle' | 'bill_next_cycle'`,required:true,id:`param-on-increase-8`,children:_jsx(_components.p,{children:`Billing behavior when quantity increases mid-cycle.`})}),_jsx(ParamField,{body:`on_decrease`,type:`'prorate' | 'prorate_immediately' | 'prorate_next_cycle' | 'none' | 'no_prorations'`,required:true,id:`param-on-decrease-8`,children:_jsx(_components.p,{children:`Credit behavior when quantity decreases mid-cycle.`})})]})]}),_jsxs(ParamField,{body:`rollover`,type:`object`,id:`param-rollover-13`,children:[_jsx(_components.p,{children:`Rollover config for unused units. If set, unused included units carry over.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`max`,type:`number`,id:`param-max-13`,children:_jsx(_components.p,{children:`Max rollover units. Omit for unlimited rollover.`})}),_jsx(ParamField,{body:`max_percentage`,type:`number`,id:`param-max-percentage-13`,children:_jsx(_components.p,{children:`Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.`})}),_jsx(ParamField,{body:`expiry_duration_type`,type:`'month' | 'forever'`,required:true,id:`param-expiry-duration-type-13`,children:_jsx(_components.p,{children:`When rolled over units expire.`})}),_jsx(ParamField,{body:`expiry_duration_length`,type:`number`,id:`param-expiry-duration-length-13`,children:_jsx(_components.p,{children:`Number of periods before expiry.`})})]})]}),_jsxs(ParamField,{body:`expiry`,type:`object`,id:`param-expiry-13`,children:[_jsx(_components.p,{children:`Purchased units expire this long after each purchase. One-off prepaid consumable items only.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`duration`,type:`'day' | 'week' | 'month' | 'year'`,required:true,id:`param-duration-13`}),_jsx(ParamField,{body:`length`,type:`number`,required:true,id:`param-length-13`})]})]}),_jsxs(ParamField,{body:`feature_override`,type:`object`,id:`param-feature-override-13`,children:[_jsx(_components.p,{children:`Overrides fields of this item’s feature for customers on this plan (e.g. a credit system’s credit_schema).`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`credit_schema`,type:`object | object | object[]`,id:`param-credit-schema-18`,children:[_jsxs(_components.p,{children:[`For credit system features: merges into the feature’s credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `,_jsx(_components.code,{children:`excluded: true`}),` removes it, and unlisted features keep the credit system’s rate.`]}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`metered_feature_id`,type:`string`,id:`param-metered-feature-id-18`,children:_jsx(_components.p,{children:`ID of the metered feature that draws from this credit system.`})}),_jsx(ParamField,{body:`billing_units`,type:`number`,id:`param-billing-units-27`,children:_jsx(_components.p,{children:`Number of metered-feature units priced together. Defaults to one when omitted.`})}),_jsxs(ParamField,{body:`dimensions.{key}`,type:`object`,id:`param-dimensions-key-13`,children:[_jsx(_components.p,{children:`Named rates chosen by event properties. The most specific match sets the rate; with no match the item’s own rate applies.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`match.{key}`,type:`string`,required:true,id:`param-match-key-26`,children:_jsx(_components.p,{children:`Event properties this entry applies to. Every key must equal the tracked property, compared as strings.`})}),_jsx(ParamField,{body:`priority`,type:`integer`,id:`param-priority-13`,children:_jsx(_components.p,{children:`Breaks ties between dimensions that match the same number of keys. Higher wins.`})}),_jsx(ParamField,{body:`tier_behavior`,type:`string`,required:true,id:`param-tier-behavior-40`}),_jsx(ParamField,{body:`tiers`,type:`object[]`,required:true,id:`param-tiers-40`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-40`,children:_jsx(_components.p,{children:`Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-44`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group within this tier.`})})]})})]})]}),_jsxs(ParamField,{body:`multipliers.{key}`,type:`object`,id:`param-multipliers-key-13`,children:[_jsx(_components.p,{children:`Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`match.{key}`,type:`string`,required:true,id:`param-match-key-27`,children:_jsx(_components.p,{children:`Event properties this entry applies to. Every key must equal the tracked property, compared as strings.`})}),_jsx(ParamField,{body:`factor`,type:`number`,id:`param-factor-13`,children:_jsx(_components.p,{children:`Multiplies the matched rate. All matching multipliers stack.`})}),_jsx(ParamField,{body:`add`,type:`number`,id:`param-add-13`,children:_jsx(_components.p,{children:`Added to the rate after every factor is applied, in credits per billing-unit group.`})})]})]}),_jsx(ParamField,{body:`tier_behavior`,type:`string`,id:`param-tier-behavior-41`}),_jsx(ParamField,{body:`tiers`,type:`object[]`,id:`param-tiers-41`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-41`,children:_jsx(_components.p,{children:`Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-45`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group within this tier.`})})]})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,id:`param-credit-cost-46`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group.`})}),_jsx(ParamField,{body:`excluded`,type:`true`,id:`param-excluded-13`,children:_jsx(_components.p,{children:`Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.`})})]})]}),_jsxs(ParamField,{body:`markups`,type:`object`,id:`param-markups-13`,children:[_jsx(_components.p,{children:`For AI credit system features: replaces the feature’s markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature’s.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`default_markup`,type:`number`,id:`param-default-markup-13`,children:_jsx(_components.p,{children:`Default percentage markup for customers on this plan. Use -100 to make usage free.`})}),_jsxs(ParamField,{body:`provider_markups.{key}`,type:`object | null`,id:`param-provider-markups-key-13`,children:[_jsx(_components.p,{children:`Per-provider markup percentages for customers on this plan.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`markup`,type:`number`,required:true,id:`param-markup-26`})})]}),_jsxs(ParamField,{body:`model_markups.{key}`,type:`object | null`,id:`param-model-markups-key-13`,children:[_jsx(_components.p,{children:`Per-model markup overrides for customers on this plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`markup`,type:`number`,id:`param-markup-27`}),_jsx(ParamField,{body:`input_cost`,type:`number`,id:`param-input-cost-13`}),_jsx(ParamField,{body:`output_cost`,type:`number`,id:`param-output-cost-13`})]})]})]})]})]})]})]})]}),_jsxs(ParamField,{body:`remove_items`,type:`object[]`,id:`param-remove-items-8`,children:[_jsx(_components.p,{children:`Filters selecting items to remove from the plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,id:`param-feature-id-74`,children:_jsx(_components.p,{children:`Match items linked to this feature.`})}),_jsx(ParamField,{body:`billing_method`,type:`'prepaid' | 'usage_based'`,id:`param-billing-method-22`,children:_jsx(_components.p,{children:`Match items with this billing method (prepaid or usage_based).`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,id:`param-interval-70`,children:_jsx(_components.p,{children:`Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.`})}),_jsx(ParamField,{body:`interval_count`,type:`integer`,id:`param-interval-count-61`,children:_jsx(_components.p,{children:`Match items with this interval_count. Disambiguates between items that share an interval but differ in count.`})}),_jsx(ParamField,{body:`included`,type:`number`,id:`param-included-28`,children:_jsx(_components.p,{children:`Match items whose grant equals this included usage. Omitted is a wildcard.`})})]})]}),_jsxs(ParamField,{body:`free_trial`,type:`object | null`,id:`param-free-trial-9`,children:[_jsx(_components.p,{children:`Free trial configuration for a plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`duration_length`,type:`number`,required:true,id:`param-duration-length-13`,children:_jsx(_components.p,{children:`Number of duration_type periods the trial lasts.`})}),_jsx(ParamField,{body:`duration_type`,type:`'day' | 'month' | 'year'`,required:true,id:`param-duration-type-13`,children:_jsx(_components.p,{children:`Unit of time for the trial (‘day’, ‘month’, ‘year’).`})}),_jsx(ParamField,{body:`card_required`,type:`boolean`,required:true,id:`param-card-required-13`,children:_jsx(_components.p,{children:`If true, a payment method is required to start the trial and the customer is charged when it ends. Defaults to false.`})}),_jsx(ParamField,{body:`on_end`,type:`'bill' | 'revert'`,id:`param-on-end-13`})]})]}),_jsxs(ParamField,{body:`billing_controls`,type:`object`,id:`param-billing-controls-9`,children:[_jsx(_components.p,{children:`Override the plan’s billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`auto_topups`,type:`object[]`,id:`param-auto-topups-9`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-75`,children:_jsx(_components.p,{children:`The ID of the feature (credit balance) to auto top-up.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-45`,children:_jsx(_components.p,{children:`Whether auto top-up is enabled.`})}),_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-32`,children:_jsx(_components.p,{children:`When the balance drops below this threshold, an auto top-up will be purchased.`})}),_jsx(ParamField,{body:`quantity`,type:`number`,required:true,id:`param-quantity-14`,children:_jsx(_components.p,{children:`Amount of credits to add per auto top-up.`})}),_jsxs(ParamField,{body:`purchase_limit`,type:`object`,id:`param-purchase-limit-9`,children:[_jsx(_components.p,{children:`Optional rate limit to cap how often auto top-ups occur. Pass count or amount to set the current window’s consumed top-ups or charged amount.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`limit_type`,type:`'count' | 'amount'`,id:`param-limit-type-18`,children:_jsxs(_components.p,{children:[`What `,_jsx(_components.code,{children:`limit`}),` caps: the number of auto top-ups (`,_jsx(_components.code,{children:`count`}),`, default) or the total amount charged for them, in the customer’s currency (`,_jsx(_components.code,{children:`amount`}),`).`]})}),_jsx(ParamField,{body:`interval`,type:`'hour' | 'day' | 'week' | 'month'`,required:true,id:`param-interval-71`,children:_jsx(_components.p,{children:`The time interval for the purchase limit window.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,required:true,id:`param-interval-count-62`,children:_jsx(_components.p,{children:`Number of intervals in the purchase limit window.`})}),_jsx(ParamField,{body:`limit`,type:`number`,required:true,id:`param-limit-18`,children:_jsx(_components.p,{children:`Maximum allowed within the interval: a number of auto top-ups when limit_type is count, or a total charge (e.g. 500 for $500, pre-tax) when limit_type is amount.`})}),_jsx(ParamField,{body:`count`,type:`number`,id:`param-count-4`,children:_jsx(_components.p,{children:`Set the current window’s consumed auto top-up count. Omit to leave runtime state unchanged.`})}),_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-92`,children:_jsx(_components.p,{children:`Set the amount already charged by auto top-ups in the current window. Omit to leave runtime state unchanged.`})})]})]}),_jsx(ParamField,{body:`invoice_mode`,type:`boolean`,id:`param-invoice-mode-9`,children:_jsx(_components.p,{children:`When true, auto top-up creates a send_invoice invoice instead of auto-charging.`})})]})}),_jsx(ParamField,{body:`spend_limits`,type:`object[]`,id:`param-spend-limits-9`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,id:`param-feature-id-76`,children:_jsx(_components.p,{children:`Optional feature ID this spend limit applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-46`,children:_jsx(_components.p,{children:`Whether the overage spend limit is enabled.`})}),_jsx(ParamField,{body:`limit_type`,type:`'absolute' | 'usage_percentage'`,id:`param-limit-type-19`,children:_jsx(_components.p,{children:`How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.`})}),_jsx(ParamField,{body:`overage_limit`,type:`number`,id:`param-overage-limit-9`,children:_jsx(_components.p,{children:`Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.`})}),_jsx(ParamField,{body:`skip_overage_billing`,type:`boolean`,id:`param-skip-overage-billing-9`,children:_jsx(_components.p,{children:`When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.`})})]})}),_jsx(ParamField,{body:`usage_limits`,type:`object[]`,id:`param-usage-limits-9`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-77`,children:_jsx(_components.p,{children:`The feature this usage limit applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-47`,children:_jsx(_components.p,{children:`Whether this usage limit is enabled.`})}),_jsx(ParamField,{body:`limit`,type:`number`,required:true,id:`param-limit-19`,children:_jsx(_components.p,{children:`Maximum units allowed per interval.`})}),_jsx(ParamField,{body:`interval`,type:`'day' | 'week' | 'month' | 'year'`,required:true,id:`param-interval-72`,children:_jsx(_components.p,{children:`Interval for the cap, aligned to the customer’s billing cycle.`})}),_jsx(ParamField,{body:`anchor`,type:`'billing_cycle' | 'utc'`,id:`param-anchor-9`,children:_jsx(_components.p,{children:`Window alignment. ‘billing_cycle’ phases the interval to the customer’s renewal time; ‘utc’ aligns to the UTC calendar.`})}),_jsxs(ParamField,{body:`filter`,type:`object`,id:`param-filter-18`,children:[_jsx(_components.p,{children:`When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`properties.{key}`,type:`string`,required:true,id:`param-properties-key-18`})})]})]})}),_jsx(ParamField,{body:`usage_alerts`,type:`object[]`,id:`param-usage-alerts-9`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,id:`param-feature-id-78`,children:_jsx(_components.p,{children:`The feature ID this alert applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-48`,children:_jsx(_components.p,{children:`Whether this usage alert is enabled.`})}),_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-33`,children:_jsx(_components.p,{children:`The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage. remaining and remaining_percentage accept negative values with basis balance, to alert once the balance is overdrawn.`})}),_jsx(ParamField,{body:`threshold_type`,type:`'usage' | 'usage_percentage' | 'remaining' | 'remaining_percentage'`,required:true,id:`param-threshold-type-9`,children:_jsx(_components.p,{children:`Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.`})}),_jsx(ParamField,{body:`basis`,type:`'balance' | 'included' | 'recurring' | 'usage_limit'`,required:true,id:`param-basis-9`,children:_jsx(_components.p,{children:`What 100% means. balance: every grant on the feature. included: the plan allowance only. recurring: grants that reset. usage_limit: the cap of the usage limit with the same feature and filter.`})}),_jsxs(ParamField,{body:`filter`,type:`object`,id:`param-filter-19`,children:[_jsx(_components.p,{children:`Only valid with basis usage_limit. Points the alert at the usage limit carrying the same filter.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`properties.{key}`,type:`string`,required:true,id:`param-properties-key-19`})})]}),_jsx(ParamField,{body:`name`,type:`string`,id:`param-name-19`,children:_jsx(_components.p,{children:`Optional user-defined label to distinguish multiple alerts on the same feature.`})})]})}),_jsx(ParamField,{body:`overage_allowed`,type:`object[]`,id:`param-overage-allowed-9`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-79`,children:_jsx(_components.p,{children:`The feature ID this overage allowed control applies to.`})}),_jsx(ParamField,{body:`enabled`,type:`boolean`,required:true,id:`param-enabled-49`,children:_jsx(_components.p,{children:`Whether overage is allowed for this feature.`})})]})})]})]}),_jsxs(ParamField,{body:`upsert_licenses`,type:`object[]`,id:`param-upsert-licenses-4`,children:[_jsx(_components.p,{children:`License links to add or override for this customer, keyed by license_plan_id. Omitted fields inherit the plan catalog link (included defaults to 1 when the license is not in the catalog). A bare entry restores the license to pure catalog inheritance.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`license_plan_id`,type:`string`,required:true,id:`param-license-plan-id-9`}),_jsx(ParamField,{body:`version_slug`,type:`string`,id:`param-version-slug-9`}),_jsx(ParamField,{body:`included`,type:`integer`,id:`param-included-29`}),_jsx(ParamField,{body:`prepaid_only`,type:`boolean`,id:`param-prepaid-only-4`}),_jsx(ParamField,{body:`customize`,type:`object | null`,id:`param-customize-9`,children:_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`price`,type:`object | null`,id:`param-price-26`,children:[_jsx(_components.p,{children:`Base price configuration for a plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-93`,children:_jsx(_components.p,{children:`Base price amount for the plan, in major currency units (e.g. dollars).`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-73`,children:_jsx(_components.p,{children:`Billing interval (e.g. ‘month’, ‘year’).`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-63`}),_jsxs(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-44`,children:[_jsx(_components.p,{children:`Base price amounts in additional currencies. The base ‘amount’ is in the org’s default currency.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-44`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-94`,children:_jsx(_components.p,{children:`Price amount in this currency. Set explicitly per currency, not converted from the base amount.`})})]})]})]})]}),_jsx(ParamField,{body:`add_items`,type:`object[]`,id:`param-add-items-9`,children:_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`threshold_billing`,type:`object | null`,id:`param-threshold-billing-14`,children:[_jsx(_components.p,{children:`Bills this many feature units when outstanding overage reaches it.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-34`})})]}),_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-80`,children:_jsx(_components.p,{children:`The ID of the feature to configure.`})}),_jsx(ParamField,{body:`included`,type:`number`,id:`param-included-30`,children:_jsx(_components.p,{children:`Number of free units included. Balance resets to this each interval for consumable features.`})}),_jsx(ParamField,{body:`unlimited`,type:`boolean`,id:`param-unlimited-14`,children:_jsx(_components.p,{children:`If true, customer has unlimited access to this feature.`})}),_jsx(ParamField,{body:`pooled`,type:`boolean`,id:`param-pooled-14`,children:_jsx(_components.p,{children:`Whether entity-level grants contribute to a shared customer balance.`})}),_jsxs(ParamField,{body:`reset`,type:`object`,id:`param-reset-14`,children:[_jsx(_components.p,{children:`Reset configuration for consumable features. Omit for non-consumable features like seats.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`interval`,type:`'one_off' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-74`,children:_jsx(_components.p,{children:`Interval at which balance resets (e.g. ‘month’, ‘year’). For consumable features only.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-64`})]})]}),_jsxs(ParamField,{body:`price`,type:`object`,id:`param-price-27`,children:[_jsx(_components.p,{children:`Pricing for usage beyond included units. Omit for free features.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-95`,children:_jsx(_components.p,{children:`Price per billing_units after included usage. Either ‘amount’ or ‘tiers’ is required.`})}),_jsxs(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-45`,children:[_jsx(_components.p,{children:`Amounts in additional currencies for this flat price. The base ‘amount’ is in the org’s default currency. Only valid with ‘amount’, not ‘tiers’.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-45`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-96`,children:_jsx(_components.p,{children:`Price amount in this currency. Set explicitly per currency, not converted from the base amount.`})})]})]}),_jsxs(ParamField,{body:`tiers`,type:`object[]`,id:`param-tiers-42`,children:[_jsx(_components.p,{children:`Tiered pricing. Either ‘amount’ or ‘tiers’ is required.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-42`}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-97`}),_jsx(ParamField,{body:`flat_amount`,type:`number`,id:`param-flat-amount-28`}),_jsx(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-46`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-46`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-98`,children:_jsx(_components.p,{children:`Per-unit amount for this tier in this currency.`})}),_jsx(ParamField,{body:`flat_amount`,type:`number`,id:`param-flat-amount-29`,children:_jsx(_components.p,{children:`Flat amount for this tier in this currency, if the tier uses one.`})})]})})]})]}),_jsx(ParamField,{body:`tier_behavior`,type:`'graduated' | 'volume'`,id:`param-tier-behavior-42`,children:_jsx(_components.p,{children:`How tiers price usage. ‘graduated’ (default) charges each unit at the rate of the tier it falls in. ‘volume’ picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier’s rate plus its flat_amount.`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-75`,children:_jsx(_components.p,{children:`Billing interval. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-65`,children:_jsx(_components.p,{children:`Number of intervals per billing cycle. Defaults to 1.`})}),_jsx(ParamField,{body:`billing_units`,type:`number`,id:`param-billing-units-28`,children:_jsx(_components.p,{children:`Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).`})}),_jsx(ParamField,{body:`billing_method`,type:`'prepaid' | 'usage_based'`,required:true,id:`param-billing-method-23`,children:_jsx(_components.p,{children:`‘prepaid’ for upfront payment (seats), ‘usage_based’ for pay-as-you-go.`})}),_jsx(ParamField,{body:`max_purchase`,type:`number | null`,id:`param-max-purchase-14`,children:_jsx(_components.p,{children:`Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.`})})]})]}),_jsxs(ParamField,{body:`proration`,type:`object`,id:`param-proration-9`,children:[_jsx(_components.p,{children:`Proration settings for prepaid features. Controls mid-cycle quantity change billing.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`on_increase`,type:`'bill_immediately' | 'prorate_immediately' | 'prorate_next_cycle' | 'bill_next_cycle'`,required:true,id:`param-on-increase-9`,children:_jsx(_components.p,{children:`Billing behavior when quantity increases mid-cycle.`})}),_jsx(ParamField,{body:`on_decrease`,type:`'prorate' | 'prorate_immediately' | 'prorate_next_cycle' | 'none' | 'no_prorations'`,required:true,id:`param-on-decrease-9`,children:_jsx(_components.p,{children:`Credit behavior when quantity decreases mid-cycle.`})})]})]}),_jsxs(ParamField,{body:`rollover`,type:`object`,id:`param-rollover-14`,children:[_jsx(_components.p,{children:`Rollover config for unused units. If set, unused included units carry over.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`max`,type:`number`,id:`param-max-14`,children:_jsx(_components.p,{children:`Max rollover units. Omit for unlimited rollover.`})}),_jsx(ParamField,{body:`max_percentage`,type:`number`,id:`param-max-percentage-14`,children:_jsx(_components.p,{children:`Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.`})}),_jsx(ParamField,{body:`expiry_duration_type`,type:`'month' | 'forever'`,required:true,id:`param-expiry-duration-type-14`,children:_jsx(_components.p,{children:`When rolled over units expire.`})}),_jsx(ParamField,{body:`expiry_duration_length`,type:`number`,id:`param-expiry-duration-length-14`,children:_jsx(_components.p,{children:`Number of periods before expiry.`})})]})]}),_jsxs(ParamField,{body:`expiry`,type:`object`,id:`param-expiry-14`,children:[_jsx(_components.p,{children:`Purchased units expire this long after each purchase. One-off prepaid consumable items only.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`duration`,type:`'day' | 'week' | 'month' | 'year'`,required:true,id:`param-duration-14`}),_jsx(ParamField,{body:`length`,type:`number`,required:true,id:`param-length-14`})]})]}),_jsxs(ParamField,{body:`feature_override`,type:`object`,id:`param-feature-override-14`,children:[_jsx(_components.p,{children:`Overrides fields of this item’s feature for customers on this plan (e.g. a credit system’s credit_schema).`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`credit_schema`,type:`object | object | object[]`,id:`param-credit-schema-19`,children:[_jsxs(_components.p,{children:[`For credit system features: merges into the feature’s credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `,_jsx(_components.code,{children:`excluded: true`}),` removes it, and unlisted features keep the credit system’s rate.`]}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`metered_feature_id`,type:`string`,id:`param-metered-feature-id-19`,children:_jsx(_components.p,{children:`ID of the metered feature that draws from this credit system.`})}),_jsx(ParamField,{body:`billing_units`,type:`number`,id:`param-billing-units-29`,children:_jsx(_components.p,{children:`Number of metered-feature units priced together. Defaults to one when omitted.`})}),_jsxs(ParamField,{body:`dimensions.{key}`,type:`object`,id:`param-dimensions-key-14`,children:[_jsx(_components.p,{children:`Named rates chosen by event properties. The most specific match sets the rate; with no match the item’s own rate applies.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`match.{key}`,type:`string`,required:true,id:`param-match-key-28`,children:_jsx(_components.p,{children:`Event properties this entry applies to. Every key must equal the tracked property, compared as strings.`})}),_jsx(ParamField,{body:`priority`,type:`integer`,id:`param-priority-14`,children:_jsx(_components.p,{children:`Breaks ties between dimensions that match the same number of keys. Higher wins.`})}),_jsx(ParamField,{body:`tier_behavior`,type:`string`,required:true,id:`param-tier-behavior-43`}),_jsx(ParamField,{body:`tiers`,type:`object[]`,required:true,id:`param-tiers-43`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-43`,children:_jsx(_components.p,{children:`Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-47`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group within this tier.`})})]})})]})]}),_jsxs(ParamField,{body:`multipliers.{key}`,type:`object`,id:`param-multipliers-key-14`,children:[_jsx(_components.p,{children:`Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`match.{key}`,type:`string`,required:true,id:`param-match-key-29`,children:_jsx(_components.p,{children:`Event properties this entry applies to. Every key must equal the tracked property, compared as strings.`})}),_jsx(ParamField,{body:`factor`,type:`number`,id:`param-factor-14`,children:_jsx(_components.p,{children:`Multiplies the matched rate. All matching multipliers stack.`})}),_jsx(ParamField,{body:`add`,type:`number`,id:`param-add-14`,children:_jsx(_components.p,{children:`Added to the rate after every factor is applied, in credits per billing-unit group.`})})]})]}),_jsx(ParamField,{body:`tier_behavior`,type:`string`,id:`param-tier-behavior-44`}),_jsx(ParamField,{body:`tiers`,type:`object[]`,id:`param-tiers-44`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-44`,children:_jsx(_components.p,{children:`Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-48`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group within this tier.`})})]})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,id:`param-credit-cost-49`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group.`})}),_jsx(ParamField,{body:`excluded`,type:`true`,id:`param-excluded-14`,children:_jsx(_components.p,{children:`Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.`})})]})]}),_jsxs(ParamField,{body:`markups`,type:`object`,id:`param-markups-14`,children:[_jsx(_components.p,{children:`For AI credit system features: replaces the feature’s markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature’s.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`default_markup`,type:`number`,id:`param-default-markup-14`,children:_jsx(_components.p,{children:`Default percentage markup for customers on this plan. Use -100 to make usage free.`})}),_jsxs(ParamField,{body:`provider_markups.{key}`,type:`object | null`,id:`param-provider-markups-key-14`,children:[_jsx(_components.p,{children:`Per-provider markup percentages for customers on this plan.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`markup`,type:`number`,required:true,id:`param-markup-28`})})]}),_jsxs(ParamField,{body:`model_markups.{key}`,type:`object | null`,id:`param-model-markups-key-14`,children:[_jsx(_components.p,{children:`Per-model markup overrides for customers on this plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`markup`,type:`number`,id:`param-markup-29`}),_jsx(ParamField,{body:`input_cost`,type:`number`,id:`param-input-cost-14`}),_jsx(ParamField,{body:`output_cost`,type:`number`,id:`param-output-cost-14`})]})]})]})]})]})]})]})}),_jsx(ParamField,{body:`remove_items`,type:`object[]`,id:`param-remove-items-9`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`feature_id`,type:`string`,id:`param-feature-id-81`,children:_jsx(_components.p,{children:`Match items linked to this feature.`})}),_jsx(ParamField,{body:`billing_method`,type:`'prepaid' | 'usage_based'`,id:`param-billing-method-24`,children:_jsx(_components.p,{children:`Match items with this billing method (prepaid or usage_based).`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,id:`param-interval-76`,children:_jsx(_components.p,{children:`Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.`})}),_jsx(ParamField,{body:`interval_count`,type:`integer`,id:`param-interval-count-66`,children:_jsx(_components.p,{children:`Match items with this interval_count. Disambiguates between items that share an interval but differ in count.`})}),_jsx(ParamField,{body:`included`,type:`number`,id:`param-included-31`,children:_jsx(_components.p,{children:`Match items whose grant equals this included usage. Omitted is a wildcard.`})})]})})]})}),_jsx(ParamField,{body:`metadata`,type:`object`,id:`param-metadata-10`})]})]}),_jsxs(ParamField,{body:`remove_licenses`,type:`object[]`,id:`param-remove-licenses-4`,children:[_jsx(_components.p,{children:`License links to drop, keyed by license_plan_id. Parallel to remove_items.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`license_plan_id`,type:`string`,required:true,id:`param-license-plan-id-10`})})]})]})]})]})]})]})]})]})]}),_jsxs(ParamField,{body:`item_changes`,type:`object[]`,required:true,id:`param-item-changes-2`,children:[_jsx(_components.p,{children:`Deprecated — use plan_change.item_changes. Features that were added to or removed from this plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`action`,type:`'created' | 'deleted'`,required:true,id:`param-action-4`,children:_jsx(_components.p,{children:`Whether the item was added to or removed from the plan.`})}),_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-82`,children:_jsx(_components.p,{children:`The ID of the feature that was added or removed.`})}),_jsxs(ParamField,{body:`item`,type:`object`,required:true,id:`param-item-2`,children:[_jsx(_components.p,{children:`The plan item snapshot that was added or removed.`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`threshold_billing`,type:`object | null`,id:`param-threshold-billing-15`,children:[_jsx(_components.p,{children:`Bills this many feature units when outstanding overage reaches it.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`threshold`,type:`number`,required:true,id:`param-threshold-35`})})]}),_jsx(ParamField,{body:`feature_id`,type:`string`,required:true,id:`param-feature-id-83`,children:_jsx(_components.p,{children:`The ID of the feature this item configures.`})}),_jsxs(ParamField,{body:`feature`,type:`object`,id:`param-feature-5`,children:[_jsx(_components.p,{children:`The full feature object if expanded.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`id`,type:`string`,required:true,id:`param-id-10`,children:_jsx(_components.p,{children:`The ID of the feature, used to refer to it in other API calls like /track or /check.`})}),_jsx(ParamField,{body:`name`,type:`string | null`,id:`param-name-20`,children:_jsx(_components.p,{children:`The name of the feature.`})}),_jsx(ParamField,{body:`type`,type:`'static' | 'boolean' | 'single_use' | 'continuous_use' | 'credit_system' | 'ai_credit_system'`,required:true,id:`param-type-5`,children:_jsx(_components.p,{children:`The type of the feature`})}),_jsxs(ParamField,{body:`display`,type:`object | null`,id:`param-display-17`,children:[_jsx(_components.p,{children:`Singular and plural display names for the feature.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`singular`,type:`string`,required:true,id:`param-singular-5`,children:_jsx(_components.p,{children:`The singular display name for the feature.`})}),_jsx(ParamField,{body:`plural`,type:`string`,required:true,id:`param-plural-5`,children:_jsx(_components.p,{children:`The plural display name for the feature.`})})]})]}),_jsxs(ParamField,{body:`credit_schema`,type:`object[] | null`,id:`param-credit-schema-20`,children:[_jsx(_components.p,{children:`Credit cost schema for credit system features.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`metered_feature_id`,type:`string`,required:true,id:`param-metered-feature-id-20`,children:_jsx(_components.p,{children:`The ID of the metered feature (should be a single_use feature).`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-50`,children:_jsx(_components.p,{children:`The credit cost of the metered feature.`})})]})]}),_jsx(ParamField,{body:`archived`,type:`boolean | null`,id:`param-archived-10`,children:_jsx(_components.p,{children:`Whether or not the feature is archived.`})})]})]}),_jsx(ParamField,{body:`included`,type:`number`,required:true,id:`param-included-32`,children:_jsx(_components.p,{children:`Number of free units included. For consumable features, balance resets to this number each interval.`})}),_jsx(ParamField,{body:`unlimited`,type:`boolean`,required:true,id:`param-unlimited-15`,children:_jsx(_components.p,{children:`Whether the customer has unlimited access to this feature.`})}),_jsx(ParamField,{body:`pooled`,type:`boolean`,id:`param-pooled-15`,children:_jsx(_components.p,{children:`Whether entity-level grants contribute to a shared customer balance.`})}),_jsxs(ParamField,{body:`reset`,type:`object | null`,required:true,id:`param-reset-15`,children:[_jsx(_components.p,{children:`Reset configuration for consumable features. Null for non-consumable features like seats where usage persists across billing cycles.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`interval`,type:`'one_off' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-77`,children:_jsx(_components.p,{children:`The interval at which the feature balance resets (e.g. ‘month’, ‘year’). For consumable features, usage resets to 0 and included units are restored.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-67`,children:_jsx(_components.p,{children:`Number of intervals between resets. Defaults to 1.`})})]})]}),_jsxs(ParamField,{body:`price`,type:`object | null`,required:true,id:`param-price-28`,children:[_jsx(_components.p,{children:`Pricing configuration for usage beyond included units. Null if feature is entirely free.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-99`,children:_jsx(_components.p,{children:`Price per billing_units after included usage is consumed. Mutually exclusive with tiers.`})}),_jsxs(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-47`,children:[_jsx(_components.p,{children:`Amounts in additional currencies for this flat price. The base ‘amount’ is in the org’s default currency. Only valid with ‘amount’, not ‘tiers’ (tiered prices carry per-currency amounts on each tier).`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-47`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-100`,children:_jsx(_components.p,{children:`Price amount in this currency. Set explicitly per currency, not converted from the base amount.`})})]})]}),_jsxs(ParamField,{body:`tiers`,type:`object[]`,id:`param-tiers-45`,children:[_jsx(_components.p,{children:`Tiered pricing configuration. Each tier’s ‘to’ INCLUDES the included amount. Either ‘tiers’ or ‘amount’ is required.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-45`}),_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount-101`}),_jsx(ParamField,{body:`flat_amount`,type:`number`,id:`param-flat-amount-30`}),_jsx(ParamField,{body:`additional_currencies`,type:`object[]`,id:`param-additional-currencies-48`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency-48`,children:_jsx(_components.p,{children:`Three-letter Stripe-supported currency code (e.g. ‘eur’, ‘gbp’).`})}),_jsx(ParamField,{body:`amount`,type:`number`,id:`param-amount-102`,children:_jsx(_components.p,{children:`Per-unit amount for this tier in this currency.`})}),_jsx(ParamField,{body:`flat_amount`,type:`number`,id:`param-flat-amount-31`,children:_jsx(_components.p,{children:`Flat amount for this tier in this currency, if the tier uses one.`})})]})})]})]}),_jsx(ParamField,{body:`tier_behavior`,type:`'graduated' | 'volume'`,id:`param-tier-behavior-45`,children:_jsx(_components.p,{children:`How tiers price usage. ‘graduated’ (default) charges each unit at the rate of the tier it falls in. ‘volume’ picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier’s rate plus its flat_amount.`})}),_jsx(ParamField,{body:`interval`,type:`'one_off' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year'`,required:true,id:`param-interval-78`,children:_jsx(_components.p,{children:`Billing interval for this price. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.`})}),_jsx(ParamField,{body:`interval_count`,type:`number`,id:`param-interval-count-68`,children:_jsx(_components.p,{children:`Number of intervals per billing cycle. Defaults to 1.`})}),_jsx(ParamField,{body:`billing_units`,type:`number`,required:true,id:`param-billing-units-30`,children:_jsx(_components.p,{children:`Number of units per price increment. Usage is rounded UP to the nearest billing_units when billed (e.g. billing_units=100 means 101 usage rounds to 200).`})}),_jsx(ParamField,{body:`billing_method`,type:`'prepaid' | 'usage_based'`,required:true,id:`param-billing-method-25`,children:_jsx(_components.p,{children:`‘prepaid’ for features like seats where customers pay upfront, ‘usage_based’ for pay-as-you-go after included usage.`})}),_jsx(ParamField,{body:`max_purchase`,type:`number | null`,required:true,id:`param-max-purchase-15`,children:_jsx(_components.p,{children:`Maximum units a customer can purchase beyond included. E.g. if included=100 and max_purchase=300, customer can use up to 400 total before usage is capped. Null for no limit.`})}),_jsxs(ParamField,{body:`processors`,type:`object`,id:`param-processors-17`,children:[_jsx(_components.p,{children:`Payment processors this item price is connected to. Omitted when unset.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`stripe`,type:`object | null`,id:`param-stripe-17`,children:_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`price_id`,type:`string`,required:true,id:`param-price-id-12`,children:_jsx(_components.p,{children:`Stripe price ID. For prepaid with included > 0 this is the V2 price.`})})})})})]})]})]}),_jsxs(ParamField,{body:`display`,type:`object`,id:`param-display-18`,children:[_jsx(_components.p,{children:`Display text for showing this item in pricing pages.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`primary_text`,type:`string`,required:true,id:`param-primary-text-12`,children:_jsx(_components.p,{children:`Main display text (e.g. ‘$10’ or ‘100 messages’).`})}),_jsx(ParamField,{body:`secondary_text`,type:`string`,id:`param-secondary-text-12`,children:_jsx(_components.p,{children:`Secondary display text (e.g. ‘per month’ or ‘then $0.5 per 100’).`})})]})]}),_jsxs(ParamField,{body:`rollover`,type:`object`,id:`param-rollover-15`,children:[_jsx(_components.p,{children:`Rollover configuration for unused units. If set, unused included units roll over to the next period.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`max`,type:`number | null`,required:true,id:`param-max-15`,children:_jsx(_components.p,{children:`Maximum rollover units. Null for unlimited rollover.`})}),_jsx(ParamField,{body:`max_percentage`,type:`number | null`,id:`param-max-percentage-15`,children:_jsx(_components.p,{children:`Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.`})}),_jsx(ParamField,{body:`expiry_duration_type`,type:`'month' | 'forever'`,required:true,id:`param-expiry-duration-type-15`,children:_jsx(_components.p,{children:`When rolled over units expire.`})}),_jsx(ParamField,{body:`expiry_duration_length`,type:`number`,id:`param-expiry-duration-length-15`,children:_jsx(_components.p,{children:`Number of periods before expiry.`})})]})]}),_jsxs(ParamField,{body:`expiry`,type:`object | null`,id:`param-expiry-15`,children:[_jsx(_components.p,{children:`Purchased units expire this long after each purchase. One-off prepaid consumable items only.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`duration`,type:`'day' | 'week' | 'month' | 'year'`,required:true,id:`param-duration-15`}),_jsx(ParamField,{body:`length`,type:`number`,required:true,id:`param-length-15`})]})]}),_jsxs(ParamField,{body:`feature_override`,type:`object`,id:`param-feature-override-15`,children:[_jsx(_components.p,{children:`Overrides fields of this item’s feature for customers on this plan (e.g. a credit system’s credit_schema).`}),_jsxs(Expandable,{title:`properties`,children:[_jsxs(ParamField,{body:`credit_schema`,type:`object | object | object[]`,id:`param-credit-schema-21`,children:[_jsxs(_components.p,{children:[`For credit system features: merges into the feature’s credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `,_jsx(_components.code,{children:`excluded: true`}),` removes it, and unlisted features keep the credit system’s rate.`]}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`metered_feature_id`,type:`string`,id:`param-metered-feature-id-21`,children:_jsx(_components.p,{children:`ID of the metered feature that draws from this credit system.`})}),_jsx(ParamField,{body:`billing_units`,type:`number`,id:`param-billing-units-31`,children:_jsx(_components.p,{children:`Number of metered-feature units priced together. Defaults to one when omitted.`})}),_jsxs(ParamField,{body:`dimensions.{key}`,type:`object`,id:`param-dimensions-key-15`,children:[_jsx(_components.p,{children:`Named rates chosen by event properties. The most specific match sets the rate; with no match the item’s own rate applies.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`match.{key}`,type:`string`,required:true,id:`param-match-key-30`,children:_jsx(_components.p,{children:`Event properties this entry applies to. Every key must equal the tracked property, compared as strings.`})}),_jsx(ParamField,{body:`priority`,type:`integer`,id:`param-priority-15`,children:_jsx(_components.p,{children:`Breaks ties between dimensions that match the same number of keys. Higher wins.`})}),_jsx(ParamField,{body:`tier_behavior`,type:`string`,required:true,id:`param-tier-behavior-46`}),_jsx(ParamField,{body:`tiers`,type:`object[]`,required:true,id:`param-tiers-46`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-46`,children:_jsx(_components.p,{children:`Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-51`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group within this tier.`})})]})})]})]}),_jsxs(ParamField,{body:`multipliers.{key}`,type:`object`,id:`param-multipliers-key-15`,children:[_jsx(_components.p,{children:`Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`match.{key}`,type:`string`,required:true,id:`param-match-key-31`,children:_jsx(_components.p,{children:`Event properties this entry applies to. Every key must equal the tracked property, compared as strings.`})}),_jsx(ParamField,{body:`factor`,type:`number`,id:`param-factor-15`,children:_jsx(_components.p,{children:`Multiplies the matched rate. All matching multipliers stack.`})}),_jsx(ParamField,{body:`add`,type:`number`,id:`param-add-15`,children:_jsx(_components.p,{children:`Added to the rate after every factor is applied, in credits per billing-unit group.`})})]})]}),_jsx(ParamField,{body:`tier_behavior`,type:`string`,id:`param-tier-behavior-47`}),_jsx(ParamField,{body:`tiers`,type:`object[]`,id:`param-tiers-47`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`to`,type:`number`,required:true,id:`param-to-47`,children:_jsx(_components.p,{children:`Inclusive upper usage boundary for this graduated tier. The final tier must be ‘inf’.`})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,required:true,id:`param-credit-cost-52`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group within this tier.`})})]})}),_jsx(ParamField,{body:`credit_cost`,type:`number`,id:`param-credit-cost-53`,children:_jsx(_components.p,{children:`Credits consumed per billing-unit group.`})}),_jsx(ParamField,{body:`excluded`,type:`true`,id:`param-excluded-15`,children:_jsx(_components.p,{children:`Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.`})})]})]}),_jsxs(ParamField,{body:`markups`,type:`object`,id:`param-markups-15`,children:[_jsx(_components.p,{children:`For AI credit system features: replaces the feature’s markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature’s.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`default_markup`,type:`number`,id:`param-default-markup-15`,children:_jsx(_components.p,{children:`Default percentage markup for customers on this plan. Use -100 to make usage free.`})}),_jsxs(ParamField,{body:`provider_markups.{key}`,type:`object | null`,id:`param-provider-markups-key-15`,children:[_jsx(_components.p,{children:`Per-provider markup percentages for customers on this plan.`}),_jsx(Expandable,{title:`properties`,children:_jsx(ParamField,{body:`markup`,type:`number`,required:true,id:`param-markup-30`})})]}),_jsxs(ParamField,{body:`model_markups.{key}`,type:`object | null`,id:`param-model-markups-key-15`,children:[_jsx(_components.p,{children:`Per-model markup overrides for customers on this plan.`}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`markup`,type:`number`,id:`param-markup-31`}),_jsx(ParamField,{body:`input_cost`,type:`number`,id:`param-input-cost-15`}),_jsx(ParamField,{body:`output_cost`,type:`number`,id:`param-output-cost-15`})]})]})]})]})]})]})]})]})]})]})]})]}),`\n`,_jsx(ParamField,{body:`tags`,type:`string[]`,required:true,id:`param-tags`,children:_jsx(_components.p,{children:`Reason tags describing why this event fired (e.g. ‘trial_ended’, ‘phase_changed’). Always present; empty when no specific reason applies.`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Plans Updated","openapi":"api/openapi.yml webhook billing.updated","description":"Fired when a customer's plans change — activated, scheduled, updated, or expired. Each event carries a `plan_changes` array describing what happened and a `tags` array (e.g. `trial_ended`, `phase_changed`) describing why.","href":"/api-reference/webhooks/billingUpdated"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Payload Fields","slug":"payload-fields","depth":3,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/autumn-b9b4c0fb/d78b8c063824141d/dynamic-response.js"],"openApiReferenceData":{"operation":{"operationId":"billingUpdated","summary":"Plans Updated","description":"Fired when a customer's plans change — activated, scheduled, updated, or expired. Each event carries a `plan_changes` array describing what happened and a `tags` array (e.g. `trial_ended`, `phase_changed`) describing why.","requestBody":"2f1c655e-49ae-4b04-baa9-34603fc6958d","responses":{"200":"cf843492-ad7b-4892-a199-dbab59e79c6f"},"method":"post","type":"webhook","servers":["b9562f6e-da6c-4347-b728-e83ef4de48d9"],"security":["5fa91c57-6f3e-4574-a1a0-b31635047121"],"path":"billing.updated","baseUrlOptions":["https://api.useautumn.com"],"title":"Plans Updated","codeSamples":[],"requestExampleLanguages":["typescript","python","bash"],"requiredOnlyExamples":false,"requestExamples":[{"language":"json","filename":"Example","code":"{\n \"type\": \"billing.updated\",\n \"data\": {\n \"object\": \"billing.updated\",\n \"customer_id\": \"cus_123\",\n \"plan_changes\": [\n {\n \"action\": \"activated\",\n \"subscription\": {\n \"plan_id\": \"pro\",\n \"status\": \"active\",\n \"past_due\": false,\n \"started_at\": 1779000000000,\n \"canceled_at\": null,\n \"expires_at\": null,\n \"trial_ends_at\": null,\n \"current_period_start\": 1779000000000,\n \"current_period_end\": 1781592000000\n },\n \"previous_attributes\": null,\n \"item_changes\": []\n },\n {\n \"action\": \"expired\",\n \"subscription\": {\n \"plan_id\": \"free\",\n \"status\": \"expired\",\n \"past_due\": false,\n \"started_at\": 1776000000000,\n \"canceled_at\": 1779000000000,\n \"expires_at\": 1779000000000,\n \"trial_ends_at\": null,\n \"current_period_start\": null,\n \"current_period_end\": null\n },\n \"previous_attributes\": {\n \"status\": \"active\"\n },\n \"item_changes\": []\n }\n ],\n \"tags\": []\n }\n}"}],"requestExampleType":"webhook","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["type","data"],"properties":{"type":{"type":"string","const":"billing.updated","description":"The webhook event type.","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"data":{"examples":[{"object":"billing.updated","customer_id":"cus_123","plan_changes":[{"action":"activated","subscription":{"plan_id":"pro","status":"active","past_due":false,"started_at":1779000000000,"canceled_at":null,"expires_at":null,"trial_ends_at":null,"current_period_start":1779000000000,"current_period_end":1781592000000},"previous_attributes":null,"item_changes":[]},{"action":"expired","subscription":{"plan_id":"free","status":"expired","past_due":false,"started_at":1776000000000,"canceled_at":1779000000000,"expires_at":1779000000000,"trial_ends_at":null,"current_period_start":null,"current_period_end":null},"previous_attributes":{"status":"active"},"item_changes":[]}],"tags":[]}],"type":"object","properties":{"object":{"type":"string","const":"billing.updated","isRequired":true,"uniqueKey":"data.object","typeLabel":"string"},"customer_id":{"description":"The ID of the customer whose plans changed.","type":"string","isRequired":true,"uniqueKey":"data.customer_id","typeLabel":"string"},"plan_changes":{"description":"The plans that were activated, scheduled, updated, or expired.","type":"array","items":{"type":"object","properties":{"action":{"description":"The lifecycle action applied to this plan: activated (newly active on the customer), scheduled (queued for a future start), updated (mutated in place), expired (ended), or paused (set aside until a revert trial ends).","type":"string","enum":["activated","scheduled","updated","expired","paused"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].action","typeLabel":"enum\u003cstring>"},"previous_attributes":{"oneOf":[{"type":"object","description":"Sparse map of lifecycle scalar fields whose values changed, holding their previous values. Null when the plan is newly activated or scheduled, or when no lifecycle field changed.","properties":{"status":{"description":"The current status of the subscription on the customer.","type":"string","enum":["active","scheduled","expired"],"uniqueKey":"data.plan_changes.items.[INDEX].previous_attributes.oneOf.0.status","typeLabel":"enum\u003cstring>"},"past_due":{"type":"boolean","description":"Whether the subscription has overdue payments.","uniqueKey":"data.plan_changes.items.[INDEX].previous_attributes.oneOf.0.past_due","typeLabel":"boolean"},"canceled_at":{"oneOf":[{"type":"number","description":"When the subscription was canceled, in milliseconds since the Unix epoch, or null if not canceled.","uniqueKey":"data.plan_changes.items.[INDEX].previous_attributes.oneOf.0.canceled_at.oneOf.0","typeLabel":"number"},{"type":"null","description":"When the subscription was canceled, in milliseconds since the Unix epoch, or null if not canceled.","uniqueKey":"data.plan_changes.items.[INDEX].previous_attributes.oneOf.0.canceled_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].previous_attributes.oneOf.0.canceled_at","typeLabel":"number | null"},"expires_at":{"oneOf":[{"type":"number","description":"When the subscription ends, in milliseconds since the Unix epoch, or null if no expiry is set.","uniqueKey":"data.plan_changes.items.[INDEX].previous_attributes.oneOf.0.expires_at.oneOf.0","typeLabel":"number"},{"type":"null","description":"When the subscription ends, in milliseconds since the Unix epoch, or null if no expiry is set.","uniqueKey":"data.plan_changes.items.[INDEX].previous_attributes.oneOf.0.expires_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].previous_attributes.oneOf.0.expires_at","typeLabel":"number | null"},"trial_ends_at":{"oneOf":[{"type":"number","description":"When the trial ends, in milliseconds since the Unix epoch. Null when not actively trialing.","uniqueKey":"data.plan_changes.items.[INDEX].previous_attributes.oneOf.0.trial_ends_at.oneOf.0","typeLabel":"number"},{"type":"null","description":"When the trial ends, in milliseconds since the Unix epoch. Null when not actively trialing.","uniqueKey":"data.plan_changes.items.[INDEX].previous_attributes.oneOf.0.trial_ends_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].previous_attributes.oneOf.0.trial_ends_at","typeLabel":"number | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].previous_attributes.oneOf.0","typeLabel":"object"},{"type":"null","description":"Sparse map of lifecycle scalar fields whose values changed, holding their previous values. Null when the plan is newly activated or scheduled, or when no lifecycle field changed.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].previous_attributes.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].previous_attributes","typeLabel":"object | null"},"item_changes":{"deprecated":true,"description":"Deprecated — use plan_change.item_changes. Features that were added to or removed from this plan.","default":[],"type":"array","items":{"type":"object","properties":{"action":{"description":"Whether the item was added to or removed from the plan.","type":"string","enum":["created","deleted"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].action","typeLabel":"enum\u003cstring>"},"feature_id":{"description":"The ID of the feature that was added or removed.","type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].feature_id","typeLabel":"string"},"item":{"description":"The plan item snapshot that was added or removed.","type":"object","properties":{"feature_id":{"type":"string","description":"The ID of the feature this item configures.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_id","typeLabel":"string"},"included":{"type":"number","description":"Number of free units included. For consumable features, balance resets to this number each interval.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.included","typeLabel":"number"},"unlimited":{"type":"boolean","description":"Whether the customer has unlimited access to this feature.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.unlimited","typeLabel":"boolean"},"reset":{"oneOf":[{"type":"object","description":"Reset configuration for consumable features. Null for non-consumable features like seats where usage persists across billing cycles.","required":["interval"],"properties":{"interval":{"enum":["one_off","minute","hour","day","week","month","quarter","semi_annual","year"],"type":"string","description":"The interval at which the feature balance resets (e.g. 'month', 'year'). For consumable features, usage resets to 0 and included units are restored.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.reset.oneOf.0.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","description":"Number of intervals between resets. Defaults to 1.","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.reset.oneOf.0.interval_count","typeLabel":"number"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.reset.oneOf.0","typeLabel":"object"},{"type":"null","description":"Reset configuration for consumable features. Null for non-consumable features like seats where usage persists across billing cycles.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.reset.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.reset","typeLabel":"object | null"},"price":{"oneOf":[{"type":"object","description":"Pricing configuration for usage beyond included units. Null if feature is entirely free.","required":["interval","billing_units","billing_method","max_purchase"],"properties":{"interval":{"enum":["one_off","week","month","quarter","semi_annual","year"],"type":"string","description":"Billing interval for this price. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.price.oneOf.0.interval","typeLabel":"enum\u003cstring>"},"billing_units":{"type":"number","description":"Number of units per price increment. Usage is rounded UP to the nearest billing_units when billed (e.g. billing_units=100 means 101 usage rounds to 200).","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.price.oneOf.0.billing_units","typeLabel":"number"},"billing_method":{"enum":["prepaid","usage_based"],"type":"string","description":"'prepaid' for features like seats where customers pay upfront, 'usage_based' for pay-as-you-go after included usage.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.price.oneOf.0.billing_method","typeLabel":"enum\u003cstring>"},"max_purchase":{"oneOf":[{"type":"number","description":"Maximum units a customer can purchase beyond included. E.g. if included=100 and max_purchase=300, customer can use up to 400 total before usage is capped. Null for no limit.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.price.oneOf.0.max_purchase.oneOf.0","typeLabel":"number"},{"type":"null","description":"Maximum units a customer can purchase beyond included. E.g. if included=100 and max_purchase=300, customer can use up to 400 total before usage is capped. Null for no limit.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.price.oneOf.0.max_purchase.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.price.oneOf.0.max_purchase","typeLabel":"number | null"},"amount":{"type":"number","description":"Price per billing_units after included usage is consumed. Mutually exclusive with tiers.","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.price.oneOf.0.amount","typeLabel":"number"},"additional_currencies":{"description":"Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers' (tiered prices carry per-currency amounts on each tier).","type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.price.oneOf.0.additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Price amount in this currency. Set explicitly per currency, not converted from the base amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.price.oneOf.0.additional_currencies.items.[INDEX].amount","typeLabel":"number"}},"required":["currency","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.price.oneOf.0.additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.price.oneOf.0.additional_currencies","typeLabel":"object[]"},"tiers":{"description":"Tiered pricing configuration. Each tier's 'to' INCLUDES the included amount. Either 'tiers' or 'amount' is required.","type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.price.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","const":"inf","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.price.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.price.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | string"},"amount":{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.price.oneOf.0.tiers.items.[INDEX].amount","typeLabel":"number"},"flat_amount":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.price.oneOf.0.tiers.items.[INDEX].flat_amount","typeLabel":"number"},"additional_currencies":{"type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.price.oneOf.0.tiers.items.[INDEX].additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Per-unit amount for this tier in this currency.","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.price.oneOf.0.tiers.items.[INDEX].additional_currencies.items.[INDEX].amount","typeLabel":"number"},"flat_amount":{"type":"number","description":"Flat amount for this tier in this currency, if the tier uses one.","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.price.oneOf.0.tiers.items.[INDEX].additional_currencies.items.[INDEX].flat_amount","typeLabel":"number"}},"required":["currency"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.price.oneOf.0.tiers.items.[INDEX].additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.price.oneOf.0.tiers.items.[INDEX].additional_currencies","typeLabel":"object[]"}},"required":["to","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.price.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.price.oneOf.0.tiers","typeLabel":"object[]"},"tier_behavior":{"enum":["graduated","volume"],"type":"string","description":"How tiers price usage. 'graduated' (default) charges each unit at the rate of the tier it falls in. 'volume' picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier's rate plus its flat_amount.","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.price.oneOf.0.tier_behavior","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","description":"Number of intervals per billing cycle. Defaults to 1.","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.price.oneOf.0.interval_count","typeLabel":"number"},"processors":{"description":"Payment processors this item price is connected to. Omitted when unset.","x-atmn-mapping":true,"type":"object","properties":{"stripe":{"oneOf":[{"type":"object","required":["price_id"],"properties":{"price_id":{"type":"string","description":"Stripe price ID. For prepaid with included > 0 this is the V2 price.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.price.oneOf.0.processors.stripe.oneOf.0.price_id","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.price.oneOf.0.processors.stripe.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.price.oneOf.0.processors.stripe.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.price.oneOf.0.processors.stripe","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.price.oneOf.0.processors","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.price.oneOf.0","typeLabel":"object"},{"type":"null","description":"Pricing configuration for usage beyond included units. Null if feature is entirely free.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.price.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.price","typeLabel":"object | null"},"threshold_billing":{"oneOf":[{"type":"object","description":"Bills this many feature units when outstanding overage reaches it.","required":["threshold"],"properties":{"threshold":{"type":"number","exclusiveMinimum":0,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.threshold_billing.oneOf.0.threshold","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.threshold_billing.oneOf.0","typeLabel":"object"},{"type":"null","description":"Bills this many feature units when outstanding overage reaches it.","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.threshold_billing.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.threshold_billing","typeLabel":"object | null"},"feature":{"description":"The full feature object if expanded.","type":"object","properties":{"id":{"type":"string","description":"The ID of the feature, used to refer to it in other API calls like /track or /check.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature.id","typeLabel":"string"},"type":{"enum":["static","boolean","single_use","continuous_use","credit_system","ai_credit_system"],"type":"string","description":"The type of the feature","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature.type","typeLabel":"enum\u003cstring>"},"name":{"oneOf":[{"type":"string","description":"The name of the feature.","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature.name.oneOf.0","typeLabel":"string"},{"type":"null","description":"The name of the feature.","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature.name","typeLabel":"string | null"},"display":{"oneOf":[{"type":"object","description":"Singular and plural display names for the feature.","required":["singular","plural"],"properties":{"singular":{"type":"string","description":"The singular display name for the feature.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature.display.oneOf.0.singular","typeLabel":"string"},"plural":{"type":"string","description":"The plural display name for the feature.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature.display.oneOf.0.plural","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature.display.oneOf.0","typeLabel":"object"},{"type":"null","description":"Singular and plural display names for the feature.","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature.display.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature.display","typeLabel":"object | null"},"credit_schema":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"metered_feature_id":{"type":"string","description":"The ID of the metered feature (should be a single_use feature).","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature.credit_schema.oneOf.0.items.[INDEX].metered_feature_id","typeLabel":"string"},"credit_cost":{"type":"number","description":"The credit cost of the metered feature.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature.credit_schema.oneOf.0.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["metered_feature_id","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature.credit_schema.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Credit cost schema for credit system features.","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature.credit_schema.oneOf.0","typeLabel":"object[]"},{"type":"null","description":"Credit cost schema for credit system features.","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature.credit_schema.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature.credit_schema","typeLabel":"object[] | null"},"archived":{"oneOf":[{"type":"boolean","description":"Whether or not the feature is archived.","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature.archived.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether or not the feature is archived.","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature.archived.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature.archived","typeLabel":"boolean | null"}},"required":["id","type"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature","typeLabel":"object"},"pooled":{"type":"boolean","default":false,"description":"Whether entity-level grants contribute to a shared customer balance.","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.pooled","typeLabel":"boolean"},"display":{"description":"Display text for showing this item in pricing pages.","type":"object","properties":{"primary_text":{"type":"string","description":"Main display text (e.g. '$10' or '100 messages').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.display.primary_text","typeLabel":"string"},"secondary_text":{"type":"string","description":"Secondary display text (e.g. 'per month' or 'then $0.5 per 100').","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.display.secondary_text","typeLabel":"string"}},"required":["primary_text"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.display","typeLabel":"object"},"rollover":{"description":"Rollover configuration for unused units. If set, unused included units roll over to the next period.","type":"object","properties":{"max":{"oneOf":[{"type":"number","description":"Maximum rollover units. Null for unlimited rollover.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.rollover.max.oneOf.0","typeLabel":"number"},{"type":"null","description":"Maximum rollover units. Null for unlimited rollover.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.rollover.max.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.rollover.max","typeLabel":"number | null"},"expiry_duration_type":{"enum":["month","forever"],"type":"string","description":"When rolled over units expire.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.rollover.expiry_duration_type","typeLabel":"enum\u003cstring>"},"max_percentage":{"oneOf":[{"type":"number","description":"Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.rollover.max_percentage.oneOf.0","typeLabel":"number"},{"type":"null","description":"Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.rollover.max_percentage.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.rollover.max_percentage","typeLabel":"number | null"},"expiry_duration_length":{"type":"number","description":"Number of periods before expiry.","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.rollover.expiry_duration_length","typeLabel":"number"}},"required":["max","expiry_duration_type"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.rollover","typeLabel":"object"},"expiry":{"oneOf":[{"type":"object","description":"Purchased units expire this long after each purchase. One-off prepaid consumable items only.","required":["duration","length"],"properties":{"duration":{"enum":["day","week","month","year"],"type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.expiry.oneOf.0.duration","typeLabel":"enum\u003cstring>"},"length":{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.expiry.oneOf.0.length","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.expiry.oneOf.0","typeLabel":"object"},{"type":"null","description":"Purchased units expire this long after each purchase. One-off prepaid consumable items only.","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.expiry.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.expiry","typeLabel":"object | null"},"feature_override":{"description":"Overrides fields of this item's feature for customers on this plan (e.g. a credit system's credit_schema).","type":"object","properties":{"credit_schema":{"description":"For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.","type":"array","items":{"oneOf":[{"type":"object","required":["metered_feature_id","tier_behavior","tiers"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature that draws from this credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.metered_feature_id","typeLabel":"string"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.tiers","typeLabel":"object[]"},"billing_units":{"type":"number","exclusiveMinimum":0,"description":"Number of metered-feature units priced together. Defaults to one when omitted.","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.billing_units","typeLabel":"number"},"dimensions":{"description":"Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies.","type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"oneOf":[{"type":"object","required":["match","tier_behavior","tiers"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.match","typeLabel":"object"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers","typeLabel":"object[]"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["match","credit_cost"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.match","typeLabel":"object"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group when this dimension matches.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.credit_cost","typeLabel":"number"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions","typeLabel":"object"},"multipliers":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"object","properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.match","typeLabel":"object"},"factor":{"type":"number","exclusiveMinimum":0,"description":"Multiplies the matched rate. All matching multipliers stack.","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.factor","typeLabel":"number"},"add":{"type":"number","description":"Added to the rate after every factor is applied, in credits per billing-unit group.","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.add","typeLabel":"number"}},"required":["match"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties","typeLabel":"object"},"description":"Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["metered_feature_id","credit_cost"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature that draws from this credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.metered_feature_id","typeLabel":"string"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.credit_cost","typeLabel":"number"},"billing_units":{"type":"number","exclusiveMinimum":0,"description":"Number of metered-feature units priced together. Defaults to one when omitted.","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.billing_units","typeLabel":"number"},"dimensions":{"description":"Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies.","type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"oneOf":[{"type":"object","required":["match","tier_behavior","tiers"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.match","typeLabel":"object"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers","typeLabel":"object[]"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["match","credit_cost"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.match","typeLabel":"object"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group when this dimension matches.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.credit_cost","typeLabel":"number"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions","typeLabel":"object"},"multipliers":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"object","properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.match","typeLabel":"object"},"factor":{"type":"number","exclusiveMinimum":0,"description":"Multiplies the matched rate. All matching multipliers stack.","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.factor","typeLabel":"number"},"add":{"type":"number","description":"Added to the rate after every factor is applied, in credits per billing-unit group.","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.add","typeLabel":"number"}},"required":["match"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties","typeLabel":"object"},"description":"Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["metered_feature_id","excluded"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature to remove from the credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.2.metered_feature_id","typeLabel":"string"},"excluded":{"description":"Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.","type":"boolean","const":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.2.excluded","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.2","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.credit_schema","typeLabel":"object[]"},"markups":{"description":"For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.","type":"object","properties":{"default_markup":{"type":"number","minimum":-100,"description":"Default percentage markup for customers on this plan. Use -100 to make usage free.","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.markups.default_markup","typeLabel":"number"},"provider_markups":{"oneOf":[{"type":"object","description":"Per-provider markup percentages for customers on this plan.","additionalProperties":{"type":"object","properties":{"markup":{"type":"number","minimum":-100,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.markups.provider_markups.oneOf.0.additionalProperties.markup","typeLabel":"number"}},"required":["markup"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.markups.provider_markups.oneOf.0.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.markups.provider_markups.oneOf.0","typeLabel":"object"},{"type":"null","description":"Per-provider markup percentages for customers on this plan.","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.markups.provider_markups.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.markups.provider_markups","typeLabel":"object | null"},"model_markups":{"oneOf":[{"type":"object","description":"Per-model markup overrides for customers on this plan.","additionalProperties":{"type":"object","properties":{"markup":{"type":"number","minimum":-100,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.markups.model_markups.oneOf.0.additionalProperties.markup","typeLabel":"number"},"input_cost":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.markups.model_markups.oneOf.0.additionalProperties.input_cost","typeLabel":"number"},"output_cost":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.markups.model_markups.oneOf.0.additionalProperties.output_cost","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.markups.model_markups.oneOf.0.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.markups.model_markups.oneOf.0","typeLabel":"object"},{"type":"null","description":"Per-model markup overrides for customers on this plan.","uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.markups.model_markups.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.markups.model_markups","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override.markups","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item.feature_override","typeLabel":"object"}},"required":["feature_id","included","unlimited","reset","price"],"additionalProperties":false,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX].item","typeLabel":"object"}},"required":["action","feature_id","item"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].item_changes","typeLabel":"object[]"},"entity_id":{"oneOf":[{"type":"string","description":"The ID of the entity this plan is scoped to, or null when the plan is customer-level. A single event can carry changes for several entities.","uniqueKey":"data.plan_changes.items.[INDEX].entity_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The ID of the entity this plan is scoped to, or null when the plan is customer-level. A single event can carry changes for several entities.","uniqueKey":"data.plan_changes.items.[INDEX].entity_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].entity_id","typeLabel":"string | null"},"subscription":{"description":"The subscription as it stands after this change. Present when the plan is billed as a recurring subscription.","type":"object","properties":{"plan_id":{"description":"The ID of the customer plan.","type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].subscription.plan_id","typeLabel":"string"},"status":{"description":"The current status of the subscription on the customer.","type":"string","enum":["active","scheduled","expired"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].subscription.status","typeLabel":"enum\u003cstring>"},"past_due":{"type":"boolean","description":"Whether the subscription has overdue payments.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].subscription.past_due","typeLabel":"boolean"},"started_at":{"oneOf":[{"type":"number","description":"When the subscription started, in milliseconds since the Unix epoch.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].subscription.started_at.oneOf.0","typeLabel":"number"},{"type":"null","description":"When the subscription started, in milliseconds since the Unix epoch.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].subscription.started_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].subscription.started_at","typeLabel":"number | null"},"canceled_at":{"oneOf":[{"type":"number","description":"When the subscription was canceled, in milliseconds since the Unix epoch, or null if not canceled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].subscription.canceled_at.oneOf.0","typeLabel":"number"},{"type":"null","description":"When the subscription was canceled, in milliseconds since the Unix epoch, or null if not canceled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].subscription.canceled_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].subscription.canceled_at","typeLabel":"number | null"},"expires_at":{"oneOf":[{"type":"number","description":"When the subscription ends, in milliseconds since the Unix epoch, or null if no expiry is set.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].subscription.expires_at.oneOf.0","typeLabel":"number"},{"type":"null","description":"When the subscription ends, in milliseconds since the Unix epoch, or null if no expiry is set.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].subscription.expires_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].subscription.expires_at","typeLabel":"number | null"},"trial_ends_at":{"oneOf":[{"type":"number","description":"When the trial ends, in milliseconds since the Unix epoch. Null when not actively trialing.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].subscription.trial_ends_at.oneOf.0","typeLabel":"number"},{"type":"null","description":"When the trial ends, in milliseconds since the Unix epoch. Null when not actively trialing.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].subscription.trial_ends_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].subscription.trial_ends_at","typeLabel":"number | null"},"current_period_start":{"oneOf":[{"type":"number","description":"Start of the current billing period, or null if not applicable.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].subscription.current_period_start.oneOf.0","typeLabel":"number"},{"type":"null","description":"Start of the current billing period, or null if not applicable.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].subscription.current_period_start.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].subscription.current_period_start","typeLabel":"number | null"},"current_period_end":{"oneOf":[{"type":"number","description":"End of the current billing period, or null if not applicable.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].subscription.current_period_end.oneOf.0","typeLabel":"number"},{"type":"null","description":"End of the current billing period, or null if not applicable.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].subscription.current_period_end.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].subscription.current_period_end","typeLabel":"number | null"}},"required":["plan_id","status","past_due","started_at","canceled_at","expires_at","trial_ends_at","current_period_start","current_period_end"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].subscription","typeLabel":"object"},"purchase":{"description":"The purchase as it stands after this change. Present when the plan is a one-off purchase.","type":"object","properties":{"plan_id":{"description":"The ID of the customer plan.","type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].purchase.plan_id","typeLabel":"string"},"status":{"description":"The current status of the purchase on the customer.","type":"string","enum":["active","scheduled","expired"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].purchase.status","typeLabel":"enum\u003cstring>"},"expires_at":{"oneOf":[{"type":"number","description":"When the purchase ends, in milliseconds since the Unix epoch, or null if no expiry is set.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].purchase.expires_at.oneOf.0","typeLabel":"number"},{"type":"null","description":"When the purchase ends, in milliseconds since the Unix epoch, or null if no expiry is set.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].purchase.expires_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].purchase.expires_at","typeLabel":"number | null"}},"required":["plan_id","status","expires_at"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].purchase","typeLabel":"object"},"plan_change":{"description":"Content-level change to the plan definition for this customer plan (items, base price, free trial).","type":"object","properties":{"previous_attributes":{"oneOf":[{"type":"object","description":"Sparse map of scalar plan fields that changed, holding their previous values. Null when the plan is new.","properties":{"id":{"oneOf":[{"type":"string","description":"Unique identifier for the plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.id","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","description":"Display name of the plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.name","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","description":"Optional description of the plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.description.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional description of the plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.description.oneOf.1","typeLabel":"null"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.description.oneOf.2","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.description","typeLabel":"string · null · null"},"group":{"oneOf":[{"type":"string","description":"Group identifier for organizing related plans. Plans in the same group are mutually exclusive.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.group.oneOf.0","typeLabel":"string"},{"type":"null","description":"Group identifier for organizing related plans. Plans in the same group are mutually exclusive.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.group.oneOf.1","typeLabel":"null"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.group.oneOf.2","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.group","typeLabel":"string · null · null"},"add_on":{"oneOf":[{"type":"boolean","description":"Whether this is an add-on plan that can be attached alongside a main plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.add_on.oneOf.0","typeLabel":"boolean"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.add_on.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.add_on","typeLabel":"boolean | null"},"auto_enable":{"oneOf":[{"type":"boolean","description":"If true, this plan is automatically attached when a customer is created. Used for free plans.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.auto_enable.oneOf.0","typeLabel":"boolean"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.auto_enable.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.auto_enable","typeLabel":"boolean | null"},"config":{"oneOf":[{"type":"object","description":"Miscellaneous plan-level configuration flags.","required":["ignore_past_due"],"properties":{"ignore_past_due":{"type":"boolean","default":false,"description":"If true, entitlements attached to this plan will still reset on schedule even when the customer's product is in a past_due state.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.config.oneOf.0.ignore_past_due","typeLabel":"boolean"},"anchor_to_month_start":{"type":"boolean","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.config.oneOf.0.anchor_to_month_start","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.config.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.config.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.config","typeLabel":"object | null"},"active":{"oneOf":[{"type":"boolean","description":"The `active` flag before this update; true on the version being demoted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.active.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"The `active` flag before this update; true on the version being demoted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.active.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.active","typeLabel":"boolean | null"},"archived":{"oneOf":[{"type":"boolean","description":"Whether the plan is archived. Archived plans cannot be attached to new customers.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.archived.oneOf.0","typeLabel":"boolean"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.archived.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.archived","typeLabel":"boolean | null"},"metadata":{"oneOf":[{"type":"object","description":"Arbitrary key-value metadata defined by you for your own use. Shared across all versions of the plan.","additionalProperties":{"oneOf":[{}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.metadata.oneOf.0.additionalProperties","typeLabel":"any"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.metadata.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.metadata","typeLabel":"object | null"},"processors":{"oneOf":[{"type":"object","description":"Previous payment processors when they changed. Null when the plan had none.","x-atmn-mapping":true,"properties":{"stripe":{"oneOf":[{"type":"object","required":["product_id"],"properties":{"product_id":{"type":"string","description":"Stripe product ID this plan is billed under.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.processors.oneOf.0.stripe.oneOf.0.product_id","typeLabel":"string"},"additional_product_ids":{"type":"array","items":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.processors.oneOf.0.stripe.oneOf.0.additional_product_ids.items.[INDEX]","typeLabel":"string"},"description":"Extra Stripe product IDs aliased to this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.processors.oneOf.0.stripe.oneOf.0.additional_product_ids","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.processors.oneOf.0.stripe.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.processors.oneOf.0.stripe.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.processors.oneOf.0.stripe","typeLabel":"object | null"},"revenuecat":{"oneOf":[{"type":"object","required":["products"],"properties":{"products":{"description":"Every RevenueCat product that maps to this plan. Replaces the current set.","type":"array","items":{"type":"object","properties":{"product_id":{"type":"string","description":"RevenueCat product ID that grants this plan when purchased.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.processors.oneOf.0.revenuecat.oneOf.0.products.items.[INDEX].product_id","typeLabel":"string"},"feature_quantities":{"description":"Prepaid quantities granted when this specific RevenueCat product is purchased, in feature units.","type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.processors.oneOf.0.revenuecat.oneOf.0.products.items.[INDEX].feature_quantities.items.[INDEX].feature_id","typeLabel":"string"},"quantity":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.processors.oneOf.0.revenuecat.oneOf.0.products.items.[INDEX].feature_quantities.items.[INDEX].quantity","typeLabel":"number"}},"required":["feature_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.processors.oneOf.0.revenuecat.oneOf.0.products.items.[INDEX].feature_quantities.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.processors.oneOf.0.revenuecat.oneOf.0.products.items.[INDEX].feature_quantities","typeLabel":"object[]"}},"required":["product_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.processors.oneOf.0.revenuecat.oneOf.0.products.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.processors.oneOf.0.revenuecat.oneOf.0.products","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.processors.oneOf.0.revenuecat.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.processors.oneOf.0.revenuecat.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.processors.oneOf.0.revenuecat","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.processors.oneOf.0","typeLabel":"object"},{"type":"null","description":"Previous payment processors when they changed. Null when the plan had none.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.processors.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.processors","typeLabel":"object | null"},"base_variant_id":{"oneOf":[{"type":"string","description":"The base plan this variant pointed at before this update re-anchored it. Null when it was standalone.","deprecated":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.base_variant_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The base plan this variant pointed at before this update re-anchored it. Null when it was standalone.","deprecated":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.base_variant_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.base_variant_id","typeLabel":"string | null"},"base_version":{"oneOf":[{"type":"integer","description":"The base row version this variant pointed at before this update. Null when it was standalone.","maximum":9007199254740991,"minimum":1,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.base_version.oneOf.0","typeLabel":"integer"},{"type":"null","description":"The base row version this variant pointed at before this update. Null when it was standalone.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.base_version.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.base_version","typeLabel":"integer | null"},"base_version_slug":{"oneOf":[{"type":"string","description":"The base row version slug this variant pointed at before this update. Null when it was standalone.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.base_version_slug.oneOf.0","typeLabel":"string"},{"type":"null","description":"The base row version slug this variant pointed at before this update. Null when it was standalone.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.base_version_slug.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.base_version_slug","typeLabel":"string | null"},"free_trial":{"oneOf":[{"type":"object","description":"Previous free trial when it changed. Null when the plan had none.","required":["duration_length","duration_type","card_required"],"properties":{"duration_length":{"type":"number","description":"Number of duration_type periods the trial lasts.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.free_trial.oneOf.0.duration_length","typeLabel":"number"},"duration_type":{"enum":["day","month","year"],"type":"string","description":"Unit of time for the trial duration ('day', 'month', 'year').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.free_trial.oneOf.0.duration_type","typeLabel":"enum\u003cstring>"},"card_required":{"type":"boolean","description":"Whether a payment method is required to start the trial. If true, customer will be charged after trial ends.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.free_trial.oneOf.0.card_required","typeLabel":"boolean"},"on_end":{"oneOf":[{"type":"string","description":"Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.","enum":["bill","revert"],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.free_trial.oneOf.0.on_end.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.free_trial.oneOf.0.on_end.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.free_trial.oneOf.0.on_end","typeLabel":"enum\u003cstring> | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.free_trial.oneOf.0","typeLabel":"object"},{"type":"null","description":"Previous free trial when it changed. Null when the plan had none.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.free_trial.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.free_trial","typeLabel":"object | null"},"billing_controls":{"oneOf":[{"type":"object","description":"Sparse previous billing_controls — only keys that changed. Null when unset; a null lane was unset before.","properties":{"auto_topups":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"The ID of the feature (credit balance) to auto top-up.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.auto_topups.oneOf.0.items.[INDEX].feature_id","typeLabel":"string"},"enabled":{"type":"boolean","default":false,"description":"Whether auto top-up is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.auto_topups.oneOf.0.items.[INDEX].enabled","typeLabel":"boolean"},"threshold":{"type":"number","description":"When the balance drops below this threshold, an auto top-up will be purchased.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.auto_topups.oneOf.0.items.[INDEX].threshold","typeLabel":"number"},"quantity":{"type":"number","minimum":1,"description":"Amount of credits to add per auto top-up.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.auto_topups.oneOf.0.items.[INDEX].quantity","typeLabel":"number"},"purchase_limit":{"description":"Optional limit on auto top-ups per window, by number of top-ups or amount charged.","type":"object","properties":{"interval":{"enum":["hour","day","week","month"],"type":"string","description":"The time interval for the purchase limit window.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.auto_topups.oneOf.0.items.[INDEX].purchase_limit.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","minimum":1,"default":1,"description":"Number of intervals in the purchase limit window.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.auto_topups.oneOf.0.items.[INDEX].purchase_limit.interval_count","typeLabel":"number"},"limit":{"type":"number","exclusiveMinimum":0,"description":"Maximum allowed within the interval: a number of auto top-ups when limit_type is count, or a total charge (e.g. 500 for $500, pre-tax) when limit_type is amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.auto_topups.oneOf.0.items.[INDEX].purchase_limit.limit","typeLabel":"number"},"limit_type":{"enum":["count","amount"],"type":"string","description":"What `limit` caps: the number of auto top-ups (`count`, default) or the total amount charged for them, in the customer's currency (`amount`).","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.auto_topups.oneOf.0.items.[INDEX].purchase_limit.limit_type","typeLabel":"enum\u003cstring>"}},"required":["interval","interval_count","limit"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.auto_topups.oneOf.0.items.[INDEX].purchase_limit","typeLabel":"object"},"invoice_mode":{"type":"boolean","description":"When true, auto top-up creates a send_invoice invoice instead of auto-charging.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.auto_topups.oneOf.0.items.[INDEX].invoice_mode","typeLabel":"boolean"}},"required":["feature_id","enabled","threshold","quantity"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.auto_topups.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"List of auto top-up configurations per feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.auto_topups.oneOf.0","typeLabel":"object[]"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.auto_topups.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.auto_topups","typeLabel":"object[] | null"},"spend_limits":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"enabled":{"type":"boolean","default":false,"description":"Whether the overage spend limit is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.spend_limits.oneOf.0.items.[INDEX].enabled","typeLabel":"boolean"},"feature_id":{"type":"string","description":"Optional feature ID this spend limit applies to.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.spend_limits.oneOf.0.items.[INDEX].feature_id","typeLabel":"string"},"limit_type":{"enum":["absolute","usage_percentage"],"type":"string","description":"How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.spend_limits.oneOf.0.items.[INDEX].limit_type","typeLabel":"enum\u003cstring>"},"overage_limit":{"type":"number","minimum":0,"description":"Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.spend_limits.oneOf.0.items.[INDEX].overage_limit","typeLabel":"number"},"skip_overage_billing":{"type":"boolean","description":"When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.spend_limits.oneOf.0.items.[INDEX].skip_overage_billing","typeLabel":"boolean"}},"required":["enabled"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.spend_limits.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"List of overage spend limits per feature (caps overage spend).","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.spend_limits.oneOf.0","typeLabel":"object[]"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.spend_limits.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.spend_limits","typeLabel":"object[] | null"},"usage_limits":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"The feature this usage limit applies to.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_limits.oneOf.0.items.[INDEX].feature_id","typeLabel":"string"},"enabled":{"type":"boolean","default":true,"description":"Whether this usage limit is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_limits.oneOf.0.items.[INDEX].enabled","typeLabel":"boolean"},"limit":{"type":"number","minimum":0,"description":"Maximum units allowed per interval.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_limits.oneOf.0.items.[INDEX].limit","typeLabel":"number"},"interval":{"enum":["day","week","month","year"],"type":"string","description":"Interval for the cap, aligned to the customer's billing cycle.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_limits.oneOf.0.items.[INDEX].interval","typeLabel":"enum\u003cstring>"},"anchor":{"enum":["billing_cycle","utc"],"type":"string","description":"Window alignment. 'billing_cycle' phases the interval to the customer's renewal time; 'utc' aligns to the UTC calendar.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_limits.oneOf.0.items.[INDEX].anchor","typeLabel":"enum\u003cstring>"},"filter":{"description":"When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.","type":"object","properties":{"properties":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_limits.oneOf.0.items.[INDEX].filter.properties.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_limits.oneOf.0.items.[INDEX].filter.properties","typeLabel":"object"}},"required":["properties"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_limits.oneOf.0.items.[INDEX].filter","typeLabel":"object"}},"required":["feature_id","enabled","limit","interval"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_limits.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"List of hard usage caps per feature (max units per interval).","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_limits.oneOf.0","typeLabel":"object[]"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_limits.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_limits","typeLabel":"object[] | null"},"usage_alerts":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"enabled":{"type":"boolean","default":true,"description":"Whether this usage alert is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_alerts.oneOf.0.items.[INDEX].enabled","typeLabel":"boolean"},"threshold":{"type":"number","description":"The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage. remaining and remaining_percentage accept negative values with basis balance, to alert once the balance is overdrawn.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_alerts.oneOf.0.items.[INDEX].threshold","typeLabel":"number"},"threshold_type":{"enum":["usage","usage_percentage","remaining","remaining_percentage"],"type":"string","description":"Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_alerts.oneOf.0.items.[INDEX].threshold_type","typeLabel":"enum\u003cstring>"},"basis":{"enum":["balance","included","recurring","usage_limit"],"type":"string","default":"balance","description":"What 100% means. balance: every grant on the feature. included: the plan allowance only. recurring: grants that reset. usage_limit: the cap of the usage limit with the same feature and filter.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_alerts.oneOf.0.items.[INDEX].basis","typeLabel":"enum\u003cstring>"},"feature_id":{"type":"string","description":"The feature ID this alert applies to.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_alerts.oneOf.0.items.[INDEX].feature_id","typeLabel":"string"},"filter":{"description":"Only valid with basis usage_limit. Points the alert at the usage limit carrying the same filter.","type":"object","properties":{"properties":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_alerts.oneOf.0.items.[INDEX].filter.properties.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_alerts.oneOf.0.items.[INDEX].filter.properties","typeLabel":"object"}},"required":["properties"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_alerts.oneOf.0.items.[INDEX].filter","typeLabel":"object"},"name":{"type":"string","description":"Optional user-defined label to distinguish multiple alerts on the same feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_alerts.oneOf.0.items.[INDEX].name","typeLabel":"string"}},"required":["enabled","threshold","threshold_type","basis"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_alerts.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"List of usage alert configurations per feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_alerts.oneOf.0","typeLabel":"object[]"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_alerts.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_alerts","typeLabel":"object[] | null"},"overage_allowed":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"The feature ID this overage allowed control applies to.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.overage_allowed.oneOf.0.items.[INDEX].feature_id","typeLabel":"string"},"enabled":{"type":"boolean","default":false,"description":"Whether overage is allowed for this feature.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.overage_allowed.oneOf.0.items.[INDEX].enabled","typeLabel":"boolean"}},"required":["feature_id","enabled"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.overage_allowed.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"List of overage allowed controls per feature. When enabled, usage can exceed balance.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.overage_allowed.oneOf.0","typeLabel":"object[]"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.overage_allowed.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0.overage_allowed","typeLabel":"object[] | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.0","typeLabel":"object"},{"type":"null","description":"Sparse previous billing_controls — only keys that changed. Null when unset; a null lane was unset before.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0.billing_controls","typeLabel":"object | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.0","typeLabel":"object"},{"type":"null","description":"Sparse map of scalar plan fields that changed, holding their previous values. Null when the plan is new.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.previous_attributes","typeLabel":"object | null"},"item_changes":{"description":"Feature items added to or removed from the plan.","default":[],"type":"array","items":{"type":"object","properties":{"action":{"description":"Whether the item was added to or removed from the plan.","type":"string","enum":["created","deleted"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].action","typeLabel":"enum\u003cstring>"},"feature_id":{"description":"The ID of the feature that was added or removed.","type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].feature_id","typeLabel":"string"},"item":{"description":"The plan item snapshot that was added or removed.","type":"object","properties":{"feature_id":{"type":"string","description":"The ID of the feature this item configures.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_id","typeLabel":"string"},"included":{"type":"number","description":"Number of free units included. For consumable features, balance resets to this number each interval.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.included","typeLabel":"number"},"unlimited":{"type":"boolean","description":"Whether the customer has unlimited access to this feature.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.unlimited","typeLabel":"boolean"},"reset":{"oneOf":[{"type":"object","description":"Reset configuration for consumable features. Null for non-consumable features like seats where usage persists across billing cycles.","required":["interval"],"properties":{"interval":{"enum":["one_off","minute","hour","day","week","month","quarter","semi_annual","year"],"type":"string","description":"The interval at which the feature balance resets (e.g. 'month', 'year'). For consumable features, usage resets to 0 and included units are restored.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.reset.oneOf.0.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","description":"Number of intervals between resets. Defaults to 1.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.reset.oneOf.0.interval_count","typeLabel":"number"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.reset.oneOf.0","typeLabel":"object"},{"type":"null","description":"Reset configuration for consumable features. Null for non-consumable features like seats where usage persists across billing cycles.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.reset.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.reset","typeLabel":"object | null"},"price":{"oneOf":[{"type":"object","description":"Pricing configuration for usage beyond included units. Null if feature is entirely free.","required":["interval","billing_units","billing_method","max_purchase"],"properties":{"interval":{"enum":["one_off","week","month","quarter","semi_annual","year"],"type":"string","description":"Billing interval for this price. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.price.oneOf.0.interval","typeLabel":"enum\u003cstring>"},"billing_units":{"type":"number","description":"Number of units per price increment. Usage is rounded UP to the nearest billing_units when billed (e.g. billing_units=100 means 101 usage rounds to 200).","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.price.oneOf.0.billing_units","typeLabel":"number"},"billing_method":{"enum":["prepaid","usage_based"],"type":"string","description":"'prepaid' for features like seats where customers pay upfront, 'usage_based' for pay-as-you-go after included usage.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.price.oneOf.0.billing_method","typeLabel":"enum\u003cstring>"},"max_purchase":{"oneOf":[{"type":"number","description":"Maximum units a customer can purchase beyond included. E.g. if included=100 and max_purchase=300, customer can use up to 400 total before usage is capped. Null for no limit.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.price.oneOf.0.max_purchase.oneOf.0","typeLabel":"number"},{"type":"null","description":"Maximum units a customer can purchase beyond included. E.g. if included=100 and max_purchase=300, customer can use up to 400 total before usage is capped. Null for no limit.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.price.oneOf.0.max_purchase.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.price.oneOf.0.max_purchase","typeLabel":"number | null"},"amount":{"type":"number","description":"Price per billing_units after included usage is consumed. Mutually exclusive with tiers.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.price.oneOf.0.amount","typeLabel":"number"},"additional_currencies":{"description":"Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers' (tiered prices carry per-currency amounts on each tier).","type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.price.oneOf.0.additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Price amount in this currency. Set explicitly per currency, not converted from the base amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.price.oneOf.0.additional_currencies.items.[INDEX].amount","typeLabel":"number"}},"required":["currency","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.price.oneOf.0.additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.price.oneOf.0.additional_currencies","typeLabel":"object[]"},"tiers":{"description":"Tiered pricing configuration. Each tier's 'to' INCLUDES the included amount. Either 'tiers' or 'amount' is required.","type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.price.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","const":"inf","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.price.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.price.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | string"},"amount":{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.price.oneOf.0.tiers.items.[INDEX].amount","typeLabel":"number"},"flat_amount":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.price.oneOf.0.tiers.items.[INDEX].flat_amount","typeLabel":"number"},"additional_currencies":{"type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.price.oneOf.0.tiers.items.[INDEX].additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Per-unit amount for this tier in this currency.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.price.oneOf.0.tiers.items.[INDEX].additional_currencies.items.[INDEX].amount","typeLabel":"number"},"flat_amount":{"type":"number","description":"Flat amount for this tier in this currency, if the tier uses one.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.price.oneOf.0.tiers.items.[INDEX].additional_currencies.items.[INDEX].flat_amount","typeLabel":"number"}},"required":["currency"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.price.oneOf.0.tiers.items.[INDEX].additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.price.oneOf.0.tiers.items.[INDEX].additional_currencies","typeLabel":"object[]"}},"required":["to","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.price.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.price.oneOf.0.tiers","typeLabel":"object[]"},"tier_behavior":{"enum":["graduated","volume"],"type":"string","description":"How tiers price usage. 'graduated' (default) charges each unit at the rate of the tier it falls in. 'volume' picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier's rate plus its flat_amount.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.price.oneOf.0.tier_behavior","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","description":"Number of intervals per billing cycle. Defaults to 1.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.price.oneOf.0.interval_count","typeLabel":"number"},"processors":{"description":"Payment processors this item price is connected to. Omitted when unset.","x-atmn-mapping":true,"type":"object","properties":{"stripe":{"oneOf":[{"type":"object","required":["price_id"],"properties":{"price_id":{"type":"string","description":"Stripe price ID. For prepaid with included > 0 this is the V2 price.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.price.oneOf.0.processors.stripe.oneOf.0.price_id","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.price.oneOf.0.processors.stripe.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.price.oneOf.0.processors.stripe.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.price.oneOf.0.processors.stripe","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.price.oneOf.0.processors","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.price.oneOf.0","typeLabel":"object"},{"type":"null","description":"Pricing configuration for usage beyond included units. Null if feature is entirely free.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.price.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.price","typeLabel":"object | null"},"threshold_billing":{"oneOf":[{"type":"object","description":"Bills this many feature units when outstanding overage reaches it.","required":["threshold"],"properties":{"threshold":{"type":"number","exclusiveMinimum":0,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.threshold_billing.oneOf.0.threshold","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.threshold_billing.oneOf.0","typeLabel":"object"},{"type":"null","description":"Bills this many feature units when outstanding overage reaches it.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.threshold_billing.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.threshold_billing","typeLabel":"object | null"},"feature":{"description":"The full feature object if expanded.","type":"object","properties":{"id":{"type":"string","description":"The ID of the feature, used to refer to it in other API calls like /track or /check.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature.id","typeLabel":"string"},"type":{"enum":["static","boolean","single_use","continuous_use","credit_system","ai_credit_system"],"type":"string","description":"The type of the feature","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature.type","typeLabel":"enum\u003cstring>"},"name":{"oneOf":[{"type":"string","description":"The name of the feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature.name.oneOf.0","typeLabel":"string"},{"type":"null","description":"The name of the feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature.name","typeLabel":"string | null"},"display":{"oneOf":[{"type":"object","description":"Singular and plural display names for the feature.","required":["singular","plural"],"properties":{"singular":{"type":"string","description":"The singular display name for the feature.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature.display.oneOf.0.singular","typeLabel":"string"},"plural":{"type":"string","description":"The plural display name for the feature.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature.display.oneOf.0.plural","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature.display.oneOf.0","typeLabel":"object"},{"type":"null","description":"Singular and plural display names for the feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature.display.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature.display","typeLabel":"object | null"},"credit_schema":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"metered_feature_id":{"type":"string","description":"The ID of the metered feature (should be a single_use feature).","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature.credit_schema.oneOf.0.items.[INDEX].metered_feature_id","typeLabel":"string"},"credit_cost":{"type":"number","description":"The credit cost of the metered feature.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature.credit_schema.oneOf.0.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["metered_feature_id","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature.credit_schema.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Credit cost schema for credit system features.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature.credit_schema.oneOf.0","typeLabel":"object[]"},{"type":"null","description":"Credit cost schema for credit system features.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature.credit_schema.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature.credit_schema","typeLabel":"object[] | null"},"archived":{"oneOf":[{"type":"boolean","description":"Whether or not the feature is archived.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature.archived.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether or not the feature is archived.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature.archived.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature.archived","typeLabel":"boolean | null"}},"required":["id","type"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature","typeLabel":"object"},"pooled":{"type":"boolean","default":false,"description":"Whether entity-level grants contribute to a shared customer balance.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.pooled","typeLabel":"boolean"},"display":{"description":"Display text for showing this item in pricing pages.","type":"object","properties":{"primary_text":{"type":"string","description":"Main display text (e.g. '$10' or '100 messages').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.display.primary_text","typeLabel":"string"},"secondary_text":{"type":"string","description":"Secondary display text (e.g. 'per month' or 'then $0.5 per 100').","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.display.secondary_text","typeLabel":"string"}},"required":["primary_text"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.display","typeLabel":"object"},"rollover":{"description":"Rollover configuration for unused units. If set, unused included units roll over to the next period.","type":"object","properties":{"max":{"oneOf":[{"type":"number","description":"Maximum rollover units. Null for unlimited rollover.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.rollover.max.oneOf.0","typeLabel":"number"},{"type":"null","description":"Maximum rollover units. Null for unlimited rollover.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.rollover.max.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.rollover.max","typeLabel":"number | null"},"expiry_duration_type":{"enum":["month","forever"],"type":"string","description":"When rolled over units expire.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.rollover.expiry_duration_type","typeLabel":"enum\u003cstring>"},"max_percentage":{"oneOf":[{"type":"number","description":"Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.rollover.max_percentage.oneOf.0","typeLabel":"number"},{"type":"null","description":"Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.rollover.max_percentage.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.rollover.max_percentage","typeLabel":"number | null"},"expiry_duration_length":{"type":"number","description":"Number of periods before expiry.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.rollover.expiry_duration_length","typeLabel":"number"}},"required":["max","expiry_duration_type"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.rollover","typeLabel":"object"},"expiry":{"oneOf":[{"type":"object","description":"Purchased units expire this long after each purchase. One-off prepaid consumable items only.","required":["duration","length"],"properties":{"duration":{"enum":["day","week","month","year"],"type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.expiry.oneOf.0.duration","typeLabel":"enum\u003cstring>"},"length":{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.expiry.oneOf.0.length","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.expiry.oneOf.0","typeLabel":"object"},{"type":"null","description":"Purchased units expire this long after each purchase. One-off prepaid consumable items only.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.expiry.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.expiry","typeLabel":"object | null"},"feature_override":{"description":"Overrides fields of this item's feature for customers on this plan (e.g. a credit system's credit_schema).","type":"object","properties":{"credit_schema":{"description":"For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.","type":"array","items":{"oneOf":[{"type":"object","required":["metered_feature_id","tier_behavior","tiers"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature that draws from this credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.metered_feature_id","typeLabel":"string"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.tiers","typeLabel":"object[]"},"billing_units":{"type":"number","exclusiveMinimum":0,"description":"Number of metered-feature units priced together. Defaults to one when omitted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.billing_units","typeLabel":"number"},"dimensions":{"description":"Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies.","type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"oneOf":[{"type":"object","required":["match","tier_behavior","tiers"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.match","typeLabel":"object"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers","typeLabel":"object[]"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["match","credit_cost"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.match","typeLabel":"object"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group when this dimension matches.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.credit_cost","typeLabel":"number"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions","typeLabel":"object"},"multipliers":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"object","properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.match","typeLabel":"object"},"factor":{"type":"number","exclusiveMinimum":0,"description":"Multiplies the matched rate. All matching multipliers stack.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.factor","typeLabel":"number"},"add":{"type":"number","description":"Added to the rate after every factor is applied, in credits per billing-unit group.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.add","typeLabel":"number"}},"required":["match"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties","typeLabel":"object"},"description":"Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["metered_feature_id","credit_cost"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature that draws from this credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.metered_feature_id","typeLabel":"string"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.credit_cost","typeLabel":"number"},"billing_units":{"type":"number","exclusiveMinimum":0,"description":"Number of metered-feature units priced together. Defaults to one when omitted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.billing_units","typeLabel":"number"},"dimensions":{"description":"Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies.","type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"oneOf":[{"type":"object","required":["match","tier_behavior","tiers"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.match","typeLabel":"object"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers","typeLabel":"object[]"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["match","credit_cost"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.match","typeLabel":"object"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group when this dimension matches.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.credit_cost","typeLabel":"number"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions","typeLabel":"object"},"multipliers":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"object","properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.match","typeLabel":"object"},"factor":{"type":"number","exclusiveMinimum":0,"description":"Multiplies the matched rate. All matching multipliers stack.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.factor","typeLabel":"number"},"add":{"type":"number","description":"Added to the rate after every factor is applied, in credits per billing-unit group.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.add","typeLabel":"number"}},"required":["match"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties","typeLabel":"object"},"description":"Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["metered_feature_id","excluded"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature to remove from the credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.2.metered_feature_id","typeLabel":"string"},"excluded":{"description":"Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.","type":"boolean","const":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.2.excluded","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.2","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.credit_schema","typeLabel":"object[]"},"markups":{"description":"For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.","type":"object","properties":{"default_markup":{"type":"number","minimum":-100,"description":"Default percentage markup for customers on this plan. Use -100 to make usage free.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.markups.default_markup","typeLabel":"number"},"provider_markups":{"oneOf":[{"type":"object","description":"Per-provider markup percentages for customers on this plan.","additionalProperties":{"type":"object","properties":{"markup":{"type":"number","minimum":-100,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.markups.provider_markups.oneOf.0.additionalProperties.markup","typeLabel":"number"}},"required":["markup"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.markups.provider_markups.oneOf.0.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.markups.provider_markups.oneOf.0","typeLabel":"object"},{"type":"null","description":"Per-provider markup percentages for customers on this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.markups.provider_markups.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.markups.provider_markups","typeLabel":"object | null"},"model_markups":{"oneOf":[{"type":"object","description":"Per-model markup overrides for customers on this plan.","additionalProperties":{"type":"object","properties":{"markup":{"type":"number","minimum":-100,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.markups.model_markups.oneOf.0.additionalProperties.markup","typeLabel":"number"},"input_cost":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.markups.model_markups.oneOf.0.additionalProperties.input_cost","typeLabel":"number"},"output_cost":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.markups.model_markups.oneOf.0.additionalProperties.output_cost","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.markups.model_markups.oneOf.0.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.markups.model_markups.oneOf.0","typeLabel":"object"},{"type":"null","description":"Per-model markup overrides for customers on this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.markups.model_markups.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.markups.model_markups","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override.markups","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item.feature_override","typeLabel":"object"}},"required":["feature_id","included","unlimited","reset","price"],"additionalProperties":false,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX].item","typeLabel":"object"}},"required":["action","feature_id","item"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.item_changes","typeLabel":"object[]"},"plan":{"description":"The plan after the change. Omitted unless the caller expands it.","type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the plan.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.id","typeLabel":"string"},"name":{"type":"string","description":"Display name of the plan.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.name","typeLabel":"string"},"description":{"oneOf":[{"type":"string","description":"Optional description of the plan.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.description.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional description of the plan.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.description.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.description","typeLabel":"string | null"},"group":{"oneOf":[{"type":"string","description":"Group identifier for organizing related plans. Plans in the same group are mutually exclusive.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.group.oneOf.0","typeLabel":"string"},{"type":"null","description":"Group identifier for organizing related plans. Plans in the same group are mutually exclusive.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.group.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.group","typeLabel":"string | null"},"version":{"type":"number","description":"Version number of the plan. Incremented when plan configuration changes.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.version","typeLabel":"number"},"add_on":{"type":"boolean","description":"Whether this is an add-on plan that can be attached alongside a main plan.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.add_on","typeLabel":"boolean"},"auto_enable":{"type":"boolean","description":"If true, this plan is automatically attached when a customer is created. Used for free plans.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.auto_enable","typeLabel":"boolean"},"price":{"oneOf":[{"type":"object","description":"Base recurring price for the plan. Null for free plans or usage-only plans.","required":["amount","interval"],"properties":{"amount":{"type":"number","description":"Base price amount for the plan, in major currency units (e.g. dollars).","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.price.oneOf.0.amount","typeLabel":"number"},"interval":{"enum":["one_off","week","month","quarter","semi_annual","year"],"type":"string","description":"Billing interval (e.g. 'month', 'year').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.price.oneOf.0.interval","typeLabel":"enum\u003cstring>"},"additional_currencies":{"description":"Base price amounts in additional currencies. The base 'amount' is in the org's default currency.","type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.price.oneOf.0.additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Price amount in this currency. Set explicitly per currency, not converted from the base amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.price.oneOf.0.additional_currencies.items.[INDEX].amount","typeLabel":"number"}},"required":["currency","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.price.oneOf.0.additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.price.oneOf.0.additional_currencies","typeLabel":"object[]"},"interval_count":{"type":"number","description":"Number of intervals per billing cycle. Defaults to 1.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.price.oneOf.0.interval_count","typeLabel":"number"},"display":{"description":"Display text for showing this price in pricing pages.","type":"object","properties":{"primary_text":{"type":"string","description":"Main display text (e.g. '$10' or '100 messages').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.price.oneOf.0.display.primary_text","typeLabel":"string"},"secondary_text":{"type":"string","description":"Secondary display text (e.g. 'per month' or 'then $0.5 per 100').","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.price.oneOf.0.display.secondary_text","typeLabel":"string"}},"required":["primary_text"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.price.oneOf.0.display","typeLabel":"object"},"processors":{"description":"Payment processors this base price is connected to. Omitted when unset.","x-atmn-mapping":true,"type":"object","properties":{"stripe":{"oneOf":[{"type":"object","required":["price_id"],"properties":{"price_id":{"type":"string","description":"Stripe price ID. For prepaid with included > 0 this is the V2 price.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.price.oneOf.0.processors.stripe.oneOf.0.price_id","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.price.oneOf.0.processors.stripe.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.price.oneOf.0.processors.stripe.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.price.oneOf.0.processors.stripe","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.price.oneOf.0.processors","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.price.oneOf.0","typeLabel":"object"},{"type":"null","description":"Base recurring price for the plan. Null for free plans or usage-only plans.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.price.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.price","typeLabel":"object | null"},"items":{"description":"Feature configurations included in this plan. Each item defines included units, pricing, and reset behavior for a feature.","type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"The ID of the feature this item configures.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_id","typeLabel":"string"},"included":{"type":"number","description":"Number of free units included. For consumable features, balance resets to this number each interval.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].included","typeLabel":"number"},"unlimited":{"type":"boolean","description":"Whether the customer has unlimited access to this feature.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].unlimited","typeLabel":"boolean"},"reset":{"oneOf":[{"type":"object","description":"Reset configuration for consumable features. Null for non-consumable features like seats where usage persists across billing cycles.","required":["interval"],"properties":{"interval":{"enum":["one_off","minute","hour","day","week","month","quarter","semi_annual","year"],"type":"string","description":"The interval at which the feature balance resets (e.g. 'month', 'year'). For consumable features, usage resets to 0 and included units are restored.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].reset.oneOf.0.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","description":"Number of intervals between resets. Defaults to 1.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].reset.oneOf.0.interval_count","typeLabel":"number"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].reset.oneOf.0","typeLabel":"object"},{"type":"null","description":"Reset configuration for consumable features. Null for non-consumable features like seats where usage persists across billing cycles.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].reset.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].reset","typeLabel":"object | null"},"price":{"oneOf":[{"type":"object","description":"Pricing configuration for usage beyond included units. Null if feature is entirely free.","required":["interval","billing_units","billing_method","max_purchase"],"properties":{"interval":{"enum":["one_off","week","month","quarter","semi_annual","year"],"type":"string","description":"Billing interval for this price. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].price.oneOf.0.interval","typeLabel":"enum\u003cstring>"},"billing_units":{"type":"number","description":"Number of units per price increment. Usage is rounded UP to the nearest billing_units when billed (e.g. billing_units=100 means 101 usage rounds to 200).","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].price.oneOf.0.billing_units","typeLabel":"number"},"billing_method":{"enum":["prepaid","usage_based"],"type":"string","description":"'prepaid' for features like seats where customers pay upfront, 'usage_based' for pay-as-you-go after included usage.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].price.oneOf.0.billing_method","typeLabel":"enum\u003cstring>"},"max_purchase":{"oneOf":[{"type":"number","description":"Maximum units a customer can purchase beyond included. E.g. if included=100 and max_purchase=300, customer can use up to 400 total before usage is capped. Null for no limit.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].price.oneOf.0.max_purchase.oneOf.0","typeLabel":"number"},{"type":"null","description":"Maximum units a customer can purchase beyond included. E.g. if included=100 and max_purchase=300, customer can use up to 400 total before usage is capped. Null for no limit.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].price.oneOf.0.max_purchase.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].price.oneOf.0.max_purchase","typeLabel":"number | null"},"amount":{"type":"number","description":"Price per billing_units after included usage is consumed. Mutually exclusive with tiers.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].price.oneOf.0.amount","typeLabel":"number"},"additional_currencies":{"description":"Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers' (tiered prices carry per-currency amounts on each tier).","type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].price.oneOf.0.additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Price amount in this currency. Set explicitly per currency, not converted from the base amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].price.oneOf.0.additional_currencies.items.[INDEX].amount","typeLabel":"number"}},"required":["currency","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].price.oneOf.0.additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].price.oneOf.0.additional_currencies","typeLabel":"object[]"},"tiers":{"description":"Tiered pricing configuration. Each tier's 'to' INCLUDES the included amount. Either 'tiers' or 'amount' is required.","type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].price.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","const":"inf","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].price.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].price.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | string"},"amount":{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].price.oneOf.0.tiers.items.[INDEX].amount","typeLabel":"number"},"flat_amount":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].price.oneOf.0.tiers.items.[INDEX].flat_amount","typeLabel":"number"},"additional_currencies":{"type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].price.oneOf.0.tiers.items.[INDEX].additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Per-unit amount for this tier in this currency.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].price.oneOf.0.tiers.items.[INDEX].additional_currencies.items.[INDEX].amount","typeLabel":"number"},"flat_amount":{"type":"number","description":"Flat amount for this tier in this currency, if the tier uses one.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].price.oneOf.0.tiers.items.[INDEX].additional_currencies.items.[INDEX].flat_amount","typeLabel":"number"}},"required":["currency"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].price.oneOf.0.tiers.items.[INDEX].additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].price.oneOf.0.tiers.items.[INDEX].additional_currencies","typeLabel":"object[]"}},"required":["to","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].price.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].price.oneOf.0.tiers","typeLabel":"object[]"},"tier_behavior":{"enum":["graduated","volume"],"type":"string","description":"How tiers price usage. 'graduated' (default) charges each unit at the rate of the tier it falls in. 'volume' picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier's rate plus its flat_amount.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].price.oneOf.0.tier_behavior","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","description":"Number of intervals per billing cycle. Defaults to 1.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].price.oneOf.0.interval_count","typeLabel":"number"},"processors":{"description":"Payment processors this item price is connected to. Omitted when unset.","x-atmn-mapping":true,"type":"object","properties":{"stripe":{"oneOf":[{"type":"object","required":["price_id"],"properties":{"price_id":{"type":"string","description":"Stripe price ID. For prepaid with included > 0 this is the V2 price.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].price.oneOf.0.processors.stripe.oneOf.0.price_id","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].price.oneOf.0.processors.stripe.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].price.oneOf.0.processors.stripe.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].price.oneOf.0.processors.stripe","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].price.oneOf.0.processors","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].price.oneOf.0","typeLabel":"object"},{"type":"null","description":"Pricing configuration for usage beyond included units. Null if feature is entirely free.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].price.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].price","typeLabel":"object | null"},"threshold_billing":{"oneOf":[{"type":"object","description":"Bills this many feature units when outstanding overage reaches it.","required":["threshold"],"properties":{"threshold":{"type":"number","exclusiveMinimum":0,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].threshold_billing.oneOf.0.threshold","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].threshold_billing.oneOf.0","typeLabel":"object"},{"type":"null","description":"Bills this many feature units when outstanding overage reaches it.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].threshold_billing.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].threshold_billing","typeLabel":"object | null"},"feature":{"description":"The full feature object if expanded.","type":"object","properties":{"id":{"type":"string","description":"The ID of the feature, used to refer to it in other API calls like /track or /check.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature.id","typeLabel":"string"},"type":{"enum":["static","boolean","single_use","continuous_use","credit_system","ai_credit_system"],"type":"string","description":"The type of the feature","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature.type","typeLabel":"enum\u003cstring>"},"name":{"oneOf":[{"type":"string","description":"The name of the feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature.name.oneOf.0","typeLabel":"string"},{"type":"null","description":"The name of the feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature.name","typeLabel":"string | null"},"display":{"oneOf":[{"type":"object","description":"Singular and plural display names for the feature.","required":["singular","plural"],"properties":{"singular":{"type":"string","description":"The singular display name for the feature.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature.display.oneOf.0.singular","typeLabel":"string"},"plural":{"type":"string","description":"The plural display name for the feature.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature.display.oneOf.0.plural","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature.display.oneOf.0","typeLabel":"object"},{"type":"null","description":"Singular and plural display names for the feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature.display.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature.display","typeLabel":"object | null"},"credit_schema":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"metered_feature_id":{"type":"string","description":"The ID of the metered feature (should be a single_use feature).","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature.credit_schema.oneOf.0.items.[INDEX].metered_feature_id","typeLabel":"string"},"credit_cost":{"type":"number","description":"The credit cost of the metered feature.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature.credit_schema.oneOf.0.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["metered_feature_id","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature.credit_schema.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Credit cost schema for credit system features.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature.credit_schema.oneOf.0","typeLabel":"object[]"},{"type":"null","description":"Credit cost schema for credit system features.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature.credit_schema.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature.credit_schema","typeLabel":"object[] | null"},"archived":{"oneOf":[{"type":"boolean","description":"Whether or not the feature is archived.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature.archived.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether or not the feature is archived.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature.archived.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature.archived","typeLabel":"boolean | null"}},"required":["id","type"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature","typeLabel":"object"},"pooled":{"type":"boolean","default":false,"description":"Whether entity-level grants contribute to a shared customer balance.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].pooled","typeLabel":"boolean"},"display":{"description":"Display text for showing this item in pricing pages.","type":"object","properties":{"primary_text":{"type":"string","description":"Main display text (e.g. '$10' or '100 messages').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].display.primary_text","typeLabel":"string"},"secondary_text":{"type":"string","description":"Secondary display text (e.g. 'per month' or 'then $0.5 per 100').","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].display.secondary_text","typeLabel":"string"}},"required":["primary_text"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].display","typeLabel":"object"},"rollover":{"description":"Rollover configuration for unused units. If set, unused included units roll over to the next period.","type":"object","properties":{"max":{"oneOf":[{"type":"number","description":"Maximum rollover units. Null for unlimited rollover.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].rollover.max.oneOf.0","typeLabel":"number"},{"type":"null","description":"Maximum rollover units. Null for unlimited rollover.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].rollover.max.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].rollover.max","typeLabel":"number | null"},"expiry_duration_type":{"enum":["month","forever"],"type":"string","description":"When rolled over units expire.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].rollover.expiry_duration_type","typeLabel":"enum\u003cstring>"},"max_percentage":{"oneOf":[{"type":"number","description":"Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].rollover.max_percentage.oneOf.0","typeLabel":"number"},{"type":"null","description":"Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].rollover.max_percentage.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].rollover.max_percentage","typeLabel":"number | null"},"expiry_duration_length":{"type":"number","description":"Number of periods before expiry.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].rollover.expiry_duration_length","typeLabel":"number"}},"required":["max","expiry_duration_type"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].rollover","typeLabel":"object"},"expiry":{"oneOf":[{"type":"object","description":"Purchased units expire this long after each purchase. One-off prepaid consumable items only.","required":["duration","length"],"properties":{"duration":{"enum":["day","week","month","year"],"type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].expiry.oneOf.0.duration","typeLabel":"enum\u003cstring>"},"length":{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].expiry.oneOf.0.length","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].expiry.oneOf.0","typeLabel":"object"},{"type":"null","description":"Purchased units expire this long after each purchase. One-off prepaid consumable items only.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].expiry.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].expiry","typeLabel":"object | null"},"feature_override":{"description":"Overrides fields of this item's feature for customers on this plan (e.g. a credit system's credit_schema).","type":"object","properties":{"credit_schema":{"description":"For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.","type":"array","items":{"oneOf":[{"type":"object","required":["metered_feature_id","tier_behavior","tiers"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature that draws from this credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.metered_feature_id","typeLabel":"string"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers","typeLabel":"object[]"},"billing_units":{"type":"number","exclusiveMinimum":0,"description":"Number of metered-feature units priced together. Defaults to one when omitted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.billing_units","typeLabel":"number"},"dimensions":{"description":"Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies.","type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"oneOf":[{"type":"object","required":["match","tier_behavior","tiers"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.match","typeLabel":"object"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers","typeLabel":"object[]"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["match","credit_cost"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.match","typeLabel":"object"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group when this dimension matches.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.credit_cost","typeLabel":"number"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions","typeLabel":"object"},"multipliers":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"object","properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.match","typeLabel":"object"},"factor":{"type":"number","exclusiveMinimum":0,"description":"Multiplies the matched rate. All matching multipliers stack.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.factor","typeLabel":"number"},"add":{"type":"number","description":"Added to the rate after every factor is applied, in credits per billing-unit group.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.add","typeLabel":"number"}},"required":["match"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties","typeLabel":"object"},"description":"Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["metered_feature_id","credit_cost"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature that draws from this credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.metered_feature_id","typeLabel":"string"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.credit_cost","typeLabel":"number"},"billing_units":{"type":"number","exclusiveMinimum":0,"description":"Number of metered-feature units priced together. Defaults to one when omitted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.billing_units","typeLabel":"number"},"dimensions":{"description":"Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies.","type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"oneOf":[{"type":"object","required":["match","tier_behavior","tiers"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.match","typeLabel":"object"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers","typeLabel":"object[]"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["match","credit_cost"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.match","typeLabel":"object"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group when this dimension matches.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.credit_cost","typeLabel":"number"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions","typeLabel":"object"},"multipliers":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"object","properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.match","typeLabel":"object"},"factor":{"type":"number","exclusiveMinimum":0,"description":"Multiplies the matched rate. All matching multipliers stack.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.factor","typeLabel":"number"},"add":{"type":"number","description":"Added to the rate after every factor is applied, in credits per billing-unit group.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.add","typeLabel":"number"}},"required":["match"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties","typeLabel":"object"},"description":"Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["metered_feature_id","excluded"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature to remove from the credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2.metered_feature_id","typeLabel":"string"},"excluded":{"description":"Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.","type":"boolean","const":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2.excluded","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.credit_schema","typeLabel":"object[]"},"markups":{"description":"For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.","type":"object","properties":{"default_markup":{"type":"number","minimum":-100,"description":"Default percentage markup for customers on this plan. Use -100 to make usage free.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.markups.default_markup","typeLabel":"number"},"provider_markups":{"oneOf":[{"type":"object","description":"Per-provider markup percentages for customers on this plan.","additionalProperties":{"type":"object","properties":{"markup":{"type":"number","minimum":-100,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0.additionalProperties.markup","typeLabel":"number"}},"required":["markup"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0","typeLabel":"object"},{"type":"null","description":"Per-provider markup percentages for customers on this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.markups.provider_markups.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.markups.provider_markups","typeLabel":"object | null"},"model_markups":{"oneOf":[{"type":"object","description":"Per-model markup overrides for customers on this plan.","additionalProperties":{"type":"object","properties":{"markup":{"type":"number","minimum":-100,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.markup","typeLabel":"number"},"input_cost":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.input_cost","typeLabel":"number"},"output_cost":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.output_cost","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.markups.model_markups.oneOf.0","typeLabel":"object"},{"type":"null","description":"Per-model markup overrides for customers on this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.markups.model_markups.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.markups.model_markups","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override.markups","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX].feature_override","typeLabel":"object"}},"required":["feature_id","included","unlimited","reset","price"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.\\items","typeLabel":"object[]"},"created_at":{"type":"number","description":"Unix timestamp (ms) when the plan was created.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.created_at","typeLabel":"number"},"env":{"enum":["sandbox","live"],"type":"string","description":"Environment this plan belongs to ('sandbox' or 'live').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.env","typeLabel":"enum\u003cstring>"},"archived":{"type":"boolean","description":"Whether the plan is archived. Archived plans cannot be attached to new customers.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.archived","typeLabel":"boolean"},"config":{"description":"Miscellaneous plan-level configuration flags.","type":"object","properties":{"ignore_past_due":{"type":"boolean","default":false,"description":"If true, entitlements attached to this plan will still reset on schedule even when the customer's product is in a past_due state.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.config.ignore_past_due","typeLabel":"boolean"},"anchor_to_month_start":{"type":"boolean","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.config.anchor_to_month_start","typeLabel":"boolean"}},"required":["ignore_past_due"],"additionalProperties":false,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.config","typeLabel":"object"},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.metadata.additionalProperties","typeLabel":"any"},"description":"Arbitrary key-value metadata defined by you for your own use. Shared across all versions of the plan.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.metadata","typeLabel":"object"},"base_variant_id":{"oneOf":[{"type":"string","description":"Deprecated. Use variant_details.base_plan_id instead. If this is a variant, the ID of the base plan it was created from.","deprecated":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.base_variant_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Deprecated. Use variant_details.base_plan_id instead. If this is a variant, the ID of the base plan it was created from.","deprecated":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.base_variant_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.base_variant_id","typeLabel":"string | null"},"version_slug":{"oneOf":[{"type":"string","description":"User-facing version identity. Defaults to v{n} when the version is minted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.version_slug.oneOf.0","typeLabel":"string"},{"type":"null","description":"User-facing version identity. Defaults to v{n} when the version is minted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.version_slug.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.version_slug","typeLabel":"string | null"},"active":{"type":"boolean","description":"Whether this is the active version of the plan. At most one version is active.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.active","typeLabel":"boolean"},"processors":{"description":"Payment processors this plan is connected to. Omitted when unset.","x-atmn-mapping":true,"type":"object","properties":{"stripe":{"oneOf":[{"type":"object","required":["product_id"],"properties":{"product_id":{"type":"string","description":"Stripe product ID this plan is billed under.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.processors.stripe.oneOf.0.product_id","typeLabel":"string"},"additional_product_ids":{"type":"array","items":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.processors.stripe.oneOf.0.additional_product_ids.items.[INDEX]","typeLabel":"string"},"description":"Extra Stripe product IDs aliased to this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.processors.stripe.oneOf.0.additional_product_ids","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.processors.stripe.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.processors.stripe.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.processors.stripe","typeLabel":"object | null"},"revenuecat":{"oneOf":[{"type":"object","required":["products"],"properties":{"products":{"description":"Every RevenueCat product that maps to this plan. Replaces the current set.","type":"array","items":{"type":"object","properties":{"product_id":{"type":"string","description":"RevenueCat product ID that grants this plan when purchased.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.processors.revenuecat.oneOf.0.products.items.[INDEX].product_id","typeLabel":"string"},"feature_quantities":{"description":"Prepaid quantities granted when this specific RevenueCat product is purchased, in feature units.","type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.processors.revenuecat.oneOf.0.products.items.[INDEX].feature_quantities.items.[INDEX].feature_id","typeLabel":"string"},"quantity":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.processors.revenuecat.oneOf.0.products.items.[INDEX].feature_quantities.items.[INDEX].quantity","typeLabel":"number"}},"required":["feature_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.processors.revenuecat.oneOf.0.products.items.[INDEX].feature_quantities.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.processors.revenuecat.oneOf.0.products.items.[INDEX].feature_quantities","typeLabel":"object[]"}},"required":["product_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.processors.revenuecat.oneOf.0.products.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.processors.revenuecat.oneOf.0.products","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.processors.revenuecat.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.processors.revenuecat.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.processors.revenuecat","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.processors","typeLabel":"object"},"free_trial":{"description":"Free trial configuration. If set, new customers can try this plan before being charged.","type":"object","properties":{"duration_length":{"type":"number","description":"Number of duration_type periods the trial lasts.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.free_trial.duration_length","typeLabel":"number"},"duration_type":{"enum":["day","month","year"],"type":"string","description":"Unit of time for the trial duration ('day', 'month', 'year').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.free_trial.duration_type","typeLabel":"enum\u003cstring>"},"card_required":{"type":"boolean","description":"Whether a payment method is required to start the trial. If true, customer will be charged after trial ends.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.free_trial.card_required","typeLabel":"boolean"},"on_end":{"oneOf":[{"type":"string","description":"Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.","enum":["bill","revert"],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.free_trial.on_end.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.free_trial.on_end.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.free_trial.on_end","typeLabel":"enum\u003cstring> | null"}},"required":["duration_length","duration_type","card_required"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.free_trial","typeLabel":"object"},"billing_controls":{"description":"Plan-level billing controls used as customer defaults.","type":"object","properties":{"auto_topups":{"description":"List of auto top-up configurations per feature.","type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"The ID of the feature (credit balance) to auto top-up.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.auto_topups.items.[INDEX].feature_id","typeLabel":"string"},"enabled":{"type":"boolean","default":false,"description":"Whether auto top-up is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.auto_topups.items.[INDEX].enabled","typeLabel":"boolean"},"threshold":{"type":"number","description":"When the balance drops below this threshold, an auto top-up will be purchased.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.auto_topups.items.[INDEX].threshold","typeLabel":"number"},"quantity":{"type":"number","minimum":1,"description":"Amount of credits to add per auto top-up.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.auto_topups.items.[INDEX].quantity","typeLabel":"number"},"purchase_limit":{"description":"Optional limit on auto top-ups per window, by number of top-ups or amount charged.","type":"object","properties":{"interval":{"enum":["hour","day","week","month"],"type":"string","description":"The time interval for the purchase limit window.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.auto_topups.items.[INDEX].purchase_limit.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","minimum":1,"default":1,"description":"Number of intervals in the purchase limit window.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.auto_topups.items.[INDEX].purchase_limit.interval_count","typeLabel":"number"},"limit":{"type":"number","exclusiveMinimum":0,"description":"Maximum allowed within the interval: a number of auto top-ups when limit_type is count, or a total charge (e.g. 500 for $500, pre-tax) when limit_type is amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.auto_topups.items.[INDEX].purchase_limit.limit","typeLabel":"number"},"limit_type":{"enum":["count","amount"],"type":"string","description":"What `limit` caps: the number of auto top-ups (`count`, default) or the total amount charged for them, in the customer's currency (`amount`).","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.auto_topups.items.[INDEX].purchase_limit.limit_type","typeLabel":"enum\u003cstring>"}},"required":["interval","interval_count","limit"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.auto_topups.items.[INDEX].purchase_limit","typeLabel":"object"},"invoice_mode":{"type":"boolean","description":"When true, auto top-up creates a send_invoice invoice instead of auto-charging.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.auto_topups.items.[INDEX].invoice_mode","typeLabel":"boolean"}},"required":["feature_id","enabled","threshold","quantity"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.auto_topups.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.auto_topups","typeLabel":"object[]"},"spend_limits":{"description":"List of overage spend limits per feature (caps overage spend).","type":"array","items":{"type":"object","properties":{"enabled":{"type":"boolean","default":false,"description":"Whether the overage spend limit is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.spend_limits.items.[INDEX].enabled","typeLabel":"boolean"},"feature_id":{"type":"string","description":"Optional feature ID this spend limit applies to.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.spend_limits.items.[INDEX].feature_id","typeLabel":"string"},"limit_type":{"enum":["absolute","usage_percentage"],"type":"string","description":"How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.spend_limits.items.[INDEX].limit_type","typeLabel":"enum\u003cstring>"},"overage_limit":{"type":"number","minimum":0,"description":"Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.spend_limits.items.[INDEX].overage_limit","typeLabel":"number"},"skip_overage_billing":{"type":"boolean","description":"When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.spend_limits.items.[INDEX].skip_overage_billing","typeLabel":"boolean"}},"required":["enabled"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.spend_limits.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.spend_limits","typeLabel":"object[]"},"usage_limits":{"description":"List of hard usage caps per feature (max units per interval).","type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"The feature this usage limit applies to.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.usage_limits.items.[INDEX].feature_id","typeLabel":"string"},"enabled":{"type":"boolean","default":true,"description":"Whether this usage limit is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.usage_limits.items.[INDEX].enabled","typeLabel":"boolean"},"limit":{"type":"number","minimum":0,"description":"Maximum units allowed per interval.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.usage_limits.items.[INDEX].limit","typeLabel":"number"},"interval":{"enum":["day","week","month","year"],"type":"string","description":"Interval for the cap, aligned to the customer's billing cycle.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.usage_limits.items.[INDEX].interval","typeLabel":"enum\u003cstring>"},"anchor":{"enum":["billing_cycle","utc"],"type":"string","description":"Window alignment. 'billing_cycle' phases the interval to the customer's renewal time; 'utc' aligns to the UTC calendar.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.usage_limits.items.[INDEX].anchor","typeLabel":"enum\u003cstring>"},"filter":{"description":"When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.","type":"object","properties":{"properties":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.usage_limits.items.[INDEX].filter.properties.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.usage_limits.items.[INDEX].filter.properties","typeLabel":"object"}},"required":["properties"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.usage_limits.items.[INDEX].filter","typeLabel":"object"}},"required":["feature_id","enabled","limit","interval"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.usage_limits.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.usage_limits","typeLabel":"object[]"},"usage_alerts":{"description":"List of usage alert configurations per feature.","type":"array","items":{"type":"object","properties":{"enabled":{"type":"boolean","default":true,"description":"Whether this usage alert is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.usage_alerts.items.[INDEX].enabled","typeLabel":"boolean"},"threshold":{"type":"number","description":"The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage. remaining and remaining_percentage accept negative values with basis balance, to alert once the balance is overdrawn.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.usage_alerts.items.[INDEX].threshold","typeLabel":"number"},"threshold_type":{"enum":["usage","usage_percentage","remaining","remaining_percentage"],"type":"string","description":"Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.usage_alerts.items.[INDEX].threshold_type","typeLabel":"enum\u003cstring>"},"basis":{"enum":["balance","included","recurring","usage_limit"],"type":"string","default":"balance","description":"What 100% means. balance: every grant on the feature. included: the plan allowance only. recurring: grants that reset. usage_limit: the cap of the usage limit with the same feature and filter.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.usage_alerts.items.[INDEX].basis","typeLabel":"enum\u003cstring>"},"feature_id":{"type":"string","description":"The feature ID this alert applies to.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.usage_alerts.items.[INDEX].feature_id","typeLabel":"string"},"filter":{"description":"Only valid with basis usage_limit. Points the alert at the usage limit carrying the same filter.","type":"object","properties":{"properties":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.usage_alerts.items.[INDEX].filter.properties.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.usage_alerts.items.[INDEX].filter.properties","typeLabel":"object"}},"required":["properties"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.usage_alerts.items.[INDEX].filter","typeLabel":"object"},"name":{"type":"string","description":"Optional user-defined label to distinguish multiple alerts on the same feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.usage_alerts.items.[INDEX].name","typeLabel":"string"}},"required":["enabled","threshold","threshold_type","basis"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.usage_alerts.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.usage_alerts","typeLabel":"object[]"},"overage_allowed":{"description":"List of overage allowed controls per feature. When enabled, usage can exceed balance.","type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"The feature ID this overage allowed control applies to.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.overage_allowed.items.[INDEX].feature_id","typeLabel":"string"},"enabled":{"type":"boolean","default":false,"description":"Whether overage is allowed for this feature.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.overage_allowed.items.[INDEX].enabled","typeLabel":"boolean"}},"required":["feature_id","enabled"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.overage_allowed.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls.overage_allowed","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.billing_controls","typeLabel":"object"},"customer_eligibility":{"type":"object","properties":{"attach_action":{"enum":["activate","upgrade","downgrade","none","purchase"],"type":"string","description":"The action that would occur if this plan were attached to the customer.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.customer_eligibility.attach_action","typeLabel":"enum\u003cstring>"},"trial_available":{"type":"boolean","description":"Whether the trial on this plan is available to this customer. For example, if the customer used the trial in the past, this will be false.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.customer_eligibility.trial_available","typeLabel":"boolean"},"status":{"enum":["active","scheduled"],"type":"string","description":"The customer's current status with this plan. 'active' if attached, 'scheduled' if pending activation.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.customer_eligibility.status","typeLabel":"enum\u003cstring>"},"canceling":{"type":"boolean","description":"Whether the customer's active instance of this plan is set to cancel.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.customer_eligibility.canceling","typeLabel":"boolean"},"trialing":{"type":"boolean","description":"Whether the customer is currently on a free trial of this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.customer_eligibility.trialing","typeLabel":"boolean"}},"required":["attach_action"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.customer_eligibility","typeLabel":"object"},"variant_details":{"description":"Details about how this variant relates to its latest base plan.","type":"object","properties":{"base_plan_id":{"type":"string","description":"The ID of the base plan this variant was derived from.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.base_plan_id","typeLabel":"string"},"customize":{"description":"The customization that transforms the base plan into this variant.","type":"object","properties":{"price":{"oneOf":[{"type":"object","title":"BasePrice","description":"Override the base price of the plan. Pass null to remove the base price.","required":["amount","interval"],"properties":{"amount":{"type":"number","description":"Base price amount for the plan, in major currency units (e.g. dollars).","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.price.oneOf.0.amount","typeLabel":"number"},"interval":{"enum":["one_off","week","month","quarter","semi_annual","year"],"type":"string","description":"Billing interval (e.g. 'month', 'year').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.price.oneOf.0.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.price.oneOf.0.interval_count","typeLabel":"number"},"additional_currencies":{"description":"Base price amounts in additional currencies. The base 'amount' is in the org's default currency.","type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.price.oneOf.0.additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Price amount in this currency. Set explicitly per currency, not converted from the base amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.price.oneOf.0.additional_currencies.items.[INDEX].amount","typeLabel":"number"}},"required":["currency","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.price.oneOf.0.additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.price.oneOf.0.additional_currencies","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.price.oneOf.0","typeLabel":"BasePrice · object"},{"type":"null","description":"Override the base price of the plan. Pass null to remove the base price.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.price.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.price","typeLabel":"BasePrice · object | null"},"add_items":{"description":"Items to add to the plan.","type":"array","items":{"title":"PlanItem","description":"Configuration for a feature item in a plan, including usage limits, pricing, and rollover settings.","type":"object","properties":{"feature_id":{"type":"string","description":"The ID of the feature to configure.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_id","typeLabel":"string"},"threshold_billing":{"oneOf":[{"type":"object","description":"Bills this many feature units when outstanding overage reaches it.","required":["threshold"],"properties":{"threshold":{"type":"number","exclusiveMinimum":0,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].threshold_billing.oneOf.0.threshold","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].threshold_billing.oneOf.0","typeLabel":"object"},{"type":"null","description":"Bills this many feature units when outstanding overage reaches it.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].threshold_billing.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].threshold_billing","typeLabel":"object | null"},"included":{"type":"number","maximum":10000000000000,"description":"Number of free units included. Balance resets to this each interval for consumable features.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].included","typeLabel":"number"},"unlimited":{"type":"boolean","description":"If true, customer has unlimited access to this feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].unlimited","typeLabel":"boolean"},"pooled":{"type":"boolean","default":false,"description":"Whether entity-level grants contribute to a shared customer balance.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].pooled","typeLabel":"boolean"},"reset":{"description":"Reset configuration for consumable features. Omit for non-consumable features like seats.","type":"object","properties":{"interval":{"enum":["one_off","minute","hour","day","week","month","quarter","semi_annual","year"],"type":"string","description":"Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].reset.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].reset.interval_count","typeLabel":"number"}},"required":["interval"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].reset","typeLabel":"object"},"price":{"description":"Pricing for usage beyond included units. Omit for free features.","type":"object","properties":{"interval":{"enum":["one_off","week","month","quarter","semi_annual","year"],"type":"string","description":"Billing interval. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].price.interval","typeLabel":"enum\u003cstring>"},"billing_method":{"enum":["prepaid","usage_based"],"type":"string","description":"'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].price.billing_method","typeLabel":"enum\u003cstring>"},"amount":{"type":"number","description":"Price per billing_units after included usage. Either 'amount' or 'tiers' is required.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].price.amount","typeLabel":"number"},"additional_currencies":{"description":"Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers'.","type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].price.additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Price amount in this currency. Set explicitly per currency, not converted from the base amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].price.additional_currencies.items.[INDEX].amount","typeLabel":"number"}},"required":["currency","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].price.additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].price.additional_currencies","typeLabel":"object[]"},"tiers":{"description":"Tiered pricing. Either 'amount' or 'tiers' is required.","type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","const":"inf","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].to.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].to","typeLabel":"number | string"},"amount":{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].amount","typeLabel":"number"},"flat_amount":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].flat_amount","typeLabel":"number"},"additional_currencies":{"type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Per-unit amount for this tier in this currency.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX].amount","typeLabel":"number"},"flat_amount":{"type":"number","description":"Flat amount for this tier in this currency, if the tier uses one.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX].flat_amount","typeLabel":"number"}},"required":["currency"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies","typeLabel":"object[]"}},"required":["to","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].price.tiers.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].price.tiers","typeLabel":"object[]"},"tier_behavior":{"enum":["graduated","volume"],"type":"string","description":"How tiers price usage. 'graduated' (default) charges each unit at the rate of the tier it falls in. 'volume' picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier's rate plus its flat_amount.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].price.tier_behavior","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","description":"Number of intervals per billing cycle. Defaults to 1.","default":1,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].price.interval_count","typeLabel":"number"},"billing_units":{"type":"number","default":1,"description":"Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].price.billing_units","typeLabel":"number"},"max_purchase":{"oneOf":[{"type":"number","description":"Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].price.max_purchase.oneOf.0","typeLabel":"number"},{"type":"null","description":"Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].price.max_purchase.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].price.max_purchase","typeLabel":"number | null"}},"required":["interval","billing_method"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].price","typeLabel":"object"},"proration":{"description":"Proration settings for prepaid features. Controls mid-cycle quantity change billing.","type":"object","properties":{"on_increase":{"enum":["bill_immediately","prorate_immediately","prorate_next_cycle","bill_next_cycle"],"type":"string","description":"Billing behavior when quantity increases mid-cycle.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].proration.on_increase","typeLabel":"enum\u003cstring>"},"on_decrease":{"enum":["prorate","prorate_immediately","prorate_next_cycle","none","no_prorations"],"type":"string","description":"Credit behavior when quantity decreases mid-cycle.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].proration.on_decrease","typeLabel":"enum\u003cstring>"}},"required":["on_increase","on_decrease"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].proration","typeLabel":"object"},"rollover":{"description":"Rollover config for unused units. If set, unused included units carry over.","type":"object","properties":{"expiry_duration_type":{"enum":["month","forever"],"type":"string","description":"When rolled over units expire.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].rollover.expiry_duration_type","typeLabel":"enum\u003cstring>"},"max":{"type":"number","description":"Max rollover units. Omit for unlimited rollover.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].rollover.max","typeLabel":"number"},"max_percentage":{"type":"number","description":"Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].rollover.max_percentage","typeLabel":"number"},"expiry_duration_length":{"type":"number","description":"Number of periods before expiry.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].rollover.expiry_duration_length","typeLabel":"number"}},"required":["expiry_duration_type"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].rollover","typeLabel":"object"},"expiry":{"description":"Purchased units expire this long after each purchase. One-off prepaid consumable items only.","type":"object","properties":{"duration":{"enum":["day","week","month","year"],"type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].expiry.duration","typeLabel":"enum\u003cstring>"},"length":{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].expiry.length","typeLabel":"number"}},"required":["duration","length"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].expiry","typeLabel":"object"},"feature_override":{"description":"Overrides fields of this item's feature for customers on this plan (e.g. a credit system's credit_schema).","type":"object","properties":{"credit_schema":{"description":"For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.","type":"array","items":{"oneOf":[{"type":"object","required":["metered_feature_id","tier_behavior","tiers"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature that draws from this credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.metered_feature_id","typeLabel":"string"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers","typeLabel":"object[]"},"billing_units":{"type":"number","exclusiveMinimum":0,"description":"Number of metered-feature units priced together. Defaults to one when omitted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.billing_units","typeLabel":"number"},"dimensions":{"description":"Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies.","type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"oneOf":[{"type":"object","required":["match","tier_behavior","tiers"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.match","typeLabel":"object"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers","typeLabel":"object[]"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["match","credit_cost"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.match","typeLabel":"object"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group when this dimension matches.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.credit_cost","typeLabel":"number"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions","typeLabel":"object"},"multipliers":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"object","properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.match","typeLabel":"object"},"factor":{"type":"number","exclusiveMinimum":0,"description":"Multiplies the matched rate. All matching multipliers stack.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.factor","typeLabel":"number"},"add":{"type":"number","description":"Added to the rate after every factor is applied, in credits per billing-unit group.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.add","typeLabel":"number"}},"required":["match"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties","typeLabel":"object"},"description":"Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["metered_feature_id","credit_cost"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature that draws from this credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.metered_feature_id","typeLabel":"string"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.credit_cost","typeLabel":"number"},"billing_units":{"type":"number","exclusiveMinimum":0,"description":"Number of metered-feature units priced together. Defaults to one when omitted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.billing_units","typeLabel":"number"},"dimensions":{"description":"Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies.","type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"oneOf":[{"type":"object","required":["match","tier_behavior","tiers"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.match","typeLabel":"object"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers","typeLabel":"object[]"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["match","credit_cost"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.match","typeLabel":"object"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group when this dimension matches.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.credit_cost","typeLabel":"number"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions","typeLabel":"object"},"multipliers":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"object","properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.match","typeLabel":"object"},"factor":{"type":"number","exclusiveMinimum":0,"description":"Multiplies the matched rate. All matching multipliers stack.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.factor","typeLabel":"number"},"add":{"type":"number","description":"Added to the rate after every factor is applied, in credits per billing-unit group.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.add","typeLabel":"number"}},"required":["match"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties","typeLabel":"object"},"description":"Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["metered_feature_id","excluded"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature to remove from the credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2.metered_feature_id","typeLabel":"string"},"excluded":{"description":"Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.","type":"boolean","const":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2.excluded","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema","typeLabel":"object[]"},"markups":{"description":"For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.","type":"object","properties":{"default_markup":{"type":"number","minimum":-100,"description":"Default percentage markup for customers on this plan. Use -100 to make usage free.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.default_markup","typeLabel":"number"},"provider_markups":{"oneOf":[{"type":"object","description":"Per-provider markup percentages for customers on this plan.","additionalProperties":{"type":"object","properties":{"markup":{"type":"number","minimum":-100,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0.additionalProperties.markup","typeLabel":"number"}},"required":["markup"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0","typeLabel":"object"},{"type":"null","description":"Per-provider markup percentages for customers on this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.provider_markups","typeLabel":"object | null"},"model_markups":{"oneOf":[{"type":"object","description":"Per-model markup overrides for customers on this plan.","additionalProperties":{"type":"object","properties":{"markup":{"type":"number","minimum":-100,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.markup","typeLabel":"number"},"input_cost":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.input_cost","typeLabel":"number"},"output_cost":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.output_cost","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0","typeLabel":"object"},{"type":"null","description":"Per-model markup overrides for customers on this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.model_markups","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX].feature_override","typeLabel":"object"}},"required":["feature_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items.items.[INDEX]","typeLabel":"PlanItem · object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.add_items","typeLabel":"PlanItem · object[]"},"remove_items":{"description":"Filters selecting items to remove from the plan.","type":"array","items":{"title":"PlanItemFilter","description":"Filter for matching plan items. All provided fields must match (AND).","type":"object","properties":{"feature_id":{"type":"string","description":"Match items linked to this feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.remove_items.items.[INDEX].feature_id","typeLabel":"string"},"billing_method":{"enum":["prepaid","usage_based"],"type":"string","description":"Match items with this billing method (prepaid or usage_based).","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.remove_items.items.[INDEX].billing_method","typeLabel":"enum\u003cstring>"},"interval":{"oneOf":[{"type":"string","description":"Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.","enum":["one_off","week","month","quarter","semi_annual","year"],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.remove_items.items.[INDEX].interval.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"string","description":"Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.","enum":["one_off","minute","hour","day","week","month","quarter","semi_annual","year"],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.remove_items.items.[INDEX].interval.oneOf.1","typeLabel":"enum\u003cstring>"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.remove_items.items.[INDEX].interval","typeLabel":"enum\u003cstring>"},"interval_count":{"description":"Match items with this interval_count. Disambiguates between items that share an interval but differ in count.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.remove_items.items.[INDEX].interval_count","typeLabel":"integer"},"included":{"type":"number","maximum":10000000000000,"description":"Match items whose grant equals this included usage. Omitted is a wildcard.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.remove_items.items.[INDEX].included","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.remove_items.items.[INDEX]","typeLabel":"PlanItemFilter · object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.remove_items","typeLabel":"PlanItemFilter · object[]"},"free_trial":{"oneOf":[{"type":"object","title":"FreeTrialParams","description":"Override the plan's default free trial. Pass an object to set a custom trial, or null to remove the trial entirely.","required":["duration_length","duration_type","card_required"],"properties":{"duration_length":{"type":"number","description":"Number of duration_type periods the trial lasts.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.free_trial.oneOf.0.duration_length","typeLabel":"number"},"duration_type":{"enum":["day","month","year"],"type":"string","default":"month","description":"Unit of time for the trial ('day', 'month', 'year').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.free_trial.oneOf.0.duration_type","typeLabel":"enum\u003cstring>"},"card_required":{"type":"boolean","default":false,"description":"If true, a payment method is required to start the trial and the customer is charged when it ends. Defaults to false.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.free_trial.oneOf.0.card_required","typeLabel":"boolean"},"on_end":{"enum":["bill","revert"],"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.free_trial.oneOf.0.on_end","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.free_trial.oneOf.0","typeLabel":"FreeTrialParams · object"},{"type":"null","description":"Override the plan's default free trial. Pass an object to set a custom trial, or null to remove the trial entirely.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.free_trial.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.free_trial","typeLabel":"FreeTrialParams · object | null"},"billing_controls":{"description":"Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.","type":"object","properties":{"auto_topups":{"type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"The ID of the feature (credit balance) to auto top-up.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].feature_id","typeLabel":"string"},"enabled":{"type":"boolean","default":false,"description":"Whether auto top-up is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].enabled","typeLabel":"boolean"},"threshold":{"type":"number","description":"When the balance drops below this threshold, an auto top-up will be purchased.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].threshold","typeLabel":"number"},"quantity":{"type":"number","minimum":1,"description":"Amount of credits to add per auto top-up.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].quantity","typeLabel":"number"},"purchase_limit":{"description":"Optional rate limit to cap how often auto top-ups occur. Pass count or amount to set the current window's consumed top-ups or charged amount.","type":"object","properties":{"interval":{"enum":["hour","day","week","month"],"type":"string","description":"The time interval for the purchase limit window.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","minimum":1,"default":1,"description":"Number of intervals in the purchase limit window.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit.interval_count","typeLabel":"number"},"limit":{"type":"number","exclusiveMinimum":0,"description":"Maximum allowed within the interval: a number of auto top-ups when limit_type is count, or a total charge (e.g. 500 for $500, pre-tax) when limit_type is amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit.limit","typeLabel":"number"},"limit_type":{"enum":["count","amount"],"type":"string","description":"What `limit` caps: the number of auto top-ups (`count`, default) or the total amount charged for them, in the customer's currency (`amount`).","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit.limit_type","typeLabel":"enum\u003cstring>"},"count":{"type":"number","minimum":0,"description":"Set the current window's consumed auto top-up count. Omit to leave runtime state unchanged.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit.count","typeLabel":"number"},"amount":{"type":"number","minimum":0,"description":"Set the amount already charged by auto top-ups in the current window. Omit to leave runtime state unchanged.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit.amount","typeLabel":"number"}},"required":["interval","interval_count","limit"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit","typeLabel":"object"},"invoice_mode":{"type":"boolean","description":"When true, auto top-up creates a send_invoice invoice instead of auto-charging.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].invoice_mode","typeLabel":"boolean"}},"required":["feature_id","enabled","threshold","quantity"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.auto_topups","typeLabel":"object[]"},"spend_limits":{"type":"array","items":{"type":"object","properties":{"enabled":{"type":"boolean","default":false,"description":"Whether the overage spend limit is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.spend_limits.items.[INDEX].enabled","typeLabel":"boolean"},"feature_id":{"type":"string","description":"Optional feature ID this spend limit applies to.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.spend_limits.items.[INDEX].feature_id","typeLabel":"string"},"limit_type":{"enum":["absolute","usage_percentage"],"type":"string","description":"How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.spend_limits.items.[INDEX].limit_type","typeLabel":"enum\u003cstring>"},"overage_limit":{"type":"number","minimum":0,"description":"Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.spend_limits.items.[INDEX].overage_limit","typeLabel":"number"},"skip_overage_billing":{"type":"boolean","description":"When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.spend_limits.items.[INDEX].skip_overage_billing","typeLabel":"boolean"}},"required":["enabled"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.spend_limits.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.spend_limits","typeLabel":"object[]"},"usage_limits":{"type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"The feature this usage limit applies to.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.usage_limits.items.[INDEX].feature_id","typeLabel":"string"},"enabled":{"type":"boolean","default":true,"description":"Whether this usage limit is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.usage_limits.items.[INDEX].enabled","typeLabel":"boolean"},"limit":{"type":"number","minimum":0,"description":"Maximum units allowed per interval.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.usage_limits.items.[INDEX].limit","typeLabel":"number"},"interval":{"enum":["day","week","month","year"],"type":"string","description":"Interval for the cap, aligned to the customer's billing cycle.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.usage_limits.items.[INDEX].interval","typeLabel":"enum\u003cstring>"},"anchor":{"enum":["billing_cycle","utc"],"type":"string","description":"Window alignment. 'billing_cycle' phases the interval to the customer's renewal time; 'utc' aligns to the UTC calendar.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.usage_limits.items.[INDEX].anchor","typeLabel":"enum\u003cstring>"},"filter":{"description":"When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.","type":"object","properties":{"properties":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.usage_limits.items.[INDEX].filter.properties.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.usage_limits.items.[INDEX].filter.properties","typeLabel":"object"}},"required":["properties"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.usage_limits.items.[INDEX].filter","typeLabel":"object"}},"required":["feature_id","enabled","limit","interval"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.usage_limits.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.usage_limits","typeLabel":"object[]"},"usage_alerts":{"type":"array","items":{"type":"object","properties":{"enabled":{"type":"boolean","default":true,"description":"Whether this usage alert is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.usage_alerts.items.[INDEX].enabled","typeLabel":"boolean"},"threshold":{"type":"number","description":"The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage. remaining and remaining_percentage accept negative values with basis balance, to alert once the balance is overdrawn.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.usage_alerts.items.[INDEX].threshold","typeLabel":"number"},"threshold_type":{"enum":["usage","usage_percentage","remaining","remaining_percentage"],"type":"string","description":"Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.usage_alerts.items.[INDEX].threshold_type","typeLabel":"enum\u003cstring>"},"basis":{"enum":["balance","included","recurring","usage_limit"],"type":"string","default":"balance","description":"What 100% means. balance: every grant on the feature. included: the plan allowance only. recurring: grants that reset. usage_limit: the cap of the usage limit with the same feature and filter.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.usage_alerts.items.[INDEX].basis","typeLabel":"enum\u003cstring>"},"feature_id":{"type":"string","description":"The feature ID this alert applies to.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.usage_alerts.items.[INDEX].feature_id","typeLabel":"string"},"filter":{"description":"Only valid with basis usage_limit. Points the alert at the usage limit carrying the same filter.","type":"object","properties":{"properties":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.usage_alerts.items.[INDEX].filter.properties.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.usage_alerts.items.[INDEX].filter.properties","typeLabel":"object"}},"required":["properties"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.usage_alerts.items.[INDEX].filter","typeLabel":"object"},"name":{"type":"string","description":"Optional user-defined label to distinguish multiple alerts on the same feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.usage_alerts.items.[INDEX].name","typeLabel":"string"}},"required":["enabled","threshold","threshold_type","basis"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.usage_alerts.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.usage_alerts","typeLabel":"object[]"},"overage_allowed":{"type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"The feature ID this overage allowed control applies to.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.overage_allowed.items.[INDEX].feature_id","typeLabel":"string"},"enabled":{"type":"boolean","default":false,"description":"Whether overage is allowed for this feature.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.overage_allowed.items.[INDEX].enabled","typeLabel":"boolean"}},"required":["feature_id","enabled"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.overage_allowed.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls.overage_allowed","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.billing_controls","typeLabel":"object"},"upsert_licenses":{"description":"License links to add or override for this customer, keyed by license_plan_id. Omitted fields inherit the plan catalog link (included defaults to 1 when the license is not in the catalog). A bare entry restores the license to pure catalog inheritance.","type":"array","items":{"type":"object","properties":{"license_plan_id":{"type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].license_plan_id","typeLabel":"string"},"version_slug":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].version_slug","typeLabel":"string"},"included":{"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].included","typeLabel":"integer"},"prepaid_only":{"type":"boolean","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].prepaid_only","typeLabel":"boolean"},"customize":{"oneOf":[{"type":"object","properties":{"price":{"oneOf":[{"type":"object","title":"BasePrice","description":"Base price configuration for a plan.","required":["amount","interval"],"properties":{"amount":{"type":"number","description":"Base price amount for the plan, in major currency units (e.g. dollars).","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.amount","typeLabel":"number"},"interval":{"enum":["one_off","week","month","quarter","semi_annual","year"],"type":"string","description":"Billing interval (e.g. 'month', 'year').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.interval_count","typeLabel":"number"},"additional_currencies":{"description":"Base price amounts in additional currencies. The base 'amount' is in the org's default currency.","type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Price amount in this currency. Set explicitly per currency, not converted from the base amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.additional_currencies.items.[INDEX].amount","typeLabel":"number"}},"required":["currency","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.additional_currencies","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0","typeLabel":"BasePrice · object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price","typeLabel":"BasePrice · object | null"},"add_items":{"type":"array","items":{"title":"PlanItem","description":"Configuration for a feature item in a plan, including usage limits, pricing, and rollover settings.","type":"object","properties":{"feature_id":{"type":"string","description":"The ID of the feature to configure.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_id","typeLabel":"string"},"threshold_billing":{"oneOf":[{"type":"object","description":"Bills this many feature units when outstanding overage reaches it.","required":["threshold"],"properties":{"threshold":{"type":"number","exclusiveMinimum":0,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].threshold_billing.oneOf.0.threshold","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].threshold_billing.oneOf.0","typeLabel":"object"},{"type":"null","description":"Bills this many feature units when outstanding overage reaches it.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].threshold_billing.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].threshold_billing","typeLabel":"object | null"},"included":{"type":"number","maximum":10000000000000,"description":"Number of free units included. Balance resets to this each interval for consumable features.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].included","typeLabel":"number"},"unlimited":{"type":"boolean","description":"If true, customer has unlimited access to this feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].unlimited","typeLabel":"boolean"},"pooled":{"type":"boolean","default":false,"description":"Whether entity-level grants contribute to a shared customer balance.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].pooled","typeLabel":"boolean"},"reset":{"description":"Reset configuration for consumable features. Omit for non-consumable features like seats.","type":"object","properties":{"interval":{"enum":["one_off","minute","hour","day","week","month","quarter","semi_annual","year"],"type":"string","description":"Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].reset.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].reset.interval_count","typeLabel":"number"}},"required":["interval"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].reset","typeLabel":"object"},"price":{"description":"Pricing for usage beyond included units. Omit for free features.","type":"object","properties":{"interval":{"enum":["one_off","week","month","quarter","semi_annual","year"],"type":"string","description":"Billing interval. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.interval","typeLabel":"enum\u003cstring>"},"billing_method":{"enum":["prepaid","usage_based"],"type":"string","description":"'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.billing_method","typeLabel":"enum\u003cstring>"},"amount":{"type":"number","description":"Price per billing_units after included usage. Either 'amount' or 'tiers' is required.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.amount","typeLabel":"number"},"additional_currencies":{"description":"Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers'.","type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Price amount in this currency. Set explicitly per currency, not converted from the base amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.additional_currencies.items.[INDEX].amount","typeLabel":"number"}},"required":["currency","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.additional_currencies","typeLabel":"object[]"},"tiers":{"description":"Tiered pricing. Either 'amount' or 'tiers' is required.","type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","const":"inf","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].to.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].to","typeLabel":"number | string"},"amount":{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].amount","typeLabel":"number"},"flat_amount":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].flat_amount","typeLabel":"number"},"additional_currencies":{"type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Per-unit amount for this tier in this currency.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX].amount","typeLabel":"number"},"flat_amount":{"type":"number","description":"Flat amount for this tier in this currency, if the tier uses one.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX].flat_amount","typeLabel":"number"}},"required":["currency"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies","typeLabel":"object[]"}},"required":["to","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers","typeLabel":"object[]"},"tier_behavior":{"enum":["graduated","volume"],"type":"string","description":"How tiers price usage. 'graduated' (default) charges each unit at the rate of the tier it falls in. 'volume' picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier's rate plus its flat_amount.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tier_behavior","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","description":"Number of intervals per billing cycle. Defaults to 1.","default":1,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.interval_count","typeLabel":"number"},"billing_units":{"type":"number","default":1,"description":"Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.billing_units","typeLabel":"number"},"max_purchase":{"oneOf":[{"type":"number","description":"Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.max_purchase.oneOf.0","typeLabel":"number"},{"type":"null","description":"Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.max_purchase.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.max_purchase","typeLabel":"number | null"}},"required":["interval","billing_method"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price","typeLabel":"object"},"proration":{"description":"Proration settings for prepaid features. Controls mid-cycle quantity change billing.","type":"object","properties":{"on_increase":{"enum":["bill_immediately","prorate_immediately","prorate_next_cycle","bill_next_cycle"],"type":"string","description":"Billing behavior when quantity increases mid-cycle.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].proration.on_increase","typeLabel":"enum\u003cstring>"},"on_decrease":{"enum":["prorate","prorate_immediately","prorate_next_cycle","none","no_prorations"],"type":"string","description":"Credit behavior when quantity decreases mid-cycle.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].proration.on_decrease","typeLabel":"enum\u003cstring>"}},"required":["on_increase","on_decrease"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].proration","typeLabel":"object"},"rollover":{"description":"Rollover config for unused units. If set, unused included units carry over.","type":"object","properties":{"expiry_duration_type":{"enum":["month","forever"],"type":"string","description":"When rolled over units expire.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].rollover.expiry_duration_type","typeLabel":"enum\u003cstring>"},"max":{"type":"number","description":"Max rollover units. Omit for unlimited rollover.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].rollover.max","typeLabel":"number"},"max_percentage":{"type":"number","description":"Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].rollover.max_percentage","typeLabel":"number"},"expiry_duration_length":{"type":"number","description":"Number of periods before expiry.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].rollover.expiry_duration_length","typeLabel":"number"}},"required":["expiry_duration_type"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].rollover","typeLabel":"object"},"expiry":{"description":"Purchased units expire this long after each purchase. One-off prepaid consumable items only.","type":"object","properties":{"duration":{"enum":["day","week","month","year"],"type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].expiry.duration","typeLabel":"enum\u003cstring>"},"length":{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].expiry.length","typeLabel":"number"}},"required":["duration","length"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].expiry","typeLabel":"object"},"feature_override":{"description":"Overrides fields of this item's feature for customers on this plan (e.g. a credit system's credit_schema).","type":"object","properties":{"credit_schema":{"description":"For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.","type":"array","items":{"oneOf":[{"type":"object","required":["metered_feature_id","tier_behavior","tiers"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature that draws from this credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.metered_feature_id","typeLabel":"string"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers","typeLabel":"object[]"},"billing_units":{"type":"number","exclusiveMinimum":0,"description":"Number of metered-feature units priced together. Defaults to one when omitted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.billing_units","typeLabel":"number"},"dimensions":{"description":"Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies.","type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"oneOf":[{"type":"object","required":["match","tier_behavior","tiers"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.match","typeLabel":"object"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers","typeLabel":"object[]"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["match","credit_cost"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.match","typeLabel":"object"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group when this dimension matches.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.credit_cost","typeLabel":"number"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions","typeLabel":"object"},"multipliers":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"object","properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.match","typeLabel":"object"},"factor":{"type":"number","exclusiveMinimum":0,"description":"Multiplies the matched rate. All matching multipliers stack.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.factor","typeLabel":"number"},"add":{"type":"number","description":"Added to the rate after every factor is applied, in credits per billing-unit group.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.add","typeLabel":"number"}},"required":["match"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties","typeLabel":"object"},"description":"Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["metered_feature_id","credit_cost"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature that draws from this credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.metered_feature_id","typeLabel":"string"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.credit_cost","typeLabel":"number"},"billing_units":{"type":"number","exclusiveMinimum":0,"description":"Number of metered-feature units priced together. Defaults to one when omitted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.billing_units","typeLabel":"number"},"dimensions":{"description":"Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies.","type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"oneOf":[{"type":"object","required":["match","tier_behavior","tiers"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.match","typeLabel":"object"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers","typeLabel":"object[]"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["match","credit_cost"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.match","typeLabel":"object"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group when this dimension matches.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.credit_cost","typeLabel":"number"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions","typeLabel":"object"},"multipliers":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"object","properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.match","typeLabel":"object"},"factor":{"type":"number","exclusiveMinimum":0,"description":"Multiplies the matched rate. All matching multipliers stack.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.factor","typeLabel":"number"},"add":{"type":"number","description":"Added to the rate after every factor is applied, in credits per billing-unit group.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.add","typeLabel":"number"}},"required":["match"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties","typeLabel":"object"},"description":"Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["metered_feature_id","excluded"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature to remove from the credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2.metered_feature_id","typeLabel":"string"},"excluded":{"description":"Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.","type":"boolean","const":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2.excluded","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema","typeLabel":"object[]"},"markups":{"description":"For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.","type":"object","properties":{"default_markup":{"type":"number","minimum":-100,"description":"Default percentage markup for customers on this plan. Use -100 to make usage free.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.default_markup","typeLabel":"number"},"provider_markups":{"oneOf":[{"type":"object","description":"Per-provider markup percentages for customers on this plan.","additionalProperties":{"type":"object","properties":{"markup":{"type":"number","minimum":-100,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0.additionalProperties.markup","typeLabel":"number"}},"required":["markup"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0","typeLabel":"object"},{"type":"null","description":"Per-provider markup percentages for customers on this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.provider_markups","typeLabel":"object | null"},"model_markups":{"oneOf":[{"type":"object","description":"Per-model markup overrides for customers on this plan.","additionalProperties":{"type":"object","properties":{"markup":{"type":"number","minimum":-100,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.markup","typeLabel":"number"},"input_cost":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.input_cost","typeLabel":"number"},"output_cost":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.output_cost","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0","typeLabel":"object"},{"type":"null","description":"Per-model markup overrides for customers on this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override","typeLabel":"object"}},"required":["feature_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX]","typeLabel":"PlanItem · object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items","typeLabel":"PlanItem · object[]"},"remove_items":{"type":"array","items":{"title":"PlanItemFilter","description":"Filter for matching plan items. All provided fields must match (AND).","type":"object","properties":{"feature_id":{"type":"string","description":"Match items linked to this feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].feature_id","typeLabel":"string"},"billing_method":{"enum":["prepaid","usage_based"],"type":"string","description":"Match items with this billing method (prepaid or usage_based).","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].billing_method","typeLabel":"enum\u003cstring>"},"interval":{"oneOf":[{"type":"string","description":"Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.","enum":["one_off","week","month","quarter","semi_annual","year"],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].interval.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"string","description":"Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.","enum":["one_off","minute","hour","day","week","month","quarter","semi_annual","year"],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].interval.oneOf.1","typeLabel":"enum\u003cstring>"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].interval","typeLabel":"enum\u003cstring>"},"interval_count":{"description":"Match items with this interval_count. Disambiguates between items that share an interval but differ in count.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].interval_count","typeLabel":"integer"},"included":{"type":"number","maximum":10000000000000,"description":"Match items whose grant equals this included usage. Omitted is a wildcard.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].included","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX]","typeLabel":"PlanItemFilter · object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items","typeLabel":"PlanItemFilter · object[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize","typeLabel":"object | null"},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].metadata.additionalProperties","typeLabel":"any"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX].metadata","typeLabel":"object"}},"required":["license_plan_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.upsert_licenses","typeLabel":"object[]"},"remove_licenses":{"description":"License links to drop, keyed by license_plan_id. Parallel to remove_items.","type":"array","items":{"type":"object","properties":{"license_plan_id":{"type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.remove_licenses.items.[INDEX].license_plan_id","typeLabel":"string"}},"required":["license_plan_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.remove_licenses.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize.remove_licenses","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details.customize","typeLabel":"object"}},"required":["base_plan_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan.variant_details","typeLabel":"object"}},"required":["id","name","description","group","version","add_on","auto_enable","price","items","created_at","env","archived","config","metadata","base_variant_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.plan","typeLabel":"object"},"price_change":{"description":"Present when the plan's price changed.","type":"object","properties":{"previous":{"oneOf":[{"type":"object","description":"The plan's price before the change.","required":["amount","interval"],"properties":{"amount":{"type":"number","description":"Base price amount for the plan, in major currency units (e.g. dollars).","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.previous.oneOf.0.amount","typeLabel":"number"},"interval":{"enum":["one_off","week","month","quarter","semi_annual","year"],"type":"string","description":"Billing interval (e.g. 'month', 'year').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.previous.oneOf.0.interval","typeLabel":"enum\u003cstring>"},"additional_currencies":{"description":"Base price amounts in additional currencies. The base 'amount' is in the org's default currency.","type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.previous.oneOf.0.additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Price amount in this currency. Set explicitly per currency, not converted from the base amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.previous.oneOf.0.additional_currencies.items.[INDEX].amount","typeLabel":"number"}},"required":["currency","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.previous.oneOf.0.additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.previous.oneOf.0.additional_currencies","typeLabel":"object[]"},"interval_count":{"type":"number","description":"Number of intervals per billing cycle. Defaults to 1.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.previous.oneOf.0.interval_count","typeLabel":"number"},"display":{"description":"Display text for showing this price in pricing pages.","type":"object","properties":{"primary_text":{"type":"string","description":"Main display text (e.g. '$10' or '100 messages').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.previous.oneOf.0.display.primary_text","typeLabel":"string"},"secondary_text":{"type":"string","description":"Secondary display text (e.g. 'per month' or 'then $0.5 per 100').","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.previous.oneOf.0.display.secondary_text","typeLabel":"string"}},"required":["primary_text"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.previous.oneOf.0.display","typeLabel":"object"},"processors":{"description":"Payment processors this base price is connected to. Omitted when unset.","x-atmn-mapping":true,"type":"object","properties":{"stripe":{"oneOf":[{"type":"object","required":["price_id"],"properties":{"price_id":{"type":"string","description":"Stripe price ID. For prepaid with included > 0 this is the V2 price.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.previous.oneOf.0.processors.stripe.oneOf.0.price_id","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.previous.oneOf.0.processors.stripe.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.previous.oneOf.0.processors.stripe.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.previous.oneOf.0.processors.stripe","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.previous.oneOf.0.processors","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.previous.oneOf.0","typeLabel":"object"},{"type":"null","description":"The plan's price before the change.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.previous.oneOf.1","typeLabel":"null"},{"type":"null","description":"The plan's price before the change.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.previous.oneOf.2","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.previous","typeLabel":"object · null · null"},"current":{"oneOf":[{"type":"object","description":"The plan's price after the change.","required":["amount","interval"],"properties":{"amount":{"type":"number","description":"Base price amount for the plan, in major currency units (e.g. dollars).","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.current.oneOf.0.amount","typeLabel":"number"},"interval":{"enum":["one_off","week","month","quarter","semi_annual","year"],"type":"string","description":"Billing interval (e.g. 'month', 'year').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.current.oneOf.0.interval","typeLabel":"enum\u003cstring>"},"additional_currencies":{"description":"Base price amounts in additional currencies. The base 'amount' is in the org's default currency.","type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.current.oneOf.0.additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Price amount in this currency. Set explicitly per currency, not converted from the base amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.current.oneOf.0.additional_currencies.items.[INDEX].amount","typeLabel":"number"}},"required":["currency","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.current.oneOf.0.additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.current.oneOf.0.additional_currencies","typeLabel":"object[]"},"interval_count":{"type":"number","description":"Number of intervals per billing cycle. Defaults to 1.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.current.oneOf.0.interval_count","typeLabel":"number"},"display":{"description":"Display text for showing this price in pricing pages.","type":"object","properties":{"primary_text":{"type":"string","description":"Main display text (e.g. '$10' or '100 messages').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.current.oneOf.0.display.primary_text","typeLabel":"string"},"secondary_text":{"type":"string","description":"Secondary display text (e.g. 'per month' or 'then $0.5 per 100').","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.current.oneOf.0.display.secondary_text","typeLabel":"string"}},"required":["primary_text"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.current.oneOf.0.display","typeLabel":"object"},"processors":{"description":"Payment processors this base price is connected to. Omitted when unset.","x-atmn-mapping":true,"type":"object","properties":{"stripe":{"oneOf":[{"type":"object","required":["price_id"],"properties":{"price_id":{"type":"string","description":"Stripe price ID. For prepaid with included > 0 this is the V2 price.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.current.oneOf.0.processors.stripe.oneOf.0.price_id","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.current.oneOf.0.processors.stripe.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.current.oneOf.0.processors.stripe.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.current.oneOf.0.processors.stripe","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.current.oneOf.0.processors","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.current.oneOf.0","typeLabel":"object"},{"type":"null","description":"The plan's price after the change.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.current.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change.current","typeLabel":"object | null"}},"required":["previous","current"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.price_change","typeLabel":"object"},"free_trial_change":{"description":"Present when the plan's free trial changed.","type":"object","properties":{"previous":{"oneOf":[{"type":"object","description":"The plan's free trial before the change. Null when none.","required":["duration_length","duration_type","card_required"],"properties":{"duration_length":{"type":"number","description":"Number of duration_type periods the trial lasts.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.free_trial_change.previous.oneOf.0.duration_length","typeLabel":"number"},"duration_type":{"enum":["day","month","year"],"type":"string","description":"Unit of time for the trial duration ('day', 'month', 'year').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.free_trial_change.previous.oneOf.0.duration_type","typeLabel":"enum\u003cstring>"},"card_required":{"type":"boolean","description":"Whether a payment method is required to start the trial. If true, customer will be charged after trial ends.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.free_trial_change.previous.oneOf.0.card_required","typeLabel":"boolean"},"on_end":{"oneOf":[{"type":"string","description":"Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.","enum":["bill","revert"],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.free_trial_change.previous.oneOf.0.on_end.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.free_trial_change.previous.oneOf.0.on_end.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.free_trial_change.previous.oneOf.0.on_end","typeLabel":"enum\u003cstring> | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.free_trial_change.previous.oneOf.0","typeLabel":"object"},{"type":"null","description":"The plan's free trial before the change. Null when none.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.free_trial_change.previous.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.free_trial_change.previous","typeLabel":"object | null"},"current":{"oneOf":[{"type":"object","description":"The plan's free trial after the change. Null when none.","required":["duration_length","duration_type","card_required"],"properties":{"duration_length":{"type":"number","description":"Number of duration_type periods the trial lasts.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.free_trial_change.current.oneOf.0.duration_length","typeLabel":"number"},"duration_type":{"enum":["day","month","year"],"type":"string","description":"Unit of time for the trial duration ('day', 'month', 'year').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.free_trial_change.current.oneOf.0.duration_type","typeLabel":"enum\u003cstring>"},"card_required":{"type":"boolean","description":"Whether a payment method is required to start the trial. If true, customer will be charged after trial ends.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.free_trial_change.current.oneOf.0.card_required","typeLabel":"boolean"},"on_end":{"oneOf":[{"type":"string","description":"Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.","enum":["bill","revert"],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.free_trial_change.current.oneOf.0.on_end.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.free_trial_change.current.oneOf.0.on_end.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.free_trial_change.current.oneOf.0.on_end","typeLabel":"enum\u003cstring> | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.free_trial_change.current.oneOf.0","typeLabel":"object"},{"type":"null","description":"The plan's free trial after the change. Null when none.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.free_trial_change.current.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.free_trial_change.current","typeLabel":"object | null"}},"required":["previous","current"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.free_trial_change","typeLabel":"object"},"customize":{"description":"Params that would transform the previous plan into the current one, including license upserts/removes.","type":"object","properties":{"price":{"oneOf":[{"type":"object","title":"BasePrice","description":"Override the base price of the plan. Pass null to remove the base price.","required":["amount","interval"],"properties":{"amount":{"type":"number","description":"Base price amount for the plan, in major currency units (e.g. dollars).","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.price.oneOf.0.amount","typeLabel":"number"},"interval":{"enum":["one_off","week","month","quarter","semi_annual","year"],"type":"string","description":"Billing interval (e.g. 'month', 'year').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.price.oneOf.0.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.price.oneOf.0.interval_count","typeLabel":"number"},"additional_currencies":{"description":"Base price amounts in additional currencies. The base 'amount' is in the org's default currency.","type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.price.oneOf.0.additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Price amount in this currency. Set explicitly per currency, not converted from the base amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.price.oneOf.0.additional_currencies.items.[INDEX].amount","typeLabel":"number"}},"required":["currency","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.price.oneOf.0.additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.price.oneOf.0.additional_currencies","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.price.oneOf.0","typeLabel":"BasePrice · object"},{"type":"null","description":"Override the base price of the plan. Pass null to remove the base price.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.price.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.price","typeLabel":"BasePrice · object | null"},"add_items":{"description":"Items to add to the plan.","type":"array","items":{"title":"PlanItem","description":"Configuration for a feature item in a plan, including usage limits, pricing, and rollover settings.","type":"object","properties":{"feature_id":{"type":"string","description":"The ID of the feature to configure.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_id","typeLabel":"string"},"threshold_billing":{"oneOf":[{"type":"object","description":"Bills this many feature units when outstanding overage reaches it.","required":["threshold"],"properties":{"threshold":{"type":"number","exclusiveMinimum":0,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].threshold_billing.oneOf.0.threshold","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].threshold_billing.oneOf.0","typeLabel":"object"},{"type":"null","description":"Bills this many feature units when outstanding overage reaches it.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].threshold_billing.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].threshold_billing","typeLabel":"object | null"},"included":{"type":"number","maximum":10000000000000,"description":"Number of free units included. Balance resets to this each interval for consumable features.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].included","typeLabel":"number"},"unlimited":{"type":"boolean","description":"If true, customer has unlimited access to this feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].unlimited","typeLabel":"boolean"},"pooled":{"type":"boolean","default":false,"description":"Whether entity-level grants contribute to a shared customer balance.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].pooled","typeLabel":"boolean"},"reset":{"description":"Reset configuration for consumable features. Omit for non-consumable features like seats.","type":"object","properties":{"interval":{"enum":["one_off","minute","hour","day","week","month","quarter","semi_annual","year"],"type":"string","description":"Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].reset.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].reset.interval_count","typeLabel":"number"}},"required":["interval"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].reset","typeLabel":"object"},"price":{"description":"Pricing for usage beyond included units. Omit for free features.","type":"object","properties":{"interval":{"enum":["one_off","week","month","quarter","semi_annual","year"],"type":"string","description":"Billing interval. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].price.interval","typeLabel":"enum\u003cstring>"},"billing_method":{"enum":["prepaid","usage_based"],"type":"string","description":"'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].price.billing_method","typeLabel":"enum\u003cstring>"},"amount":{"type":"number","description":"Price per billing_units after included usage. Either 'amount' or 'tiers' is required.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].price.amount","typeLabel":"number"},"additional_currencies":{"description":"Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers'.","type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].price.additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Price amount in this currency. Set explicitly per currency, not converted from the base amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].price.additional_currencies.items.[INDEX].amount","typeLabel":"number"}},"required":["currency","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].price.additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].price.additional_currencies","typeLabel":"object[]"},"tiers":{"description":"Tiered pricing. Either 'amount' or 'tiers' is required.","type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","const":"inf","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].to.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].to","typeLabel":"number | string"},"amount":{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].amount","typeLabel":"number"},"flat_amount":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].flat_amount","typeLabel":"number"},"additional_currencies":{"type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Per-unit amount for this tier in this currency.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX].amount","typeLabel":"number"},"flat_amount":{"type":"number","description":"Flat amount for this tier in this currency, if the tier uses one.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX].flat_amount","typeLabel":"number"}},"required":["currency"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies","typeLabel":"object[]"}},"required":["to","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].price.tiers.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].price.tiers","typeLabel":"object[]"},"tier_behavior":{"enum":["graduated","volume"],"type":"string","description":"How tiers price usage. 'graduated' (default) charges each unit at the rate of the tier it falls in. 'volume' picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier's rate plus its flat_amount.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].price.tier_behavior","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","description":"Number of intervals per billing cycle. Defaults to 1.","default":1,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].price.interval_count","typeLabel":"number"},"billing_units":{"type":"number","default":1,"description":"Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].price.billing_units","typeLabel":"number"},"max_purchase":{"oneOf":[{"type":"number","description":"Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].price.max_purchase.oneOf.0","typeLabel":"number"},{"type":"null","description":"Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].price.max_purchase.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].price.max_purchase","typeLabel":"number | null"}},"required":["interval","billing_method"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].price","typeLabel":"object"},"proration":{"description":"Proration settings for prepaid features. Controls mid-cycle quantity change billing.","type":"object","properties":{"on_increase":{"enum":["bill_immediately","prorate_immediately","prorate_next_cycle","bill_next_cycle"],"type":"string","description":"Billing behavior when quantity increases mid-cycle.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].proration.on_increase","typeLabel":"enum\u003cstring>"},"on_decrease":{"enum":["prorate","prorate_immediately","prorate_next_cycle","none","no_prorations"],"type":"string","description":"Credit behavior when quantity decreases mid-cycle.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].proration.on_decrease","typeLabel":"enum\u003cstring>"}},"required":["on_increase","on_decrease"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].proration","typeLabel":"object"},"rollover":{"description":"Rollover config for unused units. If set, unused included units carry over.","type":"object","properties":{"expiry_duration_type":{"enum":["month","forever"],"type":"string","description":"When rolled over units expire.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].rollover.expiry_duration_type","typeLabel":"enum\u003cstring>"},"max":{"type":"number","description":"Max rollover units. Omit for unlimited rollover.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].rollover.max","typeLabel":"number"},"max_percentage":{"type":"number","description":"Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].rollover.max_percentage","typeLabel":"number"},"expiry_duration_length":{"type":"number","description":"Number of periods before expiry.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].rollover.expiry_duration_length","typeLabel":"number"}},"required":["expiry_duration_type"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].rollover","typeLabel":"object"},"expiry":{"description":"Purchased units expire this long after each purchase. One-off prepaid consumable items only.","type":"object","properties":{"duration":{"enum":["day","week","month","year"],"type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].expiry.duration","typeLabel":"enum\u003cstring>"},"length":{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].expiry.length","typeLabel":"number"}},"required":["duration","length"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].expiry","typeLabel":"object"},"feature_override":{"description":"Overrides fields of this item's feature for customers on this plan (e.g. a credit system's credit_schema).","type":"object","properties":{"credit_schema":{"description":"For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.","type":"array","items":{"oneOf":[{"type":"object","required":["metered_feature_id","tier_behavior","tiers"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature that draws from this credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.metered_feature_id","typeLabel":"string"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers","typeLabel":"object[]"},"billing_units":{"type":"number","exclusiveMinimum":0,"description":"Number of metered-feature units priced together. Defaults to one when omitted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.billing_units","typeLabel":"number"},"dimensions":{"description":"Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies.","type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"oneOf":[{"type":"object","required":["match","tier_behavior","tiers"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.match","typeLabel":"object"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers","typeLabel":"object[]"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["match","credit_cost"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.match","typeLabel":"object"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group when this dimension matches.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.credit_cost","typeLabel":"number"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions","typeLabel":"object"},"multipliers":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"object","properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.match","typeLabel":"object"},"factor":{"type":"number","exclusiveMinimum":0,"description":"Multiplies the matched rate. All matching multipliers stack.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.factor","typeLabel":"number"},"add":{"type":"number","description":"Added to the rate after every factor is applied, in credits per billing-unit group.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.add","typeLabel":"number"}},"required":["match"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties","typeLabel":"object"},"description":"Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["metered_feature_id","credit_cost"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature that draws from this credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.metered_feature_id","typeLabel":"string"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.credit_cost","typeLabel":"number"},"billing_units":{"type":"number","exclusiveMinimum":0,"description":"Number of metered-feature units priced together. Defaults to one when omitted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.billing_units","typeLabel":"number"},"dimensions":{"description":"Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies.","type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"oneOf":[{"type":"object","required":["match","tier_behavior","tiers"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.match","typeLabel":"object"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers","typeLabel":"object[]"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["match","credit_cost"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.match","typeLabel":"object"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group when this dimension matches.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.credit_cost","typeLabel":"number"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions","typeLabel":"object"},"multipliers":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"object","properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.match","typeLabel":"object"},"factor":{"type":"number","exclusiveMinimum":0,"description":"Multiplies the matched rate. All matching multipliers stack.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.factor","typeLabel":"number"},"add":{"type":"number","description":"Added to the rate after every factor is applied, in credits per billing-unit group.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.add","typeLabel":"number"}},"required":["match"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties","typeLabel":"object"},"description":"Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["metered_feature_id","excluded"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature to remove from the credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2.metered_feature_id","typeLabel":"string"},"excluded":{"description":"Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.","type":"boolean","const":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2.excluded","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.credit_schema","typeLabel":"object[]"},"markups":{"description":"For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.","type":"object","properties":{"default_markup":{"type":"number","minimum":-100,"description":"Default percentage markup for customers on this plan. Use -100 to make usage free.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.markups.default_markup","typeLabel":"number"},"provider_markups":{"oneOf":[{"type":"object","description":"Per-provider markup percentages for customers on this plan.","additionalProperties":{"type":"object","properties":{"markup":{"type":"number","minimum":-100,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0.additionalProperties.markup","typeLabel":"number"}},"required":["markup"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0","typeLabel":"object"},{"type":"null","description":"Per-provider markup percentages for customers on this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.markups.provider_markups","typeLabel":"object | null"},"model_markups":{"oneOf":[{"type":"object","description":"Per-model markup overrides for customers on this plan.","additionalProperties":{"type":"object","properties":{"markup":{"type":"number","minimum":-100,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.markup","typeLabel":"number"},"input_cost":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.input_cost","typeLabel":"number"},"output_cost":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.output_cost","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0","typeLabel":"object"},{"type":"null","description":"Per-model markup overrides for customers on this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.markups.model_markups","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override.markups","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX].feature_override","typeLabel":"object"}},"required":["feature_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items.items.[INDEX]","typeLabel":"PlanItem · object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.add_items","typeLabel":"PlanItem · object[]"},"remove_items":{"description":"Filters selecting items to remove from the plan.","type":"array","items":{"title":"PlanItemFilter","description":"Filter for matching plan items. All provided fields must match (AND).","type":"object","properties":{"feature_id":{"type":"string","description":"Match items linked to this feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.remove_items.items.[INDEX].feature_id","typeLabel":"string"},"billing_method":{"enum":["prepaid","usage_based"],"type":"string","description":"Match items with this billing method (prepaid or usage_based).","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.remove_items.items.[INDEX].billing_method","typeLabel":"enum\u003cstring>"},"interval":{"oneOf":[{"type":"string","description":"Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.","enum":["one_off","week","month","quarter","semi_annual","year"],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.remove_items.items.[INDEX].interval.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"string","description":"Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.","enum":["one_off","minute","hour","day","week","month","quarter","semi_annual","year"],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.remove_items.items.[INDEX].interval.oneOf.1","typeLabel":"enum\u003cstring>"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.remove_items.items.[INDEX].interval","typeLabel":"enum\u003cstring>"},"interval_count":{"description":"Match items with this interval_count. Disambiguates between items that share an interval but differ in count.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.remove_items.items.[INDEX].interval_count","typeLabel":"integer"},"included":{"type":"number","maximum":10000000000000,"description":"Match items whose grant equals this included usage. Omitted is a wildcard.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.remove_items.items.[INDEX].included","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.remove_items.items.[INDEX]","typeLabel":"PlanItemFilter · object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.remove_items","typeLabel":"PlanItemFilter · object[]"},"free_trial":{"oneOf":[{"type":"object","title":"FreeTrialParams","description":"Override the plan's default free trial. Pass an object to set a custom trial, or null to remove the trial entirely.","required":["duration_length","duration_type","card_required"],"properties":{"duration_length":{"type":"number","description":"Number of duration_type periods the trial lasts.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.free_trial.oneOf.0.duration_length","typeLabel":"number"},"duration_type":{"enum":["day","month","year"],"type":"string","default":"month","description":"Unit of time for the trial ('day', 'month', 'year').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.free_trial.oneOf.0.duration_type","typeLabel":"enum\u003cstring>"},"card_required":{"type":"boolean","default":false,"description":"If true, a payment method is required to start the trial and the customer is charged when it ends. Defaults to false.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.free_trial.oneOf.0.card_required","typeLabel":"boolean"},"on_end":{"enum":["bill","revert"],"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.free_trial.oneOf.0.on_end","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.free_trial.oneOf.0","typeLabel":"FreeTrialParams · object"},{"type":"null","description":"Override the plan's default free trial. Pass an object to set a custom trial, or null to remove the trial entirely.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.free_trial.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.free_trial","typeLabel":"FreeTrialParams · object | null"},"billing_controls":{"description":"Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.","type":"object","properties":{"auto_topups":{"type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"The ID of the feature (credit balance) to auto top-up.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.auto_topups.items.[INDEX].feature_id","typeLabel":"string"},"enabled":{"type":"boolean","default":false,"description":"Whether auto top-up is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.auto_topups.items.[INDEX].enabled","typeLabel":"boolean"},"threshold":{"type":"number","description":"When the balance drops below this threshold, an auto top-up will be purchased.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.auto_topups.items.[INDEX].threshold","typeLabel":"number"},"quantity":{"type":"number","minimum":1,"description":"Amount of credits to add per auto top-up.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.auto_topups.items.[INDEX].quantity","typeLabel":"number"},"purchase_limit":{"description":"Optional rate limit to cap how often auto top-ups occur. Pass count or amount to set the current window's consumed top-ups or charged amount.","type":"object","properties":{"interval":{"enum":["hour","day","week","month"],"type":"string","description":"The time interval for the purchase limit window.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","minimum":1,"default":1,"description":"Number of intervals in the purchase limit window.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit.interval_count","typeLabel":"number"},"limit":{"type":"number","exclusiveMinimum":0,"description":"Maximum allowed within the interval: a number of auto top-ups when limit_type is count, or a total charge (e.g. 500 for $500, pre-tax) when limit_type is amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit.limit","typeLabel":"number"},"limit_type":{"enum":["count","amount"],"type":"string","description":"What `limit` caps: the number of auto top-ups (`count`, default) or the total amount charged for them, in the customer's currency (`amount`).","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit.limit_type","typeLabel":"enum\u003cstring>"},"count":{"type":"number","minimum":0,"description":"Set the current window's consumed auto top-up count. Omit to leave runtime state unchanged.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit.count","typeLabel":"number"},"amount":{"type":"number","minimum":0,"description":"Set the amount already charged by auto top-ups in the current window. Omit to leave runtime state unchanged.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit.amount","typeLabel":"number"}},"required":["interval","interval_count","limit"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit","typeLabel":"object"},"invoice_mode":{"type":"boolean","description":"When true, auto top-up creates a send_invoice invoice instead of auto-charging.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.auto_topups.items.[INDEX].invoice_mode","typeLabel":"boolean"}},"required":["feature_id","enabled","threshold","quantity"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.auto_topups.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.auto_topups","typeLabel":"object[]"},"spend_limits":{"type":"array","items":{"type":"object","properties":{"enabled":{"type":"boolean","default":false,"description":"Whether the overage spend limit is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.spend_limits.items.[INDEX].enabled","typeLabel":"boolean"},"feature_id":{"type":"string","description":"Optional feature ID this spend limit applies to.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.spend_limits.items.[INDEX].feature_id","typeLabel":"string"},"limit_type":{"enum":["absolute","usage_percentage"],"type":"string","description":"How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.spend_limits.items.[INDEX].limit_type","typeLabel":"enum\u003cstring>"},"overage_limit":{"type":"number","minimum":0,"description":"Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.spend_limits.items.[INDEX].overage_limit","typeLabel":"number"},"skip_overage_billing":{"type":"boolean","description":"When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.spend_limits.items.[INDEX].skip_overage_billing","typeLabel":"boolean"}},"required":["enabled"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.spend_limits.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.spend_limits","typeLabel":"object[]"},"usage_limits":{"type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"The feature this usage limit applies to.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.usage_limits.items.[INDEX].feature_id","typeLabel":"string"},"enabled":{"type":"boolean","default":true,"description":"Whether this usage limit is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.usage_limits.items.[INDEX].enabled","typeLabel":"boolean"},"limit":{"type":"number","minimum":0,"description":"Maximum units allowed per interval.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.usage_limits.items.[INDEX].limit","typeLabel":"number"},"interval":{"enum":["day","week","month","year"],"type":"string","description":"Interval for the cap, aligned to the customer's billing cycle.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.usage_limits.items.[INDEX].interval","typeLabel":"enum\u003cstring>"},"anchor":{"enum":["billing_cycle","utc"],"type":"string","description":"Window alignment. 'billing_cycle' phases the interval to the customer's renewal time; 'utc' aligns to the UTC calendar.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.usage_limits.items.[INDEX].anchor","typeLabel":"enum\u003cstring>"},"filter":{"description":"When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.","type":"object","properties":{"properties":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.usage_limits.items.[INDEX].filter.properties.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.usage_limits.items.[INDEX].filter.properties","typeLabel":"object"}},"required":["properties"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.usage_limits.items.[INDEX].filter","typeLabel":"object"}},"required":["feature_id","enabled","limit","interval"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.usage_limits.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.usage_limits","typeLabel":"object[]"},"usage_alerts":{"type":"array","items":{"type":"object","properties":{"enabled":{"type":"boolean","default":true,"description":"Whether this usage alert is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.usage_alerts.items.[INDEX].enabled","typeLabel":"boolean"},"threshold":{"type":"number","description":"The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage. remaining and remaining_percentage accept negative values with basis balance, to alert once the balance is overdrawn.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.usage_alerts.items.[INDEX].threshold","typeLabel":"number"},"threshold_type":{"enum":["usage","usage_percentage","remaining","remaining_percentage"],"type":"string","description":"Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.usage_alerts.items.[INDEX].threshold_type","typeLabel":"enum\u003cstring>"},"basis":{"enum":["balance","included","recurring","usage_limit"],"type":"string","default":"balance","description":"What 100% means. balance: every grant on the feature. included: the plan allowance only. recurring: grants that reset. usage_limit: the cap of the usage limit with the same feature and filter.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.usage_alerts.items.[INDEX].basis","typeLabel":"enum\u003cstring>"},"feature_id":{"type":"string","description":"The feature ID this alert applies to.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.usage_alerts.items.[INDEX].feature_id","typeLabel":"string"},"filter":{"description":"Only valid with basis usage_limit. Points the alert at the usage limit carrying the same filter.","type":"object","properties":{"properties":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.usage_alerts.items.[INDEX].filter.properties.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.usage_alerts.items.[INDEX].filter.properties","typeLabel":"object"}},"required":["properties"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.usage_alerts.items.[INDEX].filter","typeLabel":"object"},"name":{"type":"string","description":"Optional user-defined label to distinguish multiple alerts on the same feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.usage_alerts.items.[INDEX].name","typeLabel":"string"}},"required":["enabled","threshold","threshold_type","basis"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.usage_alerts.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.usage_alerts","typeLabel":"object[]"},"overage_allowed":{"type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"The feature ID this overage allowed control applies to.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.overage_allowed.items.[INDEX].feature_id","typeLabel":"string"},"enabled":{"type":"boolean","default":false,"description":"Whether overage is allowed for this feature.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.overage_allowed.items.[INDEX].enabled","typeLabel":"boolean"}},"required":["feature_id","enabled"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.overage_allowed.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls.overage_allowed","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.billing_controls","typeLabel":"object"},"upsert_licenses":{"description":"planLicenses created or overridden. Same shape as customize.upsert_licenses / licenses[] entries.","type":"array","items":{"type":"object","properties":{"license_plan_id":{"type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].license_plan_id","typeLabel":"string"},"version_slug":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].version_slug","typeLabel":"string"},"included":{"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].included","typeLabel":"integer"},"prepaid_only":{"type":"boolean","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].prepaid_only","typeLabel":"boolean"},"customize":{"oneOf":[{"type":"object","properties":{"price":{"oneOf":[{"type":"object","title":"BasePrice","description":"Base price configuration for a plan.","required":["amount","interval"],"properties":{"amount":{"type":"number","description":"Base price amount for the plan, in major currency units (e.g. dollars).","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.amount","typeLabel":"number"},"interval":{"enum":["one_off","week","month","quarter","semi_annual","year"],"type":"string","description":"Billing interval (e.g. 'month', 'year').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.interval_count","typeLabel":"number"},"additional_currencies":{"description":"Base price amounts in additional currencies. The base 'amount' is in the org's default currency.","type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Price amount in this currency. Set explicitly per currency, not converted from the base amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.additional_currencies.items.[INDEX].amount","typeLabel":"number"}},"required":["currency","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.additional_currencies","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0","typeLabel":"BasePrice · object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price","typeLabel":"BasePrice · object | null"},"add_items":{"type":"array","items":{"title":"PlanItem","description":"Configuration for a feature item in a plan, including usage limits, pricing, and rollover settings.","type":"object","properties":{"feature_id":{"type":"string","description":"The ID of the feature to configure.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_id","typeLabel":"string"},"threshold_billing":{"oneOf":[{"type":"object","description":"Bills this many feature units when outstanding overage reaches it.","required":["threshold"],"properties":{"threshold":{"type":"number","exclusiveMinimum":0,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].threshold_billing.oneOf.0.threshold","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].threshold_billing.oneOf.0","typeLabel":"object"},{"type":"null","description":"Bills this many feature units when outstanding overage reaches it.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].threshold_billing.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].threshold_billing","typeLabel":"object | null"},"included":{"type":"number","maximum":10000000000000,"description":"Number of free units included. Balance resets to this each interval for consumable features.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].included","typeLabel":"number"},"unlimited":{"type":"boolean","description":"If true, customer has unlimited access to this feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].unlimited","typeLabel":"boolean"},"pooled":{"type":"boolean","default":false,"description":"Whether entity-level grants contribute to a shared customer balance.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].pooled","typeLabel":"boolean"},"reset":{"description":"Reset configuration for consumable features. Omit for non-consumable features like seats.","type":"object","properties":{"interval":{"enum":["one_off","minute","hour","day","week","month","quarter","semi_annual","year"],"type":"string","description":"Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].reset.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].reset.interval_count","typeLabel":"number"}},"required":["interval"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].reset","typeLabel":"object"},"price":{"description":"Pricing for usage beyond included units. Omit for free features.","type":"object","properties":{"interval":{"enum":["one_off","week","month","quarter","semi_annual","year"],"type":"string","description":"Billing interval. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.interval","typeLabel":"enum\u003cstring>"},"billing_method":{"enum":["prepaid","usage_based"],"type":"string","description":"'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.billing_method","typeLabel":"enum\u003cstring>"},"amount":{"type":"number","description":"Price per billing_units after included usage. Either 'amount' or 'tiers' is required.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.amount","typeLabel":"number"},"additional_currencies":{"description":"Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers'.","type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Price amount in this currency. Set explicitly per currency, not converted from the base amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.additional_currencies.items.[INDEX].amount","typeLabel":"number"}},"required":["currency","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.additional_currencies","typeLabel":"object[]"},"tiers":{"description":"Tiered pricing. Either 'amount' or 'tiers' is required.","type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","const":"inf","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].to.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].to","typeLabel":"number | string"},"amount":{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].amount","typeLabel":"number"},"flat_amount":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].flat_amount","typeLabel":"number"},"additional_currencies":{"type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Per-unit amount for this tier in this currency.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX].amount","typeLabel":"number"},"flat_amount":{"type":"number","description":"Flat amount for this tier in this currency, if the tier uses one.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX].flat_amount","typeLabel":"number"}},"required":["currency"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies","typeLabel":"object[]"}},"required":["to","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers","typeLabel":"object[]"},"tier_behavior":{"enum":["graduated","volume"],"type":"string","description":"How tiers price usage. 'graduated' (default) charges each unit at the rate of the tier it falls in. 'volume' picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier's rate plus its flat_amount.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tier_behavior","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","description":"Number of intervals per billing cycle. Defaults to 1.","default":1,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.interval_count","typeLabel":"number"},"billing_units":{"type":"number","default":1,"description":"Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.billing_units","typeLabel":"number"},"max_purchase":{"oneOf":[{"type":"number","description":"Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.max_purchase.oneOf.0","typeLabel":"number"},{"type":"null","description":"Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.max_purchase.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.max_purchase","typeLabel":"number | null"}},"required":["interval","billing_method"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price","typeLabel":"object"},"proration":{"description":"Proration settings for prepaid features. Controls mid-cycle quantity change billing.","type":"object","properties":{"on_increase":{"enum":["bill_immediately","prorate_immediately","prorate_next_cycle","bill_next_cycle"],"type":"string","description":"Billing behavior when quantity increases mid-cycle.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].proration.on_increase","typeLabel":"enum\u003cstring>"},"on_decrease":{"enum":["prorate","prorate_immediately","prorate_next_cycle","none","no_prorations"],"type":"string","description":"Credit behavior when quantity decreases mid-cycle.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].proration.on_decrease","typeLabel":"enum\u003cstring>"}},"required":["on_increase","on_decrease"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].proration","typeLabel":"object"},"rollover":{"description":"Rollover config for unused units. If set, unused included units carry over.","type":"object","properties":{"expiry_duration_type":{"enum":["month","forever"],"type":"string","description":"When rolled over units expire.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].rollover.expiry_duration_type","typeLabel":"enum\u003cstring>"},"max":{"type":"number","description":"Max rollover units. Omit for unlimited rollover.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].rollover.max","typeLabel":"number"},"max_percentage":{"type":"number","description":"Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].rollover.max_percentage","typeLabel":"number"},"expiry_duration_length":{"type":"number","description":"Number of periods before expiry.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].rollover.expiry_duration_length","typeLabel":"number"}},"required":["expiry_duration_type"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].rollover","typeLabel":"object"},"expiry":{"description":"Purchased units expire this long after each purchase. One-off prepaid consumable items only.","type":"object","properties":{"duration":{"enum":["day","week","month","year"],"type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].expiry.duration","typeLabel":"enum\u003cstring>"},"length":{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].expiry.length","typeLabel":"number"}},"required":["duration","length"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].expiry","typeLabel":"object"},"feature_override":{"description":"Overrides fields of this item's feature for customers on this plan (e.g. a credit system's credit_schema).","type":"object","properties":{"credit_schema":{"description":"For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.","type":"array","items":{"oneOf":[{"type":"object","required":["metered_feature_id","tier_behavior","tiers"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature that draws from this credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.metered_feature_id","typeLabel":"string"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers","typeLabel":"object[]"},"billing_units":{"type":"number","exclusiveMinimum":0,"description":"Number of metered-feature units priced together. Defaults to one when omitted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.billing_units","typeLabel":"number"},"dimensions":{"description":"Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies.","type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"oneOf":[{"type":"object","required":["match","tier_behavior","tiers"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.match","typeLabel":"object"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers","typeLabel":"object[]"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["match","credit_cost"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.match","typeLabel":"object"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group when this dimension matches.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.credit_cost","typeLabel":"number"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions","typeLabel":"object"},"multipliers":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"object","properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.match","typeLabel":"object"},"factor":{"type":"number","exclusiveMinimum":0,"description":"Multiplies the matched rate. All matching multipliers stack.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.factor","typeLabel":"number"},"add":{"type":"number","description":"Added to the rate after every factor is applied, in credits per billing-unit group.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.add","typeLabel":"number"}},"required":["match"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties","typeLabel":"object"},"description":"Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["metered_feature_id","credit_cost"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature that draws from this credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.metered_feature_id","typeLabel":"string"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.credit_cost","typeLabel":"number"},"billing_units":{"type":"number","exclusiveMinimum":0,"description":"Number of metered-feature units priced together. Defaults to one when omitted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.billing_units","typeLabel":"number"},"dimensions":{"description":"Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies.","type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"oneOf":[{"type":"object","required":["match","tier_behavior","tiers"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.match","typeLabel":"object"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers","typeLabel":"object[]"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["match","credit_cost"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.match","typeLabel":"object"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group when this dimension matches.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.credit_cost","typeLabel":"number"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions","typeLabel":"object"},"multipliers":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"object","properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.match","typeLabel":"object"},"factor":{"type":"number","exclusiveMinimum":0,"description":"Multiplies the matched rate. All matching multipliers stack.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.factor","typeLabel":"number"},"add":{"type":"number","description":"Added to the rate after every factor is applied, in credits per billing-unit group.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.add","typeLabel":"number"}},"required":["match"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties","typeLabel":"object"},"description":"Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["metered_feature_id","excluded"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature to remove from the credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2.metered_feature_id","typeLabel":"string"},"excluded":{"description":"Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.","type":"boolean","const":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2.excluded","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema","typeLabel":"object[]"},"markups":{"description":"For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.","type":"object","properties":{"default_markup":{"type":"number","minimum":-100,"description":"Default percentage markup for customers on this plan. Use -100 to make usage free.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.default_markup","typeLabel":"number"},"provider_markups":{"oneOf":[{"type":"object","description":"Per-provider markup percentages for customers on this plan.","additionalProperties":{"type":"object","properties":{"markup":{"type":"number","minimum":-100,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0.additionalProperties.markup","typeLabel":"number"}},"required":["markup"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0","typeLabel":"object"},{"type":"null","description":"Per-provider markup percentages for customers on this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.provider_markups","typeLabel":"object | null"},"model_markups":{"oneOf":[{"type":"object","description":"Per-model markup overrides for customers on this plan.","additionalProperties":{"type":"object","properties":{"markup":{"type":"number","minimum":-100,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.markup","typeLabel":"number"},"input_cost":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.input_cost","typeLabel":"number"},"output_cost":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.output_cost","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0","typeLabel":"object"},{"type":"null","description":"Per-model markup overrides for customers on this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override","typeLabel":"object"}},"required":["feature_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX]","typeLabel":"PlanItem · object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items","typeLabel":"PlanItem · object[]"},"remove_items":{"type":"array","items":{"title":"PlanItemFilter","description":"Filter for matching plan items. All provided fields must match (AND).","type":"object","properties":{"feature_id":{"type":"string","description":"Match items linked to this feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].feature_id","typeLabel":"string"},"billing_method":{"enum":["prepaid","usage_based"],"type":"string","description":"Match items with this billing method (prepaid or usage_based).","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].billing_method","typeLabel":"enum\u003cstring>"},"interval":{"oneOf":[{"type":"string","description":"Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.","enum":["one_off","week","month","quarter","semi_annual","year"],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].interval.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"string","description":"Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.","enum":["one_off","minute","hour","day","week","month","quarter","semi_annual","year"],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].interval.oneOf.1","typeLabel":"enum\u003cstring>"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].interval","typeLabel":"enum\u003cstring>"},"interval_count":{"description":"Match items with this interval_count. Disambiguates between items that share an interval but differ in count.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].interval_count","typeLabel":"integer"},"included":{"type":"number","maximum":10000000000000,"description":"Match items whose grant equals this included usage. Omitted is a wildcard.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].included","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX]","typeLabel":"PlanItemFilter · object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items","typeLabel":"PlanItemFilter · object[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].customize","typeLabel":"object | null"},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].metadata.additionalProperties","typeLabel":"any"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX].metadata","typeLabel":"object"}},"required":["license_plan_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.upsert_licenses","typeLabel":"object[]"},"remove_licenses":{"description":"planLicenses dropped from this plan.","type":"array","items":{"type":"object","properties":{"license_plan_id":{"type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.remove_licenses.items.[INDEX].license_plan_id","typeLabel":"string"}},"required":["license_plan_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.remove_licenses.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize.remove_licenses","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.customize","typeLabel":"object"},"license_changes":{"description":"planLicenses created, updated, or removed on this plan. Omitted when none. Nested plan_change is core-only.","type":"array","items":{"type":"object","properties":{"license_plan_id":{"type":"string","description":"The plan offered as a license under this plan.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].license_plan_id","typeLabel":"string"},"version":{"type":"integer","minimum":1,"maximum":9007199254740991,"description":"The exact license-plan version pinned by this link.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].version","typeLabel":"integer"},"included":{"type":"number","description":"Number of license assignments included with this plan for free.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].included","typeLabel":"number"},"action":{"description":"created = new planLicense; updated = row or effective content changed; removed = dropped.","type":"string","enum":["created","updated","removed"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].action","typeLabel":"enum\u003cstring>"},"previous_attributes":{"oneOf":[{"type":"object","description":"Previous included / prepaid_only / version. Null when created or removed, or when no row scalar changed.","properties":{"version":{"type":"integer","minimum":1,"maximum":9007199254740991,"description":"The exact license-plan version pinned by this link.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].previous_attributes.oneOf.0.version","typeLabel":"integer"},"version_slug":{"type":"string","description":"Version slug of the license-plan row this link points at.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].previous_attributes.oneOf.0.version_slug","typeLabel":"string"},"included":{"type":"number","description":"Number of license assignments included with this plan for free.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].previous_attributes.oneOf.0.included","typeLabel":"number"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].previous_attributes.oneOf.0","typeLabel":"object"},{"type":"null","description":"Previous included / prepaid_only / version. Null when created or removed, or when no row scalar changed.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].previous_attributes.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].previous_attributes","typeLabel":"object | null"},"version_slug":{"type":"string","description":"Version slug of the license-plan row this link points at.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].version_slug","typeLabel":"string"},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].metadata.additionalProperties","typeLabel":"any"},"description":"Arbitrary key-value metadata defined by you on this link.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].metadata","typeLabel":"object"},"plan":{"description":"The effective plan for this license link — the pinned version, with the link's customize applied. Present when license plans are expanded.","type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the plan.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.id","typeLabel":"string"},"name":{"type":"string","description":"Display name of the plan.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.name","typeLabel":"string"},"description":{"oneOf":[{"type":"string","description":"Optional description of the plan.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.description.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional description of the plan.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.description.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.description","typeLabel":"string | null"},"group":{"oneOf":[{"type":"string","description":"Group identifier for organizing related plans. Plans in the same group are mutually exclusive.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.group.oneOf.0","typeLabel":"string"},{"type":"null","description":"Group identifier for organizing related plans. Plans in the same group are mutually exclusive.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.group.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.group","typeLabel":"string | null"},"version":{"type":"number","description":"Version number of the plan. Incremented when plan configuration changes.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.version","typeLabel":"number"},"add_on":{"type":"boolean","description":"Whether this is an add-on plan that can be attached alongside a main plan.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.add_on","typeLabel":"boolean"},"auto_enable":{"type":"boolean","description":"If true, this plan is automatically attached when a customer is created. Used for free plans.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.auto_enable","typeLabel":"boolean"},"price":{"oneOf":[{"type":"object","description":"Base recurring price for the plan. Null for free plans or usage-only plans.","required":["amount","interval"],"properties":{"amount":{"type":"number","description":"Base price amount for the plan, in major currency units (e.g. dollars).","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.price.oneOf.0.amount","typeLabel":"number"},"interval":{"enum":["one_off","week","month","quarter","semi_annual","year"],"type":"string","description":"Billing interval (e.g. 'month', 'year').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.price.oneOf.0.interval","typeLabel":"enum\u003cstring>"},"additional_currencies":{"description":"Base price amounts in additional currencies. The base 'amount' is in the org's default currency.","type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.price.oneOf.0.additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Price amount in this currency. Set explicitly per currency, not converted from the base amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.price.oneOf.0.additional_currencies.items.[INDEX].amount","typeLabel":"number"}},"required":["currency","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.price.oneOf.0.additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.price.oneOf.0.additional_currencies","typeLabel":"object[]"},"interval_count":{"type":"number","description":"Number of intervals per billing cycle. Defaults to 1.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.price.oneOf.0.interval_count","typeLabel":"number"},"display":{"description":"Display text for showing this price in pricing pages.","type":"object","properties":{"primary_text":{"type":"string","description":"Main display text (e.g. '$10' or '100 messages').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.price.oneOf.0.display.primary_text","typeLabel":"string"},"secondary_text":{"type":"string","description":"Secondary display text (e.g. 'per month' or 'then $0.5 per 100').","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.price.oneOf.0.display.secondary_text","typeLabel":"string"}},"required":["primary_text"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.price.oneOf.0.display","typeLabel":"object"},"processors":{"description":"Payment processors this base price is connected to. Omitted when unset.","x-atmn-mapping":true,"type":"object","properties":{"stripe":{"oneOf":[{"type":"object","required":["price_id"],"properties":{"price_id":{"type":"string","description":"Stripe price ID. For prepaid with included > 0 this is the V2 price.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.price.oneOf.0.processors.stripe.oneOf.0.price_id","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.price.oneOf.0.processors.stripe.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.price.oneOf.0.processors.stripe.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.price.oneOf.0.processors.stripe","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.price.oneOf.0.processors","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.price.oneOf.0","typeLabel":"object"},{"type":"null","description":"Base recurring price for the plan. Null for free plans or usage-only plans.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.price.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.price","typeLabel":"object | null"},"items":{"description":"Feature configurations included in this plan. Each item defines included units, pricing, and reset behavior for a feature.","type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"The ID of the feature this item configures.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_id","typeLabel":"string"},"included":{"type":"number","description":"Number of free units included. For consumable features, balance resets to this number each interval.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].included","typeLabel":"number"},"unlimited":{"type":"boolean","description":"Whether the customer has unlimited access to this feature.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].unlimited","typeLabel":"boolean"},"reset":{"oneOf":[{"type":"object","description":"Reset configuration for consumable features. Null for non-consumable features like seats where usage persists across billing cycles.","required":["interval"],"properties":{"interval":{"enum":["one_off","minute","hour","day","week","month","quarter","semi_annual","year"],"type":"string","description":"The interval at which the feature balance resets (e.g. 'month', 'year'). For consumable features, usage resets to 0 and included units are restored.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].reset.oneOf.0.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","description":"Number of intervals between resets. Defaults to 1.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].reset.oneOf.0.interval_count","typeLabel":"number"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].reset.oneOf.0","typeLabel":"object"},{"type":"null","description":"Reset configuration for consumable features. Null for non-consumable features like seats where usage persists across billing cycles.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].reset.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].reset","typeLabel":"object | null"},"price":{"oneOf":[{"type":"object","description":"Pricing configuration for usage beyond included units. Null if feature is entirely free.","required":["interval","billing_units","billing_method","max_purchase"],"properties":{"interval":{"enum":["one_off","week","month","quarter","semi_annual","year"],"type":"string","description":"Billing interval for this price. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].price.oneOf.0.interval","typeLabel":"enum\u003cstring>"},"billing_units":{"type":"number","description":"Number of units per price increment. Usage is rounded UP to the nearest billing_units when billed (e.g. billing_units=100 means 101 usage rounds to 200).","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].price.oneOf.0.billing_units","typeLabel":"number"},"billing_method":{"enum":["prepaid","usage_based"],"type":"string","description":"'prepaid' for features like seats where customers pay upfront, 'usage_based' for pay-as-you-go after included usage.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].price.oneOf.0.billing_method","typeLabel":"enum\u003cstring>"},"max_purchase":{"oneOf":[{"type":"number","description":"Maximum units a customer can purchase beyond included. E.g. if included=100 and max_purchase=300, customer can use up to 400 total before usage is capped. Null for no limit.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].price.oneOf.0.max_purchase.oneOf.0","typeLabel":"number"},{"type":"null","description":"Maximum units a customer can purchase beyond included. E.g. if included=100 and max_purchase=300, customer can use up to 400 total before usage is capped. Null for no limit.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].price.oneOf.0.max_purchase.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].price.oneOf.0.max_purchase","typeLabel":"number | null"},"amount":{"type":"number","description":"Price per billing_units after included usage is consumed. Mutually exclusive with tiers.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].price.oneOf.0.amount","typeLabel":"number"},"additional_currencies":{"description":"Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers' (tiered prices carry per-currency amounts on each tier).","type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].price.oneOf.0.additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Price amount in this currency. Set explicitly per currency, not converted from the base amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].price.oneOf.0.additional_currencies.items.[INDEX].amount","typeLabel":"number"}},"required":["currency","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].price.oneOf.0.additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].price.oneOf.0.additional_currencies","typeLabel":"object[]"},"tiers":{"description":"Tiered pricing configuration. Each tier's 'to' INCLUDES the included amount. Either 'tiers' or 'amount' is required.","type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].price.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","const":"inf","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].price.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].price.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | string"},"amount":{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].price.oneOf.0.tiers.items.[INDEX].amount","typeLabel":"number"},"flat_amount":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].price.oneOf.0.tiers.items.[INDEX].flat_amount","typeLabel":"number"},"additional_currencies":{"type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].price.oneOf.0.tiers.items.[INDEX].additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Per-unit amount for this tier in this currency.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].price.oneOf.0.tiers.items.[INDEX].additional_currencies.items.[INDEX].amount","typeLabel":"number"},"flat_amount":{"type":"number","description":"Flat amount for this tier in this currency, if the tier uses one.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].price.oneOf.0.tiers.items.[INDEX].additional_currencies.items.[INDEX].flat_amount","typeLabel":"number"}},"required":["currency"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].price.oneOf.0.tiers.items.[INDEX].additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].price.oneOf.0.tiers.items.[INDEX].additional_currencies","typeLabel":"object[]"}},"required":["to","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].price.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].price.oneOf.0.tiers","typeLabel":"object[]"},"tier_behavior":{"enum":["graduated","volume"],"type":"string","description":"How tiers price usage. 'graduated' (default) charges each unit at the rate of the tier it falls in. 'volume' picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier's rate plus its flat_amount.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].price.oneOf.0.tier_behavior","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","description":"Number of intervals per billing cycle. Defaults to 1.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].price.oneOf.0.interval_count","typeLabel":"number"},"processors":{"description":"Payment processors this item price is connected to. Omitted when unset.","x-atmn-mapping":true,"type":"object","properties":{"stripe":{"oneOf":[{"type":"object","required":["price_id"],"properties":{"price_id":{"type":"string","description":"Stripe price ID. For prepaid with included > 0 this is the V2 price.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].price.oneOf.0.processors.stripe.oneOf.0.price_id","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].price.oneOf.0.processors.stripe.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].price.oneOf.0.processors.stripe.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].price.oneOf.0.processors.stripe","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].price.oneOf.0.processors","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].price.oneOf.0","typeLabel":"object"},{"type":"null","description":"Pricing configuration for usage beyond included units. Null if feature is entirely free.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].price.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].price","typeLabel":"object | null"},"threshold_billing":{"oneOf":[{"type":"object","description":"Bills this many feature units when outstanding overage reaches it.","required":["threshold"],"properties":{"threshold":{"type":"number","exclusiveMinimum":0,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].threshold_billing.oneOf.0.threshold","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].threshold_billing.oneOf.0","typeLabel":"object"},{"type":"null","description":"Bills this many feature units when outstanding overage reaches it.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].threshold_billing.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].threshold_billing","typeLabel":"object | null"},"feature":{"description":"The full feature object if expanded.","type":"object","properties":{"id":{"type":"string","description":"The ID of the feature, used to refer to it in other API calls like /track or /check.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature.id","typeLabel":"string"},"type":{"enum":["static","boolean","single_use","continuous_use","credit_system","ai_credit_system"],"type":"string","description":"The type of the feature","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature.type","typeLabel":"enum\u003cstring>"},"name":{"oneOf":[{"type":"string","description":"The name of the feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature.name.oneOf.0","typeLabel":"string"},{"type":"null","description":"The name of the feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature.name","typeLabel":"string | null"},"display":{"oneOf":[{"type":"object","description":"Singular and plural display names for the feature.","required":["singular","plural"],"properties":{"singular":{"type":"string","description":"The singular display name for the feature.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature.display.oneOf.0.singular","typeLabel":"string"},"plural":{"type":"string","description":"The plural display name for the feature.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature.display.oneOf.0.plural","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature.display.oneOf.0","typeLabel":"object"},{"type":"null","description":"Singular and plural display names for the feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature.display.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature.display","typeLabel":"object | null"},"credit_schema":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"metered_feature_id":{"type":"string","description":"The ID of the metered feature (should be a single_use feature).","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature.credit_schema.oneOf.0.items.[INDEX].metered_feature_id","typeLabel":"string"},"credit_cost":{"type":"number","description":"The credit cost of the metered feature.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature.credit_schema.oneOf.0.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["metered_feature_id","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature.credit_schema.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Credit cost schema for credit system features.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature.credit_schema.oneOf.0","typeLabel":"object[]"},{"type":"null","description":"Credit cost schema for credit system features.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature.credit_schema.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature.credit_schema","typeLabel":"object[] | null"},"archived":{"oneOf":[{"type":"boolean","description":"Whether or not the feature is archived.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature.archived.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether or not the feature is archived.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature.archived.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature.archived","typeLabel":"boolean | null"}},"required":["id","type"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature","typeLabel":"object"},"pooled":{"type":"boolean","default":false,"description":"Whether entity-level grants contribute to a shared customer balance.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].pooled","typeLabel":"boolean"},"display":{"description":"Display text for showing this item in pricing pages.","type":"object","properties":{"primary_text":{"type":"string","description":"Main display text (e.g. '$10' or '100 messages').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].display.primary_text","typeLabel":"string"},"secondary_text":{"type":"string","description":"Secondary display text (e.g. 'per month' or 'then $0.5 per 100').","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].display.secondary_text","typeLabel":"string"}},"required":["primary_text"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].display","typeLabel":"object"},"rollover":{"description":"Rollover configuration for unused units. If set, unused included units roll over to the next period.","type":"object","properties":{"max":{"oneOf":[{"type":"number","description":"Maximum rollover units. Null for unlimited rollover.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].rollover.max.oneOf.0","typeLabel":"number"},{"type":"null","description":"Maximum rollover units. Null for unlimited rollover.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].rollover.max.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].rollover.max","typeLabel":"number | null"},"expiry_duration_type":{"enum":["month","forever"],"type":"string","description":"When rolled over units expire.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].rollover.expiry_duration_type","typeLabel":"enum\u003cstring>"},"max_percentage":{"oneOf":[{"type":"number","description":"Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].rollover.max_percentage.oneOf.0","typeLabel":"number"},{"type":"null","description":"Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].rollover.max_percentage.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].rollover.max_percentage","typeLabel":"number | null"},"expiry_duration_length":{"type":"number","description":"Number of periods before expiry.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].rollover.expiry_duration_length","typeLabel":"number"}},"required":["max","expiry_duration_type"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].rollover","typeLabel":"object"},"expiry":{"oneOf":[{"type":"object","description":"Purchased units expire this long after each purchase. One-off prepaid consumable items only.","required":["duration","length"],"properties":{"duration":{"enum":["day","week","month","year"],"type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].expiry.oneOf.0.duration","typeLabel":"enum\u003cstring>"},"length":{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].expiry.oneOf.0.length","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].expiry.oneOf.0","typeLabel":"object"},{"type":"null","description":"Purchased units expire this long after each purchase. One-off prepaid consumable items only.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].expiry.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].expiry","typeLabel":"object | null"},"feature_override":{"description":"Overrides fields of this item's feature for customers on this plan (e.g. a credit system's credit_schema).","type":"object","properties":{"credit_schema":{"description":"For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.","type":"array","items":{"oneOf":[{"type":"object","required":["metered_feature_id","tier_behavior","tiers"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature that draws from this credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.metered_feature_id","typeLabel":"string"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers","typeLabel":"object[]"},"billing_units":{"type":"number","exclusiveMinimum":0,"description":"Number of metered-feature units priced together. Defaults to one when omitted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.billing_units","typeLabel":"number"},"dimensions":{"description":"Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies.","type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"oneOf":[{"type":"object","required":["match","tier_behavior","tiers"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.match","typeLabel":"object"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers","typeLabel":"object[]"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["match","credit_cost"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.match","typeLabel":"object"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group when this dimension matches.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.credit_cost","typeLabel":"number"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions","typeLabel":"object"},"multipliers":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"object","properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.match","typeLabel":"object"},"factor":{"type":"number","exclusiveMinimum":0,"description":"Multiplies the matched rate. All matching multipliers stack.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.factor","typeLabel":"number"},"add":{"type":"number","description":"Added to the rate after every factor is applied, in credits per billing-unit group.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.add","typeLabel":"number"}},"required":["match"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties","typeLabel":"object"},"description":"Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["metered_feature_id","credit_cost"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature that draws from this credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.metered_feature_id","typeLabel":"string"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.credit_cost","typeLabel":"number"},"billing_units":{"type":"number","exclusiveMinimum":0,"description":"Number of metered-feature units priced together. Defaults to one when omitted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.billing_units","typeLabel":"number"},"dimensions":{"description":"Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies.","type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"oneOf":[{"type":"object","required":["match","tier_behavior","tiers"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.match","typeLabel":"object"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers","typeLabel":"object[]"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["match","credit_cost"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.match","typeLabel":"object"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group when this dimension matches.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.credit_cost","typeLabel":"number"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions","typeLabel":"object"},"multipliers":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"object","properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.match","typeLabel":"object"},"factor":{"type":"number","exclusiveMinimum":0,"description":"Multiplies the matched rate. All matching multipliers stack.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.factor","typeLabel":"number"},"add":{"type":"number","description":"Added to the rate after every factor is applied, in credits per billing-unit group.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.add","typeLabel":"number"}},"required":["match"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties","typeLabel":"object"},"description":"Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["metered_feature_id","excluded"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature to remove from the credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2.metered_feature_id","typeLabel":"string"},"excluded":{"description":"Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.","type":"boolean","const":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2.excluded","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.credit_schema","typeLabel":"object[]"},"markups":{"description":"For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.","type":"object","properties":{"default_markup":{"type":"number","minimum":-100,"description":"Default percentage markup for customers on this plan. Use -100 to make usage free.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.markups.default_markup","typeLabel":"number"},"provider_markups":{"oneOf":[{"type":"object","description":"Per-provider markup percentages for customers on this plan.","additionalProperties":{"type":"object","properties":{"markup":{"type":"number","minimum":-100,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0.additionalProperties.markup","typeLabel":"number"}},"required":["markup"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0","typeLabel":"object"},{"type":"null","description":"Per-provider markup percentages for customers on this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.markups.provider_markups.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.markups.provider_markups","typeLabel":"object | null"},"model_markups":{"oneOf":[{"type":"object","description":"Per-model markup overrides for customers on this plan.","additionalProperties":{"type":"object","properties":{"markup":{"type":"number","minimum":-100,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.markup","typeLabel":"number"},"input_cost":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.input_cost","typeLabel":"number"},"output_cost":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.output_cost","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.markups.model_markups.oneOf.0","typeLabel":"object"},{"type":"null","description":"Per-model markup overrides for customers on this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.markups.model_markups.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.markups.model_markups","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override.markups","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX].feature_override","typeLabel":"object"}},"required":["feature_id","included","unlimited","reset","price"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.\\items","typeLabel":"object[]"},"created_at":{"type":"number","description":"Unix timestamp (ms) when the plan was created.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.created_at","typeLabel":"number"},"env":{"enum":["sandbox","live"],"type":"string","description":"Environment this plan belongs to ('sandbox' or 'live').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.env","typeLabel":"enum\u003cstring>"},"archived":{"type":"boolean","description":"Whether the plan is archived. Archived plans cannot be attached to new customers.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.archived","typeLabel":"boolean"},"config":{"description":"Miscellaneous plan-level configuration flags.","type":"object","properties":{"ignore_past_due":{"type":"boolean","default":false,"description":"If true, entitlements attached to this plan will still reset on schedule even when the customer's product is in a past_due state.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.config.ignore_past_due","typeLabel":"boolean"},"anchor_to_month_start":{"type":"boolean","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.config.anchor_to_month_start","typeLabel":"boolean"}},"required":["ignore_past_due"],"additionalProperties":false,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.config","typeLabel":"object"},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.metadata.additionalProperties","typeLabel":"any"},"description":"Arbitrary key-value metadata defined by you for your own use. Shared across all versions of the plan.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.metadata","typeLabel":"object"},"base_variant_id":{"oneOf":[{"type":"string","description":"Deprecated. Use variant_details.base_plan_id instead. If this is a variant, the ID of the base plan it was created from.","deprecated":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.base_variant_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Deprecated. Use variant_details.base_plan_id instead. If this is a variant, the ID of the base plan it was created from.","deprecated":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.base_variant_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.base_variant_id","typeLabel":"string | null"},"version_slug":{"oneOf":[{"type":"string","description":"User-facing version identity. Defaults to v{n} when the version is minted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.version_slug.oneOf.0","typeLabel":"string"},{"type":"null","description":"User-facing version identity. Defaults to v{n} when the version is minted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.version_slug.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.version_slug","typeLabel":"string | null"},"active":{"type":"boolean","description":"Whether this is the active version of the plan. At most one version is active.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.active","typeLabel":"boolean"},"processors":{"description":"Payment processors this plan is connected to. Omitted when unset.","x-atmn-mapping":true,"type":"object","properties":{"stripe":{"oneOf":[{"type":"object","required":["product_id"],"properties":{"product_id":{"type":"string","description":"Stripe product ID this plan is billed under.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.processors.stripe.oneOf.0.product_id","typeLabel":"string"},"additional_product_ids":{"type":"array","items":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.processors.stripe.oneOf.0.additional_product_ids.items.[INDEX]","typeLabel":"string"},"description":"Extra Stripe product IDs aliased to this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.processors.stripe.oneOf.0.additional_product_ids","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.processors.stripe.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.processors.stripe.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.processors.stripe","typeLabel":"object | null"},"revenuecat":{"oneOf":[{"type":"object","required":["products"],"properties":{"products":{"description":"Every RevenueCat product that maps to this plan. Replaces the current set.","type":"array","items":{"type":"object","properties":{"product_id":{"type":"string","description":"RevenueCat product ID that grants this plan when purchased.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.processors.revenuecat.oneOf.0.products.items.[INDEX].product_id","typeLabel":"string"},"feature_quantities":{"description":"Prepaid quantities granted when this specific RevenueCat product is purchased, in feature units.","type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.processors.revenuecat.oneOf.0.products.items.[INDEX].feature_quantities.items.[INDEX].feature_id","typeLabel":"string"},"quantity":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.processors.revenuecat.oneOf.0.products.items.[INDEX].feature_quantities.items.[INDEX].quantity","typeLabel":"number"}},"required":["feature_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.processors.revenuecat.oneOf.0.products.items.[INDEX].feature_quantities.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.processors.revenuecat.oneOf.0.products.items.[INDEX].feature_quantities","typeLabel":"object[]"}},"required":["product_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.processors.revenuecat.oneOf.0.products.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.processors.revenuecat.oneOf.0.products","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.processors.revenuecat.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.processors.revenuecat.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.processors.revenuecat","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.processors","typeLabel":"object"},"free_trial":{"description":"Free trial configuration. If set, new customers can try this plan before being charged.","type":"object","properties":{"duration_length":{"type":"number","description":"Number of duration_type periods the trial lasts.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.free_trial.duration_length","typeLabel":"number"},"duration_type":{"enum":["day","month","year"],"type":"string","description":"Unit of time for the trial duration ('day', 'month', 'year').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.free_trial.duration_type","typeLabel":"enum\u003cstring>"},"card_required":{"type":"boolean","description":"Whether a payment method is required to start the trial. If true, customer will be charged after trial ends.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.free_trial.card_required","typeLabel":"boolean"},"on_end":{"oneOf":[{"type":"string","description":"Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.","enum":["bill","revert"],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.free_trial.on_end.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.free_trial.on_end.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.free_trial.on_end","typeLabel":"enum\u003cstring> | null"}},"required":["duration_length","duration_type","card_required"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.free_trial","typeLabel":"object"},"billing_controls":{"description":"Plan-level billing controls used as customer defaults.","type":"object","properties":{"auto_topups":{"description":"List of auto top-up configurations per feature.","type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"The ID of the feature (credit balance) to auto top-up.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.auto_topups.items.[INDEX].feature_id","typeLabel":"string"},"enabled":{"type":"boolean","default":false,"description":"Whether auto top-up is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.auto_topups.items.[INDEX].enabled","typeLabel":"boolean"},"threshold":{"type":"number","description":"When the balance drops below this threshold, an auto top-up will be purchased.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.auto_topups.items.[INDEX].threshold","typeLabel":"number"},"quantity":{"type":"number","minimum":1,"description":"Amount of credits to add per auto top-up.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.auto_topups.items.[INDEX].quantity","typeLabel":"number"},"purchase_limit":{"description":"Optional limit on auto top-ups per window, by number of top-ups or amount charged.","type":"object","properties":{"interval":{"enum":["hour","day","week","month"],"type":"string","description":"The time interval for the purchase limit window.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.auto_topups.items.[INDEX].purchase_limit.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","minimum":1,"default":1,"description":"Number of intervals in the purchase limit window.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.auto_topups.items.[INDEX].purchase_limit.interval_count","typeLabel":"number"},"limit":{"type":"number","exclusiveMinimum":0,"description":"Maximum allowed within the interval: a number of auto top-ups when limit_type is count, or a total charge (e.g. 500 for $500, pre-tax) when limit_type is amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.auto_topups.items.[INDEX].purchase_limit.limit","typeLabel":"number"},"limit_type":{"enum":["count","amount"],"type":"string","description":"What `limit` caps: the number of auto top-ups (`count`, default) or the total amount charged for them, in the customer's currency (`amount`).","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.auto_topups.items.[INDEX].purchase_limit.limit_type","typeLabel":"enum\u003cstring>"}},"required":["interval","interval_count","limit"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.auto_topups.items.[INDEX].purchase_limit","typeLabel":"object"},"invoice_mode":{"type":"boolean","description":"When true, auto top-up creates a send_invoice invoice instead of auto-charging.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.auto_topups.items.[INDEX].invoice_mode","typeLabel":"boolean"}},"required":["feature_id","enabled","threshold","quantity"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.auto_topups.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.auto_topups","typeLabel":"object[]"},"spend_limits":{"description":"List of overage spend limits per feature (caps overage spend).","type":"array","items":{"type":"object","properties":{"enabled":{"type":"boolean","default":false,"description":"Whether the overage spend limit is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.spend_limits.items.[INDEX].enabled","typeLabel":"boolean"},"feature_id":{"type":"string","description":"Optional feature ID this spend limit applies to.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.spend_limits.items.[INDEX].feature_id","typeLabel":"string"},"limit_type":{"enum":["absolute","usage_percentage"],"type":"string","description":"How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.spend_limits.items.[INDEX].limit_type","typeLabel":"enum\u003cstring>"},"overage_limit":{"type":"number","minimum":0,"description":"Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.spend_limits.items.[INDEX].overage_limit","typeLabel":"number"},"skip_overage_billing":{"type":"boolean","description":"When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.spend_limits.items.[INDEX].skip_overage_billing","typeLabel":"boolean"}},"required":["enabled"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.spend_limits.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.spend_limits","typeLabel":"object[]"},"usage_limits":{"description":"List of hard usage caps per feature (max units per interval).","type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"The feature this usage limit applies to.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.usage_limits.items.[INDEX].feature_id","typeLabel":"string"},"enabled":{"type":"boolean","default":true,"description":"Whether this usage limit is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.usage_limits.items.[INDEX].enabled","typeLabel":"boolean"},"limit":{"type":"number","minimum":0,"description":"Maximum units allowed per interval.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.usage_limits.items.[INDEX].limit","typeLabel":"number"},"interval":{"enum":["day","week","month","year"],"type":"string","description":"Interval for the cap, aligned to the customer's billing cycle.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.usage_limits.items.[INDEX].interval","typeLabel":"enum\u003cstring>"},"anchor":{"enum":["billing_cycle","utc"],"type":"string","description":"Window alignment. 'billing_cycle' phases the interval to the customer's renewal time; 'utc' aligns to the UTC calendar.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.usage_limits.items.[INDEX].anchor","typeLabel":"enum\u003cstring>"},"filter":{"description":"When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.","type":"object","properties":{"properties":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.usage_limits.items.[INDEX].filter.properties.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.usage_limits.items.[INDEX].filter.properties","typeLabel":"object"}},"required":["properties"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.usage_limits.items.[INDEX].filter","typeLabel":"object"}},"required":["feature_id","enabled","limit","interval"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.usage_limits.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.usage_limits","typeLabel":"object[]"},"usage_alerts":{"description":"List of usage alert configurations per feature.","type":"array","items":{"type":"object","properties":{"enabled":{"type":"boolean","default":true,"description":"Whether this usage alert is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.usage_alerts.items.[INDEX].enabled","typeLabel":"boolean"},"threshold":{"type":"number","description":"The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage. remaining and remaining_percentage accept negative values with basis balance, to alert once the balance is overdrawn.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.usage_alerts.items.[INDEX].threshold","typeLabel":"number"},"threshold_type":{"enum":["usage","usage_percentage","remaining","remaining_percentage"],"type":"string","description":"Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.usage_alerts.items.[INDEX].threshold_type","typeLabel":"enum\u003cstring>"},"basis":{"enum":["balance","included","recurring","usage_limit"],"type":"string","default":"balance","description":"What 100% means. balance: every grant on the feature. included: the plan allowance only. recurring: grants that reset. usage_limit: the cap of the usage limit with the same feature and filter.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.usage_alerts.items.[INDEX].basis","typeLabel":"enum\u003cstring>"},"feature_id":{"type":"string","description":"The feature ID this alert applies to.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.usage_alerts.items.[INDEX].feature_id","typeLabel":"string"},"filter":{"description":"Only valid with basis usage_limit. Points the alert at the usage limit carrying the same filter.","type":"object","properties":{"properties":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.usage_alerts.items.[INDEX].filter.properties.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.usage_alerts.items.[INDEX].filter.properties","typeLabel":"object"}},"required":["properties"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.usage_alerts.items.[INDEX].filter","typeLabel":"object"},"name":{"type":"string","description":"Optional user-defined label to distinguish multiple alerts on the same feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.usage_alerts.items.[INDEX].name","typeLabel":"string"}},"required":["enabled","threshold","threshold_type","basis"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.usage_alerts.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.usage_alerts","typeLabel":"object[]"},"overage_allowed":{"description":"List of overage allowed controls per feature. When enabled, usage can exceed balance.","type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"The feature ID this overage allowed control applies to.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.overage_allowed.items.[INDEX].feature_id","typeLabel":"string"},"enabled":{"type":"boolean","default":false,"description":"Whether overage is allowed for this feature.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.overage_allowed.items.[INDEX].enabled","typeLabel":"boolean"}},"required":["feature_id","enabled"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.overage_allowed.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls.overage_allowed","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.billing_controls","typeLabel":"object"},"customer_eligibility":{"type":"object","properties":{"attach_action":{"enum":["activate","upgrade","downgrade","none","purchase"],"type":"string","description":"The action that would occur if this plan were attached to the customer.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.customer_eligibility.attach_action","typeLabel":"enum\u003cstring>"},"trial_available":{"type":"boolean","description":"Whether the trial on this plan is available to this customer. For example, if the customer used the trial in the past, this will be false.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.customer_eligibility.trial_available","typeLabel":"boolean"},"status":{"enum":["active","scheduled"],"type":"string","description":"The customer's current status with this plan. 'active' if attached, 'scheduled' if pending activation.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.customer_eligibility.status","typeLabel":"enum\u003cstring>"},"canceling":{"type":"boolean","description":"Whether the customer's active instance of this plan is set to cancel.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.customer_eligibility.canceling","typeLabel":"boolean"},"trialing":{"type":"boolean","description":"Whether the customer is currently on a free trial of this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.customer_eligibility.trialing","typeLabel":"boolean"}},"required":["attach_action"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.customer_eligibility","typeLabel":"object"},"variant_details":{"description":"Details about how this variant relates to its latest base plan.","type":"object","properties":{"base_plan_id":{"type":"string","description":"The ID of the base plan this variant was derived from.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.base_plan_id","typeLabel":"string"},"customize":{"description":"The customization that transforms the base plan into this variant.","type":"object","properties":{"price":{"oneOf":[{"type":"object","title":"BasePrice","description":"Override the base price of the plan. Pass null to remove the base price.","required":["amount","interval"],"properties":{"amount":{"type":"number","description":"Base price amount for the plan, in major currency units (e.g. dollars).","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.price.oneOf.0.amount","typeLabel":"number"},"interval":{"enum":["one_off","week","month","quarter","semi_annual","year"],"type":"string","description":"Billing interval (e.g. 'month', 'year').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.price.oneOf.0.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.price.oneOf.0.interval_count","typeLabel":"number"},"additional_currencies":{"description":"Base price amounts in additional currencies. The base 'amount' is in the org's default currency.","type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.price.oneOf.0.additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Price amount in this currency. Set explicitly per currency, not converted from the base amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.price.oneOf.0.additional_currencies.items.[INDEX].amount","typeLabel":"number"}},"required":["currency","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.price.oneOf.0.additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.price.oneOf.0.additional_currencies","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.price.oneOf.0","typeLabel":"BasePrice · object"},{"type":"null","description":"Override the base price of the plan. Pass null to remove the base price.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.price.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.price","typeLabel":"BasePrice · object | null"},"add_items":{"description":"Items to add to the plan.","type":"array","items":{"title":"PlanItem","description":"Configuration for a feature item in a plan, including usage limits, pricing, and rollover settings.","type":"object","properties":{"feature_id":{"type":"string","description":"The ID of the feature to configure.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_id","typeLabel":"string"},"threshold_billing":{"oneOf":[{"type":"object","description":"Bills this many feature units when outstanding overage reaches it.","required":["threshold"],"properties":{"threshold":{"type":"number","exclusiveMinimum":0,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].threshold_billing.oneOf.0.threshold","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].threshold_billing.oneOf.0","typeLabel":"object"},{"type":"null","description":"Bills this many feature units when outstanding overage reaches it.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].threshold_billing.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].threshold_billing","typeLabel":"object | null"},"included":{"type":"number","maximum":10000000000000,"description":"Number of free units included. Balance resets to this each interval for consumable features.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].included","typeLabel":"number"},"unlimited":{"type":"boolean","description":"If true, customer has unlimited access to this feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].unlimited","typeLabel":"boolean"},"pooled":{"type":"boolean","default":false,"description":"Whether entity-level grants contribute to a shared customer balance.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].pooled","typeLabel":"boolean"},"reset":{"description":"Reset configuration for consumable features. Omit for non-consumable features like seats.","type":"object","properties":{"interval":{"enum":["one_off","minute","hour","day","week","month","quarter","semi_annual","year"],"type":"string","description":"Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].reset.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].reset.interval_count","typeLabel":"number"}},"required":["interval"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].reset","typeLabel":"object"},"price":{"description":"Pricing for usage beyond included units. Omit for free features.","type":"object","properties":{"interval":{"enum":["one_off","week","month","quarter","semi_annual","year"],"type":"string","description":"Billing interval. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].price.interval","typeLabel":"enum\u003cstring>"},"billing_method":{"enum":["prepaid","usage_based"],"type":"string","description":"'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].price.billing_method","typeLabel":"enum\u003cstring>"},"amount":{"type":"number","description":"Price per billing_units after included usage. Either 'amount' or 'tiers' is required.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].price.amount","typeLabel":"number"},"additional_currencies":{"description":"Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers'.","type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].price.additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Price amount in this currency. Set explicitly per currency, not converted from the base amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].price.additional_currencies.items.[INDEX].amount","typeLabel":"number"}},"required":["currency","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].price.additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].price.additional_currencies","typeLabel":"object[]"},"tiers":{"description":"Tiered pricing. Either 'amount' or 'tiers' is required.","type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","const":"inf","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].to.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].to","typeLabel":"number | string"},"amount":{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].amount","typeLabel":"number"},"flat_amount":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].flat_amount","typeLabel":"number"},"additional_currencies":{"type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Per-unit amount for this tier in this currency.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX].amount","typeLabel":"number"},"flat_amount":{"type":"number","description":"Flat amount for this tier in this currency, if the tier uses one.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX].flat_amount","typeLabel":"number"}},"required":["currency"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies","typeLabel":"object[]"}},"required":["to","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].price.tiers.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].price.tiers","typeLabel":"object[]"},"tier_behavior":{"enum":["graduated","volume"],"type":"string","description":"How tiers price usage. 'graduated' (default) charges each unit at the rate of the tier it falls in. 'volume' picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier's rate plus its flat_amount.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].price.tier_behavior","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","description":"Number of intervals per billing cycle. Defaults to 1.","default":1,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].price.interval_count","typeLabel":"number"},"billing_units":{"type":"number","default":1,"description":"Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].price.billing_units","typeLabel":"number"},"max_purchase":{"oneOf":[{"type":"number","description":"Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].price.max_purchase.oneOf.0","typeLabel":"number"},{"type":"null","description":"Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].price.max_purchase.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].price.max_purchase","typeLabel":"number | null"}},"required":["interval","billing_method"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].price","typeLabel":"object"},"proration":{"description":"Proration settings for prepaid features. Controls mid-cycle quantity change billing.","type":"object","properties":{"on_increase":{"enum":["bill_immediately","prorate_immediately","prorate_next_cycle","bill_next_cycle"],"type":"string","description":"Billing behavior when quantity increases mid-cycle.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].proration.on_increase","typeLabel":"enum\u003cstring>"},"on_decrease":{"enum":["prorate","prorate_immediately","prorate_next_cycle","none","no_prorations"],"type":"string","description":"Credit behavior when quantity decreases mid-cycle.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].proration.on_decrease","typeLabel":"enum\u003cstring>"}},"required":["on_increase","on_decrease"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].proration","typeLabel":"object"},"rollover":{"description":"Rollover config for unused units. If set, unused included units carry over.","type":"object","properties":{"expiry_duration_type":{"enum":["month","forever"],"type":"string","description":"When rolled over units expire.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].rollover.expiry_duration_type","typeLabel":"enum\u003cstring>"},"max":{"type":"number","description":"Max rollover units. Omit for unlimited rollover.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].rollover.max","typeLabel":"number"},"max_percentage":{"type":"number","description":"Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].rollover.max_percentage","typeLabel":"number"},"expiry_duration_length":{"type":"number","description":"Number of periods before expiry.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].rollover.expiry_duration_length","typeLabel":"number"}},"required":["expiry_duration_type"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].rollover","typeLabel":"object"},"expiry":{"description":"Purchased units expire this long after each purchase. One-off prepaid consumable items only.","type":"object","properties":{"duration":{"enum":["day","week","month","year"],"type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].expiry.duration","typeLabel":"enum\u003cstring>"},"length":{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].expiry.length","typeLabel":"number"}},"required":["duration","length"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].expiry","typeLabel":"object"},"feature_override":{"description":"Overrides fields of this item's feature for customers on this plan (e.g. a credit system's credit_schema).","type":"object","properties":{"credit_schema":{"description":"For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.","type":"array","items":{"oneOf":[{"type":"object","required":["metered_feature_id","tier_behavior","tiers"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature that draws from this credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.metered_feature_id","typeLabel":"string"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers","typeLabel":"object[]"},"billing_units":{"type":"number","exclusiveMinimum":0,"description":"Number of metered-feature units priced together. Defaults to one when omitted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.billing_units","typeLabel":"number"},"dimensions":{"description":"Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies.","type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"oneOf":[{"type":"object","required":["match","tier_behavior","tiers"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.match","typeLabel":"object"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers","typeLabel":"object[]"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["match","credit_cost"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.match","typeLabel":"object"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group when this dimension matches.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.credit_cost","typeLabel":"number"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions","typeLabel":"object"},"multipliers":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"object","properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.match","typeLabel":"object"},"factor":{"type":"number","exclusiveMinimum":0,"description":"Multiplies the matched rate. All matching multipliers stack.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.factor","typeLabel":"number"},"add":{"type":"number","description":"Added to the rate after every factor is applied, in credits per billing-unit group.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.add","typeLabel":"number"}},"required":["match"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties","typeLabel":"object"},"description":"Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["metered_feature_id","credit_cost"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature that draws from this credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.metered_feature_id","typeLabel":"string"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.credit_cost","typeLabel":"number"},"billing_units":{"type":"number","exclusiveMinimum":0,"description":"Number of metered-feature units priced together. Defaults to one when omitted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.billing_units","typeLabel":"number"},"dimensions":{"description":"Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies.","type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"oneOf":[{"type":"object","required":["match","tier_behavior","tiers"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.match","typeLabel":"object"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers","typeLabel":"object[]"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["match","credit_cost"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.match","typeLabel":"object"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group when this dimension matches.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.credit_cost","typeLabel":"number"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions","typeLabel":"object"},"multipliers":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"object","properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.match","typeLabel":"object"},"factor":{"type":"number","exclusiveMinimum":0,"description":"Multiplies the matched rate. All matching multipliers stack.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.factor","typeLabel":"number"},"add":{"type":"number","description":"Added to the rate after every factor is applied, in credits per billing-unit group.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.add","typeLabel":"number"}},"required":["match"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties","typeLabel":"object"},"description":"Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["metered_feature_id","excluded"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature to remove from the credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2.metered_feature_id","typeLabel":"string"},"excluded":{"description":"Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.","type":"boolean","const":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2.excluded","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema","typeLabel":"object[]"},"markups":{"description":"For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.","type":"object","properties":{"default_markup":{"type":"number","minimum":-100,"description":"Default percentage markup for customers on this plan. Use -100 to make usage free.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.default_markup","typeLabel":"number"},"provider_markups":{"oneOf":[{"type":"object","description":"Per-provider markup percentages for customers on this plan.","additionalProperties":{"type":"object","properties":{"markup":{"type":"number","minimum":-100,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0.additionalProperties.markup","typeLabel":"number"}},"required":["markup"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0","typeLabel":"object"},{"type":"null","description":"Per-provider markup percentages for customers on this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.provider_markups","typeLabel":"object | null"},"model_markups":{"oneOf":[{"type":"object","description":"Per-model markup overrides for customers on this plan.","additionalProperties":{"type":"object","properties":{"markup":{"type":"number","minimum":-100,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.markup","typeLabel":"number"},"input_cost":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.input_cost","typeLabel":"number"},"output_cost":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.output_cost","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0","typeLabel":"object"},{"type":"null","description":"Per-model markup overrides for customers on this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.model_markups","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX].feature_override","typeLabel":"object"}},"required":["feature_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items.items.[INDEX]","typeLabel":"PlanItem · object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.add_items","typeLabel":"PlanItem · object[]"},"remove_items":{"description":"Filters selecting items to remove from the plan.","type":"array","items":{"title":"PlanItemFilter","description":"Filter for matching plan items. All provided fields must match (AND).","type":"object","properties":{"feature_id":{"type":"string","description":"Match items linked to this feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.remove_items.items.[INDEX].feature_id","typeLabel":"string"},"billing_method":{"enum":["prepaid","usage_based"],"type":"string","description":"Match items with this billing method (prepaid or usage_based).","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.remove_items.items.[INDEX].billing_method","typeLabel":"enum\u003cstring>"},"interval":{"oneOf":[{"type":"string","description":"Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.","enum":["one_off","week","month","quarter","semi_annual","year"],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.remove_items.items.[INDEX].interval.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"string","description":"Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.","enum":["one_off","minute","hour","day","week","month","quarter","semi_annual","year"],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.remove_items.items.[INDEX].interval.oneOf.1","typeLabel":"enum\u003cstring>"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.remove_items.items.[INDEX].interval","typeLabel":"enum\u003cstring>"},"interval_count":{"description":"Match items with this interval_count. Disambiguates between items that share an interval but differ in count.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.remove_items.items.[INDEX].interval_count","typeLabel":"integer"},"included":{"type":"number","maximum":10000000000000,"description":"Match items whose grant equals this included usage. Omitted is a wildcard.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.remove_items.items.[INDEX].included","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.remove_items.items.[INDEX]","typeLabel":"PlanItemFilter · object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.remove_items","typeLabel":"PlanItemFilter · object[]"},"free_trial":{"oneOf":[{"type":"object","title":"FreeTrialParams","description":"Override the plan's default free trial. Pass an object to set a custom trial, or null to remove the trial entirely.","required":["duration_length","duration_type","card_required"],"properties":{"duration_length":{"type":"number","description":"Number of duration_type periods the trial lasts.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.free_trial.oneOf.0.duration_length","typeLabel":"number"},"duration_type":{"enum":["day","month","year"],"type":"string","default":"month","description":"Unit of time for the trial ('day', 'month', 'year').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.free_trial.oneOf.0.duration_type","typeLabel":"enum\u003cstring>"},"card_required":{"type":"boolean","default":false,"description":"If true, a payment method is required to start the trial and the customer is charged when it ends. Defaults to false.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.free_trial.oneOf.0.card_required","typeLabel":"boolean"},"on_end":{"enum":["bill","revert"],"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.free_trial.oneOf.0.on_end","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.free_trial.oneOf.0","typeLabel":"FreeTrialParams · object"},{"type":"null","description":"Override the plan's default free trial. Pass an object to set a custom trial, or null to remove the trial entirely.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.free_trial.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.free_trial","typeLabel":"FreeTrialParams · object | null"},"billing_controls":{"description":"Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.","type":"object","properties":{"auto_topups":{"type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"The ID of the feature (credit balance) to auto top-up.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].feature_id","typeLabel":"string"},"enabled":{"type":"boolean","default":false,"description":"Whether auto top-up is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].enabled","typeLabel":"boolean"},"threshold":{"type":"number","description":"When the balance drops below this threshold, an auto top-up will be purchased.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].threshold","typeLabel":"number"},"quantity":{"type":"number","minimum":1,"description":"Amount of credits to add per auto top-up.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].quantity","typeLabel":"number"},"purchase_limit":{"description":"Optional rate limit to cap how often auto top-ups occur. Pass count or amount to set the current window's consumed top-ups or charged amount.","type":"object","properties":{"interval":{"enum":["hour","day","week","month"],"type":"string","description":"The time interval for the purchase limit window.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","minimum":1,"default":1,"description":"Number of intervals in the purchase limit window.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit.interval_count","typeLabel":"number"},"limit":{"type":"number","exclusiveMinimum":0,"description":"Maximum allowed within the interval: a number of auto top-ups when limit_type is count, or a total charge (e.g. 500 for $500, pre-tax) when limit_type is amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit.limit","typeLabel":"number"},"limit_type":{"enum":["count","amount"],"type":"string","description":"What `limit` caps: the number of auto top-ups (`count`, default) or the total amount charged for them, in the customer's currency (`amount`).","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit.limit_type","typeLabel":"enum\u003cstring>"},"count":{"type":"number","minimum":0,"description":"Set the current window's consumed auto top-up count. Omit to leave runtime state unchanged.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit.count","typeLabel":"number"},"amount":{"type":"number","minimum":0,"description":"Set the amount already charged by auto top-ups in the current window. Omit to leave runtime state unchanged.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit.amount","typeLabel":"number"}},"required":["interval","interval_count","limit"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit","typeLabel":"object"},"invoice_mode":{"type":"boolean","description":"When true, auto top-up creates a send_invoice invoice instead of auto-charging.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].invoice_mode","typeLabel":"boolean"}},"required":["feature_id","enabled","threshold","quantity"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.auto_topups","typeLabel":"object[]"},"spend_limits":{"type":"array","items":{"type":"object","properties":{"enabled":{"type":"boolean","default":false,"description":"Whether the overage spend limit is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.spend_limits.items.[INDEX].enabled","typeLabel":"boolean"},"feature_id":{"type":"string","description":"Optional feature ID this spend limit applies to.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.spend_limits.items.[INDEX].feature_id","typeLabel":"string"},"limit_type":{"enum":["absolute","usage_percentage"],"type":"string","description":"How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.spend_limits.items.[INDEX].limit_type","typeLabel":"enum\u003cstring>"},"overage_limit":{"type":"number","minimum":0,"description":"Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.spend_limits.items.[INDEX].overage_limit","typeLabel":"number"},"skip_overage_billing":{"type":"boolean","description":"When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.spend_limits.items.[INDEX].skip_overage_billing","typeLabel":"boolean"}},"required":["enabled"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.spend_limits.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.spend_limits","typeLabel":"object[]"},"usage_limits":{"type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"The feature this usage limit applies to.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.usage_limits.items.[INDEX].feature_id","typeLabel":"string"},"enabled":{"type":"boolean","default":true,"description":"Whether this usage limit is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.usage_limits.items.[INDEX].enabled","typeLabel":"boolean"},"limit":{"type":"number","minimum":0,"description":"Maximum units allowed per interval.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.usage_limits.items.[INDEX].limit","typeLabel":"number"},"interval":{"enum":["day","week","month","year"],"type":"string","description":"Interval for the cap, aligned to the customer's billing cycle.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.usage_limits.items.[INDEX].interval","typeLabel":"enum\u003cstring>"},"anchor":{"enum":["billing_cycle","utc"],"type":"string","description":"Window alignment. 'billing_cycle' phases the interval to the customer's renewal time; 'utc' aligns to the UTC calendar.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.usage_limits.items.[INDEX].anchor","typeLabel":"enum\u003cstring>"},"filter":{"description":"When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.","type":"object","properties":{"properties":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.usage_limits.items.[INDEX].filter.properties.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.usage_limits.items.[INDEX].filter.properties","typeLabel":"object"}},"required":["properties"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.usage_limits.items.[INDEX].filter","typeLabel":"object"}},"required":["feature_id","enabled","limit","interval"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.usage_limits.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.usage_limits","typeLabel":"object[]"},"usage_alerts":{"type":"array","items":{"type":"object","properties":{"enabled":{"type":"boolean","default":true,"description":"Whether this usage alert is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.usage_alerts.items.[INDEX].enabled","typeLabel":"boolean"},"threshold":{"type":"number","description":"The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage. remaining and remaining_percentage accept negative values with basis balance, to alert once the balance is overdrawn.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.usage_alerts.items.[INDEX].threshold","typeLabel":"number"},"threshold_type":{"enum":["usage","usage_percentage","remaining","remaining_percentage"],"type":"string","description":"Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.usage_alerts.items.[INDEX].threshold_type","typeLabel":"enum\u003cstring>"},"basis":{"enum":["balance","included","recurring","usage_limit"],"type":"string","default":"balance","description":"What 100% means. balance: every grant on the feature. included: the plan allowance only. recurring: grants that reset. usage_limit: the cap of the usage limit with the same feature and filter.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.usage_alerts.items.[INDEX].basis","typeLabel":"enum\u003cstring>"},"feature_id":{"type":"string","description":"The feature ID this alert applies to.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.usage_alerts.items.[INDEX].feature_id","typeLabel":"string"},"filter":{"description":"Only valid with basis usage_limit. Points the alert at the usage limit carrying the same filter.","type":"object","properties":{"properties":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.usage_alerts.items.[INDEX].filter.properties.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.usage_alerts.items.[INDEX].filter.properties","typeLabel":"object"}},"required":["properties"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.usage_alerts.items.[INDEX].filter","typeLabel":"object"},"name":{"type":"string","description":"Optional user-defined label to distinguish multiple alerts on the same feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.usage_alerts.items.[INDEX].name","typeLabel":"string"}},"required":["enabled","threshold","threshold_type","basis"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.usage_alerts.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.usage_alerts","typeLabel":"object[]"},"overage_allowed":{"type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"The feature ID this overage allowed control applies to.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.overage_allowed.items.[INDEX].feature_id","typeLabel":"string"},"enabled":{"type":"boolean","default":false,"description":"Whether overage is allowed for this feature.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.overage_allowed.items.[INDEX].enabled","typeLabel":"boolean"}},"required":["feature_id","enabled"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.overage_allowed.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls.overage_allowed","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.billing_controls","typeLabel":"object"},"upsert_licenses":{"description":"License links to add or override for this customer, keyed by license_plan_id. Omitted fields inherit the plan catalog link (included defaults to 1 when the license is not in the catalog). A bare entry restores the license to pure catalog inheritance.","type":"array","items":{"type":"object","properties":{"license_plan_id":{"type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].license_plan_id","typeLabel":"string"},"version_slug":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].version_slug","typeLabel":"string"},"included":{"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].included","typeLabel":"integer"},"prepaid_only":{"type":"boolean","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].prepaid_only","typeLabel":"boolean"},"customize":{"oneOf":[{"type":"object","properties":{"price":{"oneOf":[{"type":"object","title":"BasePrice","description":"Base price configuration for a plan.","required":["amount","interval"],"properties":{"amount":{"type":"number","description":"Base price amount for the plan, in major currency units (e.g. dollars).","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.amount","typeLabel":"number"},"interval":{"enum":["one_off","week","month","quarter","semi_annual","year"],"type":"string","description":"Billing interval (e.g. 'month', 'year').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.interval_count","typeLabel":"number"},"additional_currencies":{"description":"Base price amounts in additional currencies. The base 'amount' is in the org's default currency.","type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Price amount in this currency. Set explicitly per currency, not converted from the base amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.additional_currencies.items.[INDEX].amount","typeLabel":"number"}},"required":["currency","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.additional_currencies","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0","typeLabel":"BasePrice · object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price","typeLabel":"BasePrice · object | null"},"add_items":{"type":"array","items":{"title":"PlanItem","description":"Configuration for a feature item in a plan, including usage limits, pricing, and rollover settings.","type":"object","properties":{"feature_id":{"type":"string","description":"The ID of the feature to configure.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_id","typeLabel":"string"},"threshold_billing":{"oneOf":[{"type":"object","description":"Bills this many feature units when outstanding overage reaches it.","required":["threshold"],"properties":{"threshold":{"type":"number","exclusiveMinimum":0,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].threshold_billing.oneOf.0.threshold","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].threshold_billing.oneOf.0","typeLabel":"object"},{"type":"null","description":"Bills this many feature units when outstanding overage reaches it.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].threshold_billing.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].threshold_billing","typeLabel":"object | null"},"included":{"type":"number","maximum":10000000000000,"description":"Number of free units included. Balance resets to this each interval for consumable features.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].included","typeLabel":"number"},"unlimited":{"type":"boolean","description":"If true, customer has unlimited access to this feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].unlimited","typeLabel":"boolean"},"pooled":{"type":"boolean","default":false,"description":"Whether entity-level grants contribute to a shared customer balance.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].pooled","typeLabel":"boolean"},"reset":{"description":"Reset configuration for consumable features. Omit for non-consumable features like seats.","type":"object","properties":{"interval":{"enum":["one_off","minute","hour","day","week","month","quarter","semi_annual","year"],"type":"string","description":"Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].reset.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].reset.interval_count","typeLabel":"number"}},"required":["interval"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].reset","typeLabel":"object"},"price":{"description":"Pricing for usage beyond included units. Omit for free features.","type":"object","properties":{"interval":{"enum":["one_off","week","month","quarter","semi_annual","year"],"type":"string","description":"Billing interval. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.interval","typeLabel":"enum\u003cstring>"},"billing_method":{"enum":["prepaid","usage_based"],"type":"string","description":"'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.billing_method","typeLabel":"enum\u003cstring>"},"amount":{"type":"number","description":"Price per billing_units after included usage. Either 'amount' or 'tiers' is required.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.amount","typeLabel":"number"},"additional_currencies":{"description":"Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers'.","type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Price amount in this currency. Set explicitly per currency, not converted from the base amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.additional_currencies.items.[INDEX].amount","typeLabel":"number"}},"required":["currency","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.additional_currencies","typeLabel":"object[]"},"tiers":{"description":"Tiered pricing. Either 'amount' or 'tiers' is required.","type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","const":"inf","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].to.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].to","typeLabel":"number | string"},"amount":{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].amount","typeLabel":"number"},"flat_amount":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].flat_amount","typeLabel":"number"},"additional_currencies":{"type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Per-unit amount for this tier in this currency.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX].amount","typeLabel":"number"},"flat_amount":{"type":"number","description":"Flat amount for this tier in this currency, if the tier uses one.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX].flat_amount","typeLabel":"number"}},"required":["currency"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies","typeLabel":"object[]"}},"required":["to","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers","typeLabel":"object[]"},"tier_behavior":{"enum":["graduated","volume"],"type":"string","description":"How tiers price usage. 'graduated' (default) charges each unit at the rate of the tier it falls in. 'volume' picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier's rate plus its flat_amount.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tier_behavior","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","description":"Number of intervals per billing cycle. Defaults to 1.","default":1,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.interval_count","typeLabel":"number"},"billing_units":{"type":"number","default":1,"description":"Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.billing_units","typeLabel":"number"},"max_purchase":{"oneOf":[{"type":"number","description":"Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.max_purchase.oneOf.0","typeLabel":"number"},{"type":"null","description":"Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.max_purchase.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.max_purchase","typeLabel":"number | null"}},"required":["interval","billing_method"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price","typeLabel":"object"},"proration":{"description":"Proration settings for prepaid features. Controls mid-cycle quantity change billing.","type":"object","properties":{"on_increase":{"enum":["bill_immediately","prorate_immediately","prorate_next_cycle","bill_next_cycle"],"type":"string","description":"Billing behavior when quantity increases mid-cycle.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].proration.on_increase","typeLabel":"enum\u003cstring>"},"on_decrease":{"enum":["prorate","prorate_immediately","prorate_next_cycle","none","no_prorations"],"type":"string","description":"Credit behavior when quantity decreases mid-cycle.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].proration.on_decrease","typeLabel":"enum\u003cstring>"}},"required":["on_increase","on_decrease"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].proration","typeLabel":"object"},"rollover":{"description":"Rollover config for unused units. If set, unused included units carry over.","type":"object","properties":{"expiry_duration_type":{"enum":["month","forever"],"type":"string","description":"When rolled over units expire.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].rollover.expiry_duration_type","typeLabel":"enum\u003cstring>"},"max":{"type":"number","description":"Max rollover units. Omit for unlimited rollover.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].rollover.max","typeLabel":"number"},"max_percentage":{"type":"number","description":"Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].rollover.max_percentage","typeLabel":"number"},"expiry_duration_length":{"type":"number","description":"Number of periods before expiry.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].rollover.expiry_duration_length","typeLabel":"number"}},"required":["expiry_duration_type"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].rollover","typeLabel":"object"},"expiry":{"description":"Purchased units expire this long after each purchase. One-off prepaid consumable items only.","type":"object","properties":{"duration":{"enum":["day","week","month","year"],"type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].expiry.duration","typeLabel":"enum\u003cstring>"},"length":{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].expiry.length","typeLabel":"number"}},"required":["duration","length"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].expiry","typeLabel":"object"},"feature_override":{"description":"Overrides fields of this item's feature for customers on this plan (e.g. a credit system's credit_schema).","type":"object","properties":{"credit_schema":{"description":"For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.","type":"array","items":{"oneOf":[{"type":"object","required":["metered_feature_id","tier_behavior","tiers"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature that draws from this credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.metered_feature_id","typeLabel":"string"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers","typeLabel":"object[]"},"billing_units":{"type":"number","exclusiveMinimum":0,"description":"Number of metered-feature units priced together. Defaults to one when omitted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.billing_units","typeLabel":"number"},"dimensions":{"description":"Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies.","type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"oneOf":[{"type":"object","required":["match","tier_behavior","tiers"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.match","typeLabel":"object"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers","typeLabel":"object[]"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["match","credit_cost"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.match","typeLabel":"object"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group when this dimension matches.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.credit_cost","typeLabel":"number"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions","typeLabel":"object"},"multipliers":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"object","properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.match","typeLabel":"object"},"factor":{"type":"number","exclusiveMinimum":0,"description":"Multiplies the matched rate. All matching multipliers stack.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.factor","typeLabel":"number"},"add":{"type":"number","description":"Added to the rate after every factor is applied, in credits per billing-unit group.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.add","typeLabel":"number"}},"required":["match"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties","typeLabel":"object"},"description":"Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["metered_feature_id","credit_cost"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature that draws from this credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.metered_feature_id","typeLabel":"string"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.credit_cost","typeLabel":"number"},"billing_units":{"type":"number","exclusiveMinimum":0,"description":"Number of metered-feature units priced together. Defaults to one when omitted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.billing_units","typeLabel":"number"},"dimensions":{"description":"Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies.","type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"oneOf":[{"type":"object","required":["match","tier_behavior","tiers"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.match","typeLabel":"object"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers","typeLabel":"object[]"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["match","credit_cost"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.match","typeLabel":"object"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group when this dimension matches.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.credit_cost","typeLabel":"number"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions","typeLabel":"object"},"multipliers":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"object","properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.match","typeLabel":"object"},"factor":{"type":"number","exclusiveMinimum":0,"description":"Multiplies the matched rate. All matching multipliers stack.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.factor","typeLabel":"number"},"add":{"type":"number","description":"Added to the rate after every factor is applied, in credits per billing-unit group.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.add","typeLabel":"number"}},"required":["match"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties","typeLabel":"object"},"description":"Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["metered_feature_id","excluded"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature to remove from the credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2.metered_feature_id","typeLabel":"string"},"excluded":{"description":"Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.","type":"boolean","const":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2.excluded","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema","typeLabel":"object[]"},"markups":{"description":"For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.","type":"object","properties":{"default_markup":{"type":"number","minimum":-100,"description":"Default percentage markup for customers on this plan. Use -100 to make usage free.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.default_markup","typeLabel":"number"},"provider_markups":{"oneOf":[{"type":"object","description":"Per-provider markup percentages for customers on this plan.","additionalProperties":{"type":"object","properties":{"markup":{"type":"number","minimum":-100,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0.additionalProperties.markup","typeLabel":"number"}},"required":["markup"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0","typeLabel":"object"},{"type":"null","description":"Per-provider markup percentages for customers on this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.provider_markups","typeLabel":"object | null"},"model_markups":{"oneOf":[{"type":"object","description":"Per-model markup overrides for customers on this plan.","additionalProperties":{"type":"object","properties":{"markup":{"type":"number","minimum":-100,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.markup","typeLabel":"number"},"input_cost":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.input_cost","typeLabel":"number"},"output_cost":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.output_cost","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0","typeLabel":"object"},{"type":"null","description":"Per-model markup overrides for customers on this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override","typeLabel":"object"}},"required":["feature_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX]","typeLabel":"PlanItem · object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items","typeLabel":"PlanItem · object[]"},"remove_items":{"type":"array","items":{"title":"PlanItemFilter","description":"Filter for matching plan items. All provided fields must match (AND).","type":"object","properties":{"feature_id":{"type":"string","description":"Match items linked to this feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].feature_id","typeLabel":"string"},"billing_method":{"enum":["prepaid","usage_based"],"type":"string","description":"Match items with this billing method (prepaid or usage_based).","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].billing_method","typeLabel":"enum\u003cstring>"},"interval":{"oneOf":[{"type":"string","description":"Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.","enum":["one_off","week","month","quarter","semi_annual","year"],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].interval.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"string","description":"Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.","enum":["one_off","minute","hour","day","week","month","quarter","semi_annual","year"],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].interval.oneOf.1","typeLabel":"enum\u003cstring>"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].interval","typeLabel":"enum\u003cstring>"},"interval_count":{"description":"Match items with this interval_count. Disambiguates between items that share an interval but differ in count.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].interval_count","typeLabel":"integer"},"included":{"type":"number","maximum":10000000000000,"description":"Match items whose grant equals this included usage. Omitted is a wildcard.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].included","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX]","typeLabel":"PlanItemFilter · object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items","typeLabel":"PlanItemFilter · object[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].customize","typeLabel":"object | null"},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].metadata.additionalProperties","typeLabel":"any"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX].metadata","typeLabel":"object"}},"required":["license_plan_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.upsert_licenses","typeLabel":"object[]"},"remove_licenses":{"description":"License links to drop, keyed by license_plan_id. Parallel to remove_items.","type":"array","items":{"type":"object","properties":{"license_plan_id":{"type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.remove_licenses.items.[INDEX].license_plan_id","typeLabel":"string"}},"required":["license_plan_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.remove_licenses.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize.remove_licenses","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details.customize","typeLabel":"object"}},"required":["base_plan_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan.variant_details","typeLabel":"object"}},"required":["id","name","description","group","version","add_on","auto_enable","price","items","created_at","env","archived","config","metadata","base_variant_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan","typeLabel":"object"},"plan_change":{"oneOf":[{"type":"object","description":"Diff of the license's effective plan. Null when created, removed, or the effective content is unchanged.","required":["previous_attributes","item_changes"],"properties":{"previous_attributes":{"oneOf":[{"type":"object","description":"Sparse map of scalar plan fields that changed, holding their previous values. Null when the plan is new.","properties":{"id":{"oneOf":[{"type":"string","description":"Unique identifier for the plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.id","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","description":"Display name of the plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.name","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","description":"Optional description of the plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.description.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional description of the plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.description.oneOf.1","typeLabel":"null"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.description.oneOf.2","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.description","typeLabel":"string · null · null"},"group":{"oneOf":[{"type":"string","description":"Group identifier for organizing related plans. Plans in the same group are mutually exclusive.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.group.oneOf.0","typeLabel":"string"},{"type":"null","description":"Group identifier for organizing related plans. Plans in the same group are mutually exclusive.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.group.oneOf.1","typeLabel":"null"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.group.oneOf.2","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.group","typeLabel":"string · null · null"},"add_on":{"oneOf":[{"type":"boolean","description":"Whether this is an add-on plan that can be attached alongside a main plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.add_on.oneOf.0","typeLabel":"boolean"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.add_on.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.add_on","typeLabel":"boolean | null"},"auto_enable":{"oneOf":[{"type":"boolean","description":"If true, this plan is automatically attached when a customer is created. Used for free plans.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.auto_enable.oneOf.0","typeLabel":"boolean"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.auto_enable.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.auto_enable","typeLabel":"boolean | null"},"config":{"oneOf":[{"type":"object","description":"Miscellaneous plan-level configuration flags.","required":["ignore_past_due"],"properties":{"ignore_past_due":{"type":"boolean","default":false,"description":"If true, entitlements attached to this plan will still reset on schedule even when the customer's product is in a past_due state.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.config.oneOf.0.ignore_past_due","typeLabel":"boolean"},"anchor_to_month_start":{"type":"boolean","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.config.oneOf.0.anchor_to_month_start","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.config.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.config.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.config","typeLabel":"object | null"},"active":{"oneOf":[{"type":"boolean","description":"The `active` flag before this update; true on the version being demoted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.active.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"The `active` flag before this update; true on the version being demoted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.active.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.active","typeLabel":"boolean | null"},"archived":{"oneOf":[{"type":"boolean","description":"Whether the plan is archived. Archived plans cannot be attached to new customers.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.archived.oneOf.0","typeLabel":"boolean"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.archived.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.archived","typeLabel":"boolean | null"},"metadata":{"oneOf":[{"type":"object","description":"Arbitrary key-value metadata defined by you for your own use. Shared across all versions of the plan.","additionalProperties":{"oneOf":[{}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.metadata.oneOf.0.additionalProperties","typeLabel":"any"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.metadata.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.metadata","typeLabel":"object | null"},"processors":{"oneOf":[{"type":"object","description":"Previous payment processors when they changed. Null when the plan had none.","x-atmn-mapping":true,"properties":{"stripe":{"oneOf":[{"type":"object","required":["product_id"],"properties":{"product_id":{"type":"string","description":"Stripe product ID this plan is billed under.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.processors.oneOf.0.stripe.oneOf.0.product_id","typeLabel":"string"},"additional_product_ids":{"type":"array","items":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.processors.oneOf.0.stripe.oneOf.0.additional_product_ids.items.[INDEX]","typeLabel":"string"},"description":"Extra Stripe product IDs aliased to this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.processors.oneOf.0.stripe.oneOf.0.additional_product_ids","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.processors.oneOf.0.stripe.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.processors.oneOf.0.stripe.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.processors.oneOf.0.stripe","typeLabel":"object | null"},"revenuecat":{"oneOf":[{"type":"object","required":["products"],"properties":{"products":{"description":"Every RevenueCat product that maps to this plan. Replaces the current set.","type":"array","items":{"type":"object","properties":{"product_id":{"type":"string","description":"RevenueCat product ID that grants this plan when purchased.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.processors.oneOf.0.revenuecat.oneOf.0.products.items.[INDEX].product_id","typeLabel":"string"},"feature_quantities":{"description":"Prepaid quantities granted when this specific RevenueCat product is purchased, in feature units.","type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.processors.oneOf.0.revenuecat.oneOf.0.products.items.[INDEX].feature_quantities.items.[INDEX].feature_id","typeLabel":"string"},"quantity":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.processors.oneOf.0.revenuecat.oneOf.0.products.items.[INDEX].feature_quantities.items.[INDEX].quantity","typeLabel":"number"}},"required":["feature_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.processors.oneOf.0.revenuecat.oneOf.0.products.items.[INDEX].feature_quantities.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.processors.oneOf.0.revenuecat.oneOf.0.products.items.[INDEX].feature_quantities","typeLabel":"object[]"}},"required":["product_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.processors.oneOf.0.revenuecat.oneOf.0.products.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.processors.oneOf.0.revenuecat.oneOf.0.products","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.processors.oneOf.0.revenuecat.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.processors.oneOf.0.revenuecat.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.processors.oneOf.0.revenuecat","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.processors.oneOf.0","typeLabel":"object"},{"type":"null","description":"Previous payment processors when they changed. Null when the plan had none.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.processors.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.processors","typeLabel":"object | null"},"base_variant_id":{"oneOf":[{"type":"string","description":"The base plan this variant pointed at before this update re-anchored it. Null when it was standalone.","deprecated":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.base_variant_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The base plan this variant pointed at before this update re-anchored it. Null when it was standalone.","deprecated":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.base_variant_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.base_variant_id","typeLabel":"string | null"},"base_version":{"oneOf":[{"type":"integer","description":"The base row version this variant pointed at before this update. Null when it was standalone.","maximum":9007199254740991,"minimum":1,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.base_version.oneOf.0","typeLabel":"integer"},{"type":"null","description":"The base row version this variant pointed at before this update. Null when it was standalone.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.base_version.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.base_version","typeLabel":"integer | null"},"base_version_slug":{"oneOf":[{"type":"string","description":"The base row version slug this variant pointed at before this update. Null when it was standalone.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.base_version_slug.oneOf.0","typeLabel":"string"},{"type":"null","description":"The base row version slug this variant pointed at before this update. Null when it was standalone.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.base_version_slug.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.base_version_slug","typeLabel":"string | null"},"free_trial":{"oneOf":[{"type":"object","description":"Previous free trial when it changed. Null when the plan had none.","required":["duration_length","duration_type","card_required"],"properties":{"duration_length":{"type":"number","description":"Number of duration_type periods the trial lasts.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.free_trial.oneOf.0.duration_length","typeLabel":"number"},"duration_type":{"enum":["day","month","year"],"type":"string","description":"Unit of time for the trial duration ('day', 'month', 'year').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.free_trial.oneOf.0.duration_type","typeLabel":"enum\u003cstring>"},"card_required":{"type":"boolean","description":"Whether a payment method is required to start the trial. If true, customer will be charged after trial ends.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.free_trial.oneOf.0.card_required","typeLabel":"boolean"},"on_end":{"oneOf":[{"type":"string","description":"Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.","enum":["bill","revert"],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.free_trial.oneOf.0.on_end.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.free_trial.oneOf.0.on_end.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.free_trial.oneOf.0.on_end","typeLabel":"enum\u003cstring> | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.free_trial.oneOf.0","typeLabel":"object"},{"type":"null","description":"Previous free trial when it changed. Null when the plan had none.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.free_trial.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.free_trial","typeLabel":"object | null"},"billing_controls":{"oneOf":[{"type":"object","description":"Sparse previous billing_controls — only keys that changed. Null when unset; a null lane was unset before.","properties":{"auto_topups":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"The ID of the feature (credit balance) to auto top-up.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.auto_topups.oneOf.0.items.[INDEX].feature_id","typeLabel":"string"},"enabled":{"type":"boolean","default":false,"description":"Whether auto top-up is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.auto_topups.oneOf.0.items.[INDEX].enabled","typeLabel":"boolean"},"threshold":{"type":"number","description":"When the balance drops below this threshold, an auto top-up will be purchased.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.auto_topups.oneOf.0.items.[INDEX].threshold","typeLabel":"number"},"quantity":{"type":"number","minimum":1,"description":"Amount of credits to add per auto top-up.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.auto_topups.oneOf.0.items.[INDEX].quantity","typeLabel":"number"},"purchase_limit":{"description":"Optional limit on auto top-ups per window, by number of top-ups or amount charged.","type":"object","properties":{"interval":{"enum":["hour","day","week","month"],"type":"string","description":"The time interval for the purchase limit window.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.auto_topups.oneOf.0.items.[INDEX].purchase_limit.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","minimum":1,"default":1,"description":"Number of intervals in the purchase limit window.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.auto_topups.oneOf.0.items.[INDEX].purchase_limit.interval_count","typeLabel":"number"},"limit":{"type":"number","exclusiveMinimum":0,"description":"Maximum allowed within the interval: a number of auto top-ups when limit_type is count, or a total charge (e.g. 500 for $500, pre-tax) when limit_type is amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.auto_topups.oneOf.0.items.[INDEX].purchase_limit.limit","typeLabel":"number"},"limit_type":{"enum":["count","amount"],"type":"string","description":"What `limit` caps: the number of auto top-ups (`count`, default) or the total amount charged for them, in the customer's currency (`amount`).","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.auto_topups.oneOf.0.items.[INDEX].purchase_limit.limit_type","typeLabel":"enum\u003cstring>"}},"required":["interval","interval_count","limit"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.auto_topups.oneOf.0.items.[INDEX].purchase_limit","typeLabel":"object"},"invoice_mode":{"type":"boolean","description":"When true, auto top-up creates a send_invoice invoice instead of auto-charging.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.auto_topups.oneOf.0.items.[INDEX].invoice_mode","typeLabel":"boolean"}},"required":["feature_id","enabled","threshold","quantity"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.auto_topups.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"List of auto top-up configurations per feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.auto_topups.oneOf.0","typeLabel":"object[]"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.auto_topups.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.auto_topups","typeLabel":"object[] | null"},"spend_limits":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"enabled":{"type":"boolean","default":false,"description":"Whether the overage spend limit is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.spend_limits.oneOf.0.items.[INDEX].enabled","typeLabel":"boolean"},"feature_id":{"type":"string","description":"Optional feature ID this spend limit applies to.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.spend_limits.oneOf.0.items.[INDEX].feature_id","typeLabel":"string"},"limit_type":{"enum":["absolute","usage_percentage"],"type":"string","description":"How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.spend_limits.oneOf.0.items.[INDEX].limit_type","typeLabel":"enum\u003cstring>"},"overage_limit":{"type":"number","minimum":0,"description":"Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.spend_limits.oneOf.0.items.[INDEX].overage_limit","typeLabel":"number"},"skip_overage_billing":{"type":"boolean","description":"When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.spend_limits.oneOf.0.items.[INDEX].skip_overage_billing","typeLabel":"boolean"}},"required":["enabled"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.spend_limits.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"List of overage spend limits per feature (caps overage spend).","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.spend_limits.oneOf.0","typeLabel":"object[]"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.spend_limits.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.spend_limits","typeLabel":"object[] | null"},"usage_limits":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"The feature this usage limit applies to.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_limits.oneOf.0.items.[INDEX].feature_id","typeLabel":"string"},"enabled":{"type":"boolean","default":true,"description":"Whether this usage limit is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_limits.oneOf.0.items.[INDEX].enabled","typeLabel":"boolean"},"limit":{"type":"number","minimum":0,"description":"Maximum units allowed per interval.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_limits.oneOf.0.items.[INDEX].limit","typeLabel":"number"},"interval":{"enum":["day","week","month","year"],"type":"string","description":"Interval for the cap, aligned to the customer's billing cycle.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_limits.oneOf.0.items.[INDEX].interval","typeLabel":"enum\u003cstring>"},"anchor":{"enum":["billing_cycle","utc"],"type":"string","description":"Window alignment. 'billing_cycle' phases the interval to the customer's renewal time; 'utc' aligns to the UTC calendar.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_limits.oneOf.0.items.[INDEX].anchor","typeLabel":"enum\u003cstring>"},"filter":{"description":"When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.","type":"object","properties":{"properties":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_limits.oneOf.0.items.[INDEX].filter.properties.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_limits.oneOf.0.items.[INDEX].filter.properties","typeLabel":"object"}},"required":["properties"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_limits.oneOf.0.items.[INDEX].filter","typeLabel":"object"}},"required":["feature_id","enabled","limit","interval"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_limits.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"List of hard usage caps per feature (max units per interval).","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_limits.oneOf.0","typeLabel":"object[]"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_limits.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_limits","typeLabel":"object[] | null"},"usage_alerts":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"enabled":{"type":"boolean","default":true,"description":"Whether this usage alert is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_alerts.oneOf.0.items.[INDEX].enabled","typeLabel":"boolean"},"threshold":{"type":"number","description":"The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage. remaining and remaining_percentage accept negative values with basis balance, to alert once the balance is overdrawn.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_alerts.oneOf.0.items.[INDEX].threshold","typeLabel":"number"},"threshold_type":{"enum":["usage","usage_percentage","remaining","remaining_percentage"],"type":"string","description":"Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_alerts.oneOf.0.items.[INDEX].threshold_type","typeLabel":"enum\u003cstring>"},"basis":{"enum":["balance","included","recurring","usage_limit"],"type":"string","default":"balance","description":"What 100% means. balance: every grant on the feature. included: the plan allowance only. recurring: grants that reset. usage_limit: the cap of the usage limit with the same feature and filter.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_alerts.oneOf.0.items.[INDEX].basis","typeLabel":"enum\u003cstring>"},"feature_id":{"type":"string","description":"The feature ID this alert applies to.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_alerts.oneOf.0.items.[INDEX].feature_id","typeLabel":"string"},"filter":{"description":"Only valid with basis usage_limit. Points the alert at the usage limit carrying the same filter.","type":"object","properties":{"properties":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_alerts.oneOf.0.items.[INDEX].filter.properties.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_alerts.oneOf.0.items.[INDEX].filter.properties","typeLabel":"object"}},"required":["properties"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_alerts.oneOf.0.items.[INDEX].filter","typeLabel":"object"},"name":{"type":"string","description":"Optional user-defined label to distinguish multiple alerts on the same feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_alerts.oneOf.0.items.[INDEX].name","typeLabel":"string"}},"required":["enabled","threshold","threshold_type","basis"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_alerts.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"List of usage alert configurations per feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_alerts.oneOf.0","typeLabel":"object[]"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_alerts.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.usage_alerts","typeLabel":"object[] | null"},"overage_allowed":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"The feature ID this overage allowed control applies to.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.overage_allowed.oneOf.0.items.[INDEX].feature_id","typeLabel":"string"},"enabled":{"type":"boolean","default":false,"description":"Whether overage is allowed for this feature.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.overage_allowed.oneOf.0.items.[INDEX].enabled","typeLabel":"boolean"}},"required":["feature_id","enabled"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.overage_allowed.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"List of overage allowed controls per feature. When enabled, usage can exceed balance.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.overage_allowed.oneOf.0","typeLabel":"object[]"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.overage_allowed.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0.overage_allowed","typeLabel":"object[] | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.0","typeLabel":"object"},{"type":"null","description":"Sparse previous billing_controls — only keys that changed. Null when unset; a null lane was unset before.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0.billing_controls","typeLabel":"object | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.0","typeLabel":"object"},{"type":"null","description":"Sparse map of scalar plan fields that changed, holding their previous values. Null when the plan is new.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.previous_attributes","typeLabel":"object | null"},"item_changes":{"description":"Feature items added to or removed from the plan.","default":[],"type":"array","items":{"type":"object","properties":{"action":{"description":"Whether the item was added to or removed from the plan.","type":"string","enum":["created","deleted"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].action","typeLabel":"enum\u003cstring>"},"feature_id":{"description":"The ID of the feature that was added or removed.","type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].feature_id","typeLabel":"string"},"item":{"description":"The plan item snapshot that was added or removed.","type":"object","properties":{"feature_id":{"type":"string","description":"The ID of the feature this item configures.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_id","typeLabel":"string"},"included":{"type":"number","description":"Number of free units included. For consumable features, balance resets to this number each interval.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.included","typeLabel":"number"},"unlimited":{"type":"boolean","description":"Whether the customer has unlimited access to this feature.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.unlimited","typeLabel":"boolean"},"reset":{"oneOf":[{"type":"object","description":"Reset configuration for consumable features. Null for non-consumable features like seats where usage persists across billing cycles.","required":["interval"],"properties":{"interval":{"enum":["one_off","minute","hour","day","week","month","quarter","semi_annual","year"],"type":"string","description":"The interval at which the feature balance resets (e.g. 'month', 'year'). For consumable features, usage resets to 0 and included units are restored.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.reset.oneOf.0.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","description":"Number of intervals between resets. Defaults to 1.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.reset.oneOf.0.interval_count","typeLabel":"number"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.reset.oneOf.0","typeLabel":"object"},{"type":"null","description":"Reset configuration for consumable features. Null for non-consumable features like seats where usage persists across billing cycles.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.reset.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.reset","typeLabel":"object | null"},"price":{"oneOf":[{"type":"object","description":"Pricing configuration for usage beyond included units. Null if feature is entirely free.","required":["interval","billing_units","billing_method","max_purchase"],"properties":{"interval":{"enum":["one_off","week","month","quarter","semi_annual","year"],"type":"string","description":"Billing interval for this price. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.price.oneOf.0.interval","typeLabel":"enum\u003cstring>"},"billing_units":{"type":"number","description":"Number of units per price increment. Usage is rounded UP to the nearest billing_units when billed (e.g. billing_units=100 means 101 usage rounds to 200).","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.price.oneOf.0.billing_units","typeLabel":"number"},"billing_method":{"enum":["prepaid","usage_based"],"type":"string","description":"'prepaid' for features like seats where customers pay upfront, 'usage_based' for pay-as-you-go after included usage.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.price.oneOf.0.billing_method","typeLabel":"enum\u003cstring>"},"max_purchase":{"oneOf":[{"type":"number","description":"Maximum units a customer can purchase beyond included. E.g. if included=100 and max_purchase=300, customer can use up to 400 total before usage is capped. Null for no limit.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.price.oneOf.0.max_purchase.oneOf.0","typeLabel":"number"},{"type":"null","description":"Maximum units a customer can purchase beyond included. E.g. if included=100 and max_purchase=300, customer can use up to 400 total before usage is capped. Null for no limit.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.price.oneOf.0.max_purchase.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.price.oneOf.0.max_purchase","typeLabel":"number | null"},"amount":{"type":"number","description":"Price per billing_units after included usage is consumed. Mutually exclusive with tiers.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.price.oneOf.0.amount","typeLabel":"number"},"additional_currencies":{"description":"Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers' (tiered prices carry per-currency amounts on each tier).","type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.price.oneOf.0.additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Price amount in this currency. Set explicitly per currency, not converted from the base amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.price.oneOf.0.additional_currencies.items.[INDEX].amount","typeLabel":"number"}},"required":["currency","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.price.oneOf.0.additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.price.oneOf.0.additional_currencies","typeLabel":"object[]"},"tiers":{"description":"Tiered pricing configuration. Each tier's 'to' INCLUDES the included amount. Either 'tiers' or 'amount' is required.","type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.price.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","const":"inf","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.price.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.price.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | string"},"amount":{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.price.oneOf.0.tiers.items.[INDEX].amount","typeLabel":"number"},"flat_amount":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.price.oneOf.0.tiers.items.[INDEX].flat_amount","typeLabel":"number"},"additional_currencies":{"type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.price.oneOf.0.tiers.items.[INDEX].additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Per-unit amount for this tier in this currency.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.price.oneOf.0.tiers.items.[INDEX].additional_currencies.items.[INDEX].amount","typeLabel":"number"},"flat_amount":{"type":"number","description":"Flat amount for this tier in this currency, if the tier uses one.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.price.oneOf.0.tiers.items.[INDEX].additional_currencies.items.[INDEX].flat_amount","typeLabel":"number"}},"required":["currency"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.price.oneOf.0.tiers.items.[INDEX].additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.price.oneOf.0.tiers.items.[INDEX].additional_currencies","typeLabel":"object[]"}},"required":["to","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.price.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.price.oneOf.0.tiers","typeLabel":"object[]"},"tier_behavior":{"enum":["graduated","volume"],"type":"string","description":"How tiers price usage. 'graduated' (default) charges each unit at the rate of the tier it falls in. 'volume' picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier's rate plus its flat_amount.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.price.oneOf.0.tier_behavior","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","description":"Number of intervals per billing cycle. Defaults to 1.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.price.oneOf.0.interval_count","typeLabel":"number"},"processors":{"description":"Payment processors this item price is connected to. Omitted when unset.","x-atmn-mapping":true,"type":"object","properties":{"stripe":{"oneOf":[{"type":"object","required":["price_id"],"properties":{"price_id":{"type":"string","description":"Stripe price ID. For prepaid with included > 0 this is the V2 price.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.price.oneOf.0.processors.stripe.oneOf.0.price_id","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.price.oneOf.0.processors.stripe.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.price.oneOf.0.processors.stripe.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.price.oneOf.0.processors.stripe","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.price.oneOf.0.processors","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.price.oneOf.0","typeLabel":"object"},{"type":"null","description":"Pricing configuration for usage beyond included units. Null if feature is entirely free.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.price.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.price","typeLabel":"object | null"},"threshold_billing":{"oneOf":[{"type":"object","description":"Bills this many feature units when outstanding overage reaches it.","required":["threshold"],"properties":{"threshold":{"type":"number","exclusiveMinimum":0,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.threshold_billing.oneOf.0.threshold","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.threshold_billing.oneOf.0","typeLabel":"object"},{"type":"null","description":"Bills this many feature units when outstanding overage reaches it.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.threshold_billing.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.threshold_billing","typeLabel":"object | null"},"feature":{"description":"The full feature object if expanded.","type":"object","properties":{"id":{"type":"string","description":"The ID of the feature, used to refer to it in other API calls like /track or /check.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature.id","typeLabel":"string"},"type":{"enum":["static","boolean","single_use","continuous_use","credit_system","ai_credit_system"],"type":"string","description":"The type of the feature","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature.type","typeLabel":"enum\u003cstring>"},"name":{"oneOf":[{"type":"string","description":"The name of the feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature.name.oneOf.0","typeLabel":"string"},{"type":"null","description":"The name of the feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature.name","typeLabel":"string | null"},"display":{"oneOf":[{"type":"object","description":"Singular and plural display names for the feature.","required":["singular","plural"],"properties":{"singular":{"type":"string","description":"The singular display name for the feature.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature.display.oneOf.0.singular","typeLabel":"string"},"plural":{"type":"string","description":"The plural display name for the feature.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature.display.oneOf.0.plural","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature.display.oneOf.0","typeLabel":"object"},{"type":"null","description":"Singular and plural display names for the feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature.display.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature.display","typeLabel":"object | null"},"credit_schema":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"metered_feature_id":{"type":"string","description":"The ID of the metered feature (should be a single_use feature).","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature.credit_schema.oneOf.0.items.[INDEX].metered_feature_id","typeLabel":"string"},"credit_cost":{"type":"number","description":"The credit cost of the metered feature.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature.credit_schema.oneOf.0.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["metered_feature_id","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature.credit_schema.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Credit cost schema for credit system features.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature.credit_schema.oneOf.0","typeLabel":"object[]"},{"type":"null","description":"Credit cost schema for credit system features.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature.credit_schema.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature.credit_schema","typeLabel":"object[] | null"},"archived":{"oneOf":[{"type":"boolean","description":"Whether or not the feature is archived.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature.archived.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether or not the feature is archived.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature.archived.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature.archived","typeLabel":"boolean | null"}},"required":["id","type"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature","typeLabel":"object"},"pooled":{"type":"boolean","default":false,"description":"Whether entity-level grants contribute to a shared customer balance.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.pooled","typeLabel":"boolean"},"display":{"description":"Display text for showing this item in pricing pages.","type":"object","properties":{"primary_text":{"type":"string","description":"Main display text (e.g. '$10' or '100 messages').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.display.primary_text","typeLabel":"string"},"secondary_text":{"type":"string","description":"Secondary display text (e.g. 'per month' or 'then $0.5 per 100').","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.display.secondary_text","typeLabel":"string"}},"required":["primary_text"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.display","typeLabel":"object"},"rollover":{"description":"Rollover configuration for unused units. If set, unused included units roll over to the next period.","type":"object","properties":{"max":{"oneOf":[{"type":"number","description":"Maximum rollover units. Null for unlimited rollover.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.rollover.max.oneOf.0","typeLabel":"number"},{"type":"null","description":"Maximum rollover units. Null for unlimited rollover.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.rollover.max.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.rollover.max","typeLabel":"number | null"},"expiry_duration_type":{"enum":["month","forever"],"type":"string","description":"When rolled over units expire.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.rollover.expiry_duration_type","typeLabel":"enum\u003cstring>"},"max_percentage":{"oneOf":[{"type":"number","description":"Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.rollover.max_percentage.oneOf.0","typeLabel":"number"},{"type":"null","description":"Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.rollover.max_percentage.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.rollover.max_percentage","typeLabel":"number | null"},"expiry_duration_length":{"type":"number","description":"Number of periods before expiry.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.rollover.expiry_duration_length","typeLabel":"number"}},"required":["max","expiry_duration_type"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.rollover","typeLabel":"object"},"expiry":{"oneOf":[{"type":"object","description":"Purchased units expire this long after each purchase. One-off prepaid consumable items only.","required":["duration","length"],"properties":{"duration":{"enum":["day","week","month","year"],"type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.expiry.oneOf.0.duration","typeLabel":"enum\u003cstring>"},"length":{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.expiry.oneOf.0.length","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.expiry.oneOf.0","typeLabel":"object"},{"type":"null","description":"Purchased units expire this long after each purchase. One-off prepaid consumable items only.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.expiry.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.expiry","typeLabel":"object | null"},"feature_override":{"description":"Overrides fields of this item's feature for customers on this plan (e.g. a credit system's credit_schema).","type":"object","properties":{"credit_schema":{"description":"For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.","type":"array","items":{"oneOf":[{"type":"object","required":["metered_feature_id","tier_behavior","tiers"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature that draws from this credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.metered_feature_id","typeLabel":"string"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.tiers","typeLabel":"object[]"},"billing_units":{"type":"number","exclusiveMinimum":0,"description":"Number of metered-feature units priced together. Defaults to one when omitted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.billing_units","typeLabel":"number"},"dimensions":{"description":"Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies.","type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"oneOf":[{"type":"object","required":["match","tier_behavior","tiers"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.match","typeLabel":"object"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers","typeLabel":"object[]"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["match","credit_cost"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.match","typeLabel":"object"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group when this dimension matches.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.credit_cost","typeLabel":"number"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions","typeLabel":"object"},"multipliers":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"object","properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.match","typeLabel":"object"},"factor":{"type":"number","exclusiveMinimum":0,"description":"Multiplies the matched rate. All matching multipliers stack.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.factor","typeLabel":"number"},"add":{"type":"number","description":"Added to the rate after every factor is applied, in credits per billing-unit group.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.add","typeLabel":"number"}},"required":["match"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties","typeLabel":"object"},"description":"Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["metered_feature_id","credit_cost"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature that draws from this credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.metered_feature_id","typeLabel":"string"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.credit_cost","typeLabel":"number"},"billing_units":{"type":"number","exclusiveMinimum":0,"description":"Number of metered-feature units priced together. Defaults to one when omitted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.billing_units","typeLabel":"number"},"dimensions":{"description":"Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies.","type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"oneOf":[{"type":"object","required":["match","tier_behavior","tiers"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.match","typeLabel":"object"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers","typeLabel":"object[]"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["match","credit_cost"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.match","typeLabel":"object"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group when this dimension matches.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.credit_cost","typeLabel":"number"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions","typeLabel":"object"},"multipliers":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"object","properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.match","typeLabel":"object"},"factor":{"type":"number","exclusiveMinimum":0,"description":"Multiplies the matched rate. All matching multipliers stack.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.factor","typeLabel":"number"},"add":{"type":"number","description":"Added to the rate after every factor is applied, in credits per billing-unit group.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.add","typeLabel":"number"}},"required":["match"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties","typeLabel":"object"},"description":"Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["metered_feature_id","excluded"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature to remove from the credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.2.metered_feature_id","typeLabel":"string"},"excluded":{"description":"Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.","type":"boolean","const":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.2.excluded","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX].oneOf.2","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.credit_schema","typeLabel":"object[]"},"markups":{"description":"For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.","type":"object","properties":{"default_markup":{"type":"number","minimum":-100,"description":"Default percentage markup for customers on this plan. Use -100 to make usage free.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.markups.default_markup","typeLabel":"number"},"provider_markups":{"oneOf":[{"type":"object","description":"Per-provider markup percentages for customers on this plan.","additionalProperties":{"type":"object","properties":{"markup":{"type":"number","minimum":-100,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.markups.provider_markups.oneOf.0.additionalProperties.markup","typeLabel":"number"}},"required":["markup"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.markups.provider_markups.oneOf.0.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.markups.provider_markups.oneOf.0","typeLabel":"object"},{"type":"null","description":"Per-provider markup percentages for customers on this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.markups.provider_markups.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.markups.provider_markups","typeLabel":"object | null"},"model_markups":{"oneOf":[{"type":"object","description":"Per-model markup overrides for customers on this plan.","additionalProperties":{"type":"object","properties":{"markup":{"type":"number","minimum":-100,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.markups.model_markups.oneOf.0.additionalProperties.markup","typeLabel":"number"},"input_cost":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.markups.model_markups.oneOf.0.additionalProperties.input_cost","typeLabel":"number"},"output_cost":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.markups.model_markups.oneOf.0.additionalProperties.output_cost","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.markups.model_markups.oneOf.0.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.markups.model_markups.oneOf.0","typeLabel":"object"},{"type":"null","description":"Per-model markup overrides for customers on this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.markups.model_markups.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.markups.model_markups","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override.markups","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item.feature_override","typeLabel":"object"}},"required":["feature_id","included","unlimited","reset","price"],"additionalProperties":false,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX].item","typeLabel":"object"}},"required":["action","feature_id","item"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.item_changes","typeLabel":"object[]"},"plan":{"description":"The plan after the change. Omitted unless the caller expands it.","type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the plan.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.id","typeLabel":"string"},"name":{"type":"string","description":"Display name of the plan.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.name","typeLabel":"string"},"description":{"oneOf":[{"type":"string","description":"Optional description of the plan.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.description.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional description of the plan.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.description.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.description","typeLabel":"string | null"},"group":{"oneOf":[{"type":"string","description":"Group identifier for organizing related plans. Plans in the same group are mutually exclusive.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.group.oneOf.0","typeLabel":"string"},{"type":"null","description":"Group identifier for organizing related plans. Plans in the same group are mutually exclusive.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.group.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.group","typeLabel":"string | null"},"version":{"type":"number","description":"Version number of the plan. Incremented when plan configuration changes.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.version","typeLabel":"number"},"add_on":{"type":"boolean","description":"Whether this is an add-on plan that can be attached alongside a main plan.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.add_on","typeLabel":"boolean"},"auto_enable":{"type":"boolean","description":"If true, this plan is automatically attached when a customer is created. Used for free plans.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.auto_enable","typeLabel":"boolean"},"price":{"oneOf":[{"type":"object","description":"Base recurring price for the plan. Null for free plans or usage-only plans.","required":["amount","interval"],"properties":{"amount":{"type":"number","description":"Base price amount for the plan, in major currency units (e.g. dollars).","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.price.oneOf.0.amount","typeLabel":"number"},"interval":{"enum":["one_off","week","month","quarter","semi_annual","year"],"type":"string","description":"Billing interval (e.g. 'month', 'year').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.price.oneOf.0.interval","typeLabel":"enum\u003cstring>"},"additional_currencies":{"description":"Base price amounts in additional currencies. The base 'amount' is in the org's default currency.","type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.price.oneOf.0.additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Price amount in this currency. Set explicitly per currency, not converted from the base amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.price.oneOf.0.additional_currencies.items.[INDEX].amount","typeLabel":"number"}},"required":["currency","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.price.oneOf.0.additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.price.oneOf.0.additional_currencies","typeLabel":"object[]"},"interval_count":{"type":"number","description":"Number of intervals per billing cycle. Defaults to 1.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.price.oneOf.0.interval_count","typeLabel":"number"},"display":{"description":"Display text for showing this price in pricing pages.","type":"object","properties":{"primary_text":{"type":"string","description":"Main display text (e.g. '$10' or '100 messages').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.price.oneOf.0.display.primary_text","typeLabel":"string"},"secondary_text":{"type":"string","description":"Secondary display text (e.g. 'per month' or 'then $0.5 per 100').","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.price.oneOf.0.display.secondary_text","typeLabel":"string"}},"required":["primary_text"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.price.oneOf.0.display","typeLabel":"object"},"processors":{"description":"Payment processors this base price is connected to. Omitted when unset.","x-atmn-mapping":true,"type":"object","properties":{"stripe":{"oneOf":[{"type":"object","required":["price_id"],"properties":{"price_id":{"type":"string","description":"Stripe price ID. For prepaid with included > 0 this is the V2 price.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.price.oneOf.0.processors.stripe.oneOf.0.price_id","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.price.oneOf.0.processors.stripe.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.price.oneOf.0.processors.stripe.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.price.oneOf.0.processors.stripe","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.price.oneOf.0.processors","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.price.oneOf.0","typeLabel":"object"},{"type":"null","description":"Base recurring price for the plan. Null for free plans or usage-only plans.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.price.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.price","typeLabel":"object | null"},"items":{"description":"Feature configurations included in this plan. Each item defines included units, pricing, and reset behavior for a feature.","type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"The ID of the feature this item configures.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_id","typeLabel":"string"},"included":{"type":"number","description":"Number of free units included. For consumable features, balance resets to this number each interval.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].included","typeLabel":"number"},"unlimited":{"type":"boolean","description":"Whether the customer has unlimited access to this feature.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].unlimited","typeLabel":"boolean"},"reset":{"oneOf":[{"type":"object","description":"Reset configuration for consumable features. Null for non-consumable features like seats where usage persists across billing cycles.","required":["interval"],"properties":{"interval":{"enum":["one_off","minute","hour","day","week","month","quarter","semi_annual","year"],"type":"string","description":"The interval at which the feature balance resets (e.g. 'month', 'year'). For consumable features, usage resets to 0 and included units are restored.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].reset.oneOf.0.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","description":"Number of intervals between resets. Defaults to 1.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].reset.oneOf.0.interval_count","typeLabel":"number"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].reset.oneOf.0","typeLabel":"object"},{"type":"null","description":"Reset configuration for consumable features. Null for non-consumable features like seats where usage persists across billing cycles.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].reset.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].reset","typeLabel":"object | null"},"price":{"oneOf":[{"type":"object","description":"Pricing configuration for usage beyond included units. Null if feature is entirely free.","required":["interval","billing_units","billing_method","max_purchase"],"properties":{"interval":{"enum":["one_off","week","month","quarter","semi_annual","year"],"type":"string","description":"Billing interval for this price. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].price.oneOf.0.interval","typeLabel":"enum\u003cstring>"},"billing_units":{"type":"number","description":"Number of units per price increment. Usage is rounded UP to the nearest billing_units when billed (e.g. billing_units=100 means 101 usage rounds to 200).","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].price.oneOf.0.billing_units","typeLabel":"number"},"billing_method":{"enum":["prepaid","usage_based"],"type":"string","description":"'prepaid' for features like seats where customers pay upfront, 'usage_based' for pay-as-you-go after included usage.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].price.oneOf.0.billing_method","typeLabel":"enum\u003cstring>"},"max_purchase":{"oneOf":[{"type":"number","description":"Maximum units a customer can purchase beyond included. E.g. if included=100 and max_purchase=300, customer can use up to 400 total before usage is capped. Null for no limit.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].price.oneOf.0.max_purchase.oneOf.0","typeLabel":"number"},{"type":"null","description":"Maximum units a customer can purchase beyond included. E.g. if included=100 and max_purchase=300, customer can use up to 400 total before usage is capped. Null for no limit.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].price.oneOf.0.max_purchase.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].price.oneOf.0.max_purchase","typeLabel":"number | null"},"amount":{"type":"number","description":"Price per billing_units after included usage is consumed. Mutually exclusive with tiers.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].price.oneOf.0.amount","typeLabel":"number"},"additional_currencies":{"description":"Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers' (tiered prices carry per-currency amounts on each tier).","type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].price.oneOf.0.additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Price amount in this currency. Set explicitly per currency, not converted from the base amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].price.oneOf.0.additional_currencies.items.[INDEX].amount","typeLabel":"number"}},"required":["currency","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].price.oneOf.0.additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].price.oneOf.0.additional_currencies","typeLabel":"object[]"},"tiers":{"description":"Tiered pricing configuration. Each tier's 'to' INCLUDES the included amount. Either 'tiers' or 'amount' is required.","type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].price.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","const":"inf","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].price.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].price.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | string"},"amount":{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].price.oneOf.0.tiers.items.[INDEX].amount","typeLabel":"number"},"flat_amount":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].price.oneOf.0.tiers.items.[INDEX].flat_amount","typeLabel":"number"},"additional_currencies":{"type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].price.oneOf.0.tiers.items.[INDEX].additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Per-unit amount for this tier in this currency.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].price.oneOf.0.tiers.items.[INDEX].additional_currencies.items.[INDEX].amount","typeLabel":"number"},"flat_amount":{"type":"number","description":"Flat amount for this tier in this currency, if the tier uses one.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].price.oneOf.0.tiers.items.[INDEX].additional_currencies.items.[INDEX].flat_amount","typeLabel":"number"}},"required":["currency"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].price.oneOf.0.tiers.items.[INDEX].additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].price.oneOf.0.tiers.items.[INDEX].additional_currencies","typeLabel":"object[]"}},"required":["to","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].price.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].price.oneOf.0.tiers","typeLabel":"object[]"},"tier_behavior":{"enum":["graduated","volume"],"type":"string","description":"How tiers price usage. 'graduated' (default) charges each unit at the rate of the tier it falls in. 'volume' picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier's rate plus its flat_amount.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].price.oneOf.0.tier_behavior","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","description":"Number of intervals per billing cycle. Defaults to 1.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].price.oneOf.0.interval_count","typeLabel":"number"},"processors":{"description":"Payment processors this item price is connected to. Omitted when unset.","x-atmn-mapping":true,"type":"object","properties":{"stripe":{"oneOf":[{"type":"object","required":["price_id"],"properties":{"price_id":{"type":"string","description":"Stripe price ID. For prepaid with included > 0 this is the V2 price.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].price.oneOf.0.processors.stripe.oneOf.0.price_id","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].price.oneOf.0.processors.stripe.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].price.oneOf.0.processors.stripe.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].price.oneOf.0.processors.stripe","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].price.oneOf.0.processors","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].price.oneOf.0","typeLabel":"object"},{"type":"null","description":"Pricing configuration for usage beyond included units. Null if feature is entirely free.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].price.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].price","typeLabel":"object | null"},"threshold_billing":{"oneOf":[{"type":"object","description":"Bills this many feature units when outstanding overage reaches it.","required":["threshold"],"properties":{"threshold":{"type":"number","exclusiveMinimum":0,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].threshold_billing.oneOf.0.threshold","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].threshold_billing.oneOf.0","typeLabel":"object"},{"type":"null","description":"Bills this many feature units when outstanding overage reaches it.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].threshold_billing.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].threshold_billing","typeLabel":"object | null"},"feature":{"description":"The full feature object if expanded.","type":"object","properties":{"id":{"type":"string","description":"The ID of the feature, used to refer to it in other API calls like /track or /check.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature.id","typeLabel":"string"},"type":{"enum":["static","boolean","single_use","continuous_use","credit_system","ai_credit_system"],"type":"string","description":"The type of the feature","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature.type","typeLabel":"enum\u003cstring>"},"name":{"oneOf":[{"type":"string","description":"The name of the feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature.name.oneOf.0","typeLabel":"string"},{"type":"null","description":"The name of the feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature.name","typeLabel":"string | null"},"display":{"oneOf":[{"type":"object","description":"Singular and plural display names for the feature.","required":["singular","plural"],"properties":{"singular":{"type":"string","description":"The singular display name for the feature.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature.display.oneOf.0.singular","typeLabel":"string"},"plural":{"type":"string","description":"The plural display name for the feature.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature.display.oneOf.0.plural","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature.display.oneOf.0","typeLabel":"object"},{"type":"null","description":"Singular and plural display names for the feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature.display.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature.display","typeLabel":"object | null"},"credit_schema":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"metered_feature_id":{"type":"string","description":"The ID of the metered feature (should be a single_use feature).","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature.credit_schema.oneOf.0.items.[INDEX].metered_feature_id","typeLabel":"string"},"credit_cost":{"type":"number","description":"The credit cost of the metered feature.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature.credit_schema.oneOf.0.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["metered_feature_id","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature.credit_schema.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Credit cost schema for credit system features.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature.credit_schema.oneOf.0","typeLabel":"object[]"},{"type":"null","description":"Credit cost schema for credit system features.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature.credit_schema.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature.credit_schema","typeLabel":"object[] | null"},"archived":{"oneOf":[{"type":"boolean","description":"Whether or not the feature is archived.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature.archived.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether or not the feature is archived.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature.archived.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature.archived","typeLabel":"boolean | null"}},"required":["id","type"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature","typeLabel":"object"},"pooled":{"type":"boolean","default":false,"description":"Whether entity-level grants contribute to a shared customer balance.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].pooled","typeLabel":"boolean"},"display":{"description":"Display text for showing this item in pricing pages.","type":"object","properties":{"primary_text":{"type":"string","description":"Main display text (e.g. '$10' or '100 messages').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].display.primary_text","typeLabel":"string"},"secondary_text":{"type":"string","description":"Secondary display text (e.g. 'per month' or 'then $0.5 per 100').","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].display.secondary_text","typeLabel":"string"}},"required":["primary_text"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].display","typeLabel":"object"},"rollover":{"description":"Rollover configuration for unused units. If set, unused included units roll over to the next period.","type":"object","properties":{"max":{"oneOf":[{"type":"number","description":"Maximum rollover units. Null for unlimited rollover.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].rollover.max.oneOf.0","typeLabel":"number"},{"type":"null","description":"Maximum rollover units. Null for unlimited rollover.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].rollover.max.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].rollover.max","typeLabel":"number | null"},"expiry_duration_type":{"enum":["month","forever"],"type":"string","description":"When rolled over units expire.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].rollover.expiry_duration_type","typeLabel":"enum\u003cstring>"},"max_percentage":{"oneOf":[{"type":"number","description":"Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].rollover.max_percentage.oneOf.0","typeLabel":"number"},{"type":"null","description":"Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].rollover.max_percentage.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].rollover.max_percentage","typeLabel":"number | null"},"expiry_duration_length":{"type":"number","description":"Number of periods before expiry.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].rollover.expiry_duration_length","typeLabel":"number"}},"required":["max","expiry_duration_type"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].rollover","typeLabel":"object"},"expiry":{"oneOf":[{"type":"object","description":"Purchased units expire this long after each purchase. One-off prepaid consumable items only.","required":["duration","length"],"properties":{"duration":{"enum":["day","week","month","year"],"type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].expiry.oneOf.0.duration","typeLabel":"enum\u003cstring>"},"length":{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].expiry.oneOf.0.length","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].expiry.oneOf.0","typeLabel":"object"},{"type":"null","description":"Purchased units expire this long after each purchase. One-off prepaid consumable items only.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].expiry.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].expiry","typeLabel":"object | null"},"feature_override":{"description":"Overrides fields of this item's feature for customers on this plan (e.g. a credit system's credit_schema).","type":"object","properties":{"credit_schema":{"description":"For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.","type":"array","items":{"oneOf":[{"type":"object","required":["metered_feature_id","tier_behavior","tiers"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature that draws from this credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.metered_feature_id","typeLabel":"string"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers","typeLabel":"object[]"},"billing_units":{"type":"number","exclusiveMinimum":0,"description":"Number of metered-feature units priced together. Defaults to one when omitted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.billing_units","typeLabel":"number"},"dimensions":{"description":"Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies.","type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"oneOf":[{"type":"object","required":["match","tier_behavior","tiers"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.match","typeLabel":"object"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers","typeLabel":"object[]"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["match","credit_cost"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.match","typeLabel":"object"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group when this dimension matches.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.credit_cost","typeLabel":"number"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions","typeLabel":"object"},"multipliers":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"object","properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.match","typeLabel":"object"},"factor":{"type":"number","exclusiveMinimum":0,"description":"Multiplies the matched rate. All matching multipliers stack.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.factor","typeLabel":"number"},"add":{"type":"number","description":"Added to the rate after every factor is applied, in credits per billing-unit group.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.add","typeLabel":"number"}},"required":["match"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties","typeLabel":"object"},"description":"Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["metered_feature_id","credit_cost"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature that draws from this credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.metered_feature_id","typeLabel":"string"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.credit_cost","typeLabel":"number"},"billing_units":{"type":"number","exclusiveMinimum":0,"description":"Number of metered-feature units priced together. Defaults to one when omitted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.billing_units","typeLabel":"number"},"dimensions":{"description":"Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies.","type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"oneOf":[{"type":"object","required":["match","tier_behavior","tiers"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.match","typeLabel":"object"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers","typeLabel":"object[]"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["match","credit_cost"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.match","typeLabel":"object"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group when this dimension matches.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.credit_cost","typeLabel":"number"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions","typeLabel":"object"},"multipliers":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"object","properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.match","typeLabel":"object"},"factor":{"type":"number","exclusiveMinimum":0,"description":"Multiplies the matched rate. All matching multipliers stack.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.factor","typeLabel":"number"},"add":{"type":"number","description":"Added to the rate after every factor is applied, in credits per billing-unit group.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.add","typeLabel":"number"}},"required":["match"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties","typeLabel":"object"},"description":"Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["metered_feature_id","excluded"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature to remove from the credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2.metered_feature_id","typeLabel":"string"},"excluded":{"description":"Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.","type":"boolean","const":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2.excluded","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.credit_schema","typeLabel":"object[]"},"markups":{"description":"For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.","type":"object","properties":{"default_markup":{"type":"number","minimum":-100,"description":"Default percentage markup for customers on this plan. Use -100 to make usage free.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.markups.default_markup","typeLabel":"number"},"provider_markups":{"oneOf":[{"type":"object","description":"Per-provider markup percentages for customers on this plan.","additionalProperties":{"type":"object","properties":{"markup":{"type":"number","minimum":-100,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0.additionalProperties.markup","typeLabel":"number"}},"required":["markup"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0","typeLabel":"object"},{"type":"null","description":"Per-provider markup percentages for customers on this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.markups.provider_markups.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.markups.provider_markups","typeLabel":"object | null"},"model_markups":{"oneOf":[{"type":"object","description":"Per-model markup overrides for customers on this plan.","additionalProperties":{"type":"object","properties":{"markup":{"type":"number","minimum":-100,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.markup","typeLabel":"number"},"input_cost":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.input_cost","typeLabel":"number"},"output_cost":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.output_cost","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.markups.model_markups.oneOf.0","typeLabel":"object"},{"type":"null","description":"Per-model markup overrides for customers on this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.markups.model_markups.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.markups.model_markups","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override.markups","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX].feature_override","typeLabel":"object"}},"required":["feature_id","included","unlimited","reset","price"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.\\items","typeLabel":"object[]"},"created_at":{"type":"number","description":"Unix timestamp (ms) when the plan was created.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.created_at","typeLabel":"number"},"env":{"enum":["sandbox","live"],"type":"string","description":"Environment this plan belongs to ('sandbox' or 'live').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.env","typeLabel":"enum\u003cstring>"},"archived":{"type":"boolean","description":"Whether the plan is archived. Archived plans cannot be attached to new customers.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.archived","typeLabel":"boolean"},"config":{"description":"Miscellaneous plan-level configuration flags.","type":"object","properties":{"ignore_past_due":{"type":"boolean","default":false,"description":"If true, entitlements attached to this plan will still reset on schedule even when the customer's product is in a past_due state.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.config.ignore_past_due","typeLabel":"boolean"},"anchor_to_month_start":{"type":"boolean","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.config.anchor_to_month_start","typeLabel":"boolean"}},"required":["ignore_past_due"],"additionalProperties":false,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.config","typeLabel":"object"},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.metadata.additionalProperties","typeLabel":"any"},"description":"Arbitrary key-value metadata defined by you for your own use. Shared across all versions of the plan.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.metadata","typeLabel":"object"},"base_variant_id":{"oneOf":[{"type":"string","description":"Deprecated. Use variant_details.base_plan_id instead. If this is a variant, the ID of the base plan it was created from.","deprecated":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.base_variant_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Deprecated. Use variant_details.base_plan_id instead. If this is a variant, the ID of the base plan it was created from.","deprecated":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.base_variant_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.base_variant_id","typeLabel":"string | null"},"version_slug":{"oneOf":[{"type":"string","description":"User-facing version identity. Defaults to v{n} when the version is minted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.version_slug.oneOf.0","typeLabel":"string"},{"type":"null","description":"User-facing version identity. Defaults to v{n} when the version is minted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.version_slug.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.version_slug","typeLabel":"string | null"},"active":{"type":"boolean","description":"Whether this is the active version of the plan. At most one version is active.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.active","typeLabel":"boolean"},"processors":{"description":"Payment processors this plan is connected to. Omitted when unset.","x-atmn-mapping":true,"type":"object","properties":{"stripe":{"oneOf":[{"type":"object","required":["product_id"],"properties":{"product_id":{"type":"string","description":"Stripe product ID this plan is billed under.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.processors.stripe.oneOf.0.product_id","typeLabel":"string"},"additional_product_ids":{"type":"array","items":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.processors.stripe.oneOf.0.additional_product_ids.items.[INDEX]","typeLabel":"string"},"description":"Extra Stripe product IDs aliased to this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.processors.stripe.oneOf.0.additional_product_ids","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.processors.stripe.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.processors.stripe.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.processors.stripe","typeLabel":"object | null"},"revenuecat":{"oneOf":[{"type":"object","required":["products"],"properties":{"products":{"description":"Every RevenueCat product that maps to this plan. Replaces the current set.","type":"array","items":{"type":"object","properties":{"product_id":{"type":"string","description":"RevenueCat product ID that grants this plan when purchased.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.processors.revenuecat.oneOf.0.products.items.[INDEX].product_id","typeLabel":"string"},"feature_quantities":{"description":"Prepaid quantities granted when this specific RevenueCat product is purchased, in feature units.","type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.processors.revenuecat.oneOf.0.products.items.[INDEX].feature_quantities.items.[INDEX].feature_id","typeLabel":"string"},"quantity":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.processors.revenuecat.oneOf.0.products.items.[INDEX].feature_quantities.items.[INDEX].quantity","typeLabel":"number"}},"required":["feature_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.processors.revenuecat.oneOf.0.products.items.[INDEX].feature_quantities.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.processors.revenuecat.oneOf.0.products.items.[INDEX].feature_quantities","typeLabel":"object[]"}},"required":["product_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.processors.revenuecat.oneOf.0.products.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.processors.revenuecat.oneOf.0.products","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.processors.revenuecat.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.processors.revenuecat.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.processors.revenuecat","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.processors","typeLabel":"object"},"free_trial":{"description":"Free trial configuration. If set, new customers can try this plan before being charged.","type":"object","properties":{"duration_length":{"type":"number","description":"Number of duration_type periods the trial lasts.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.free_trial.duration_length","typeLabel":"number"},"duration_type":{"enum":["day","month","year"],"type":"string","description":"Unit of time for the trial duration ('day', 'month', 'year').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.free_trial.duration_type","typeLabel":"enum\u003cstring>"},"card_required":{"type":"boolean","description":"Whether a payment method is required to start the trial. If true, customer will be charged after trial ends.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.free_trial.card_required","typeLabel":"boolean"},"on_end":{"oneOf":[{"type":"string","description":"Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.","enum":["bill","revert"],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.free_trial.on_end.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.free_trial.on_end.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.free_trial.on_end","typeLabel":"enum\u003cstring> | null"}},"required":["duration_length","duration_type","card_required"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.free_trial","typeLabel":"object"},"billing_controls":{"description":"Plan-level billing controls used as customer defaults.","type":"object","properties":{"auto_topups":{"description":"List of auto top-up configurations per feature.","type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"The ID of the feature (credit balance) to auto top-up.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.auto_topups.items.[INDEX].feature_id","typeLabel":"string"},"enabled":{"type":"boolean","default":false,"description":"Whether auto top-up is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.auto_topups.items.[INDEX].enabled","typeLabel":"boolean"},"threshold":{"type":"number","description":"When the balance drops below this threshold, an auto top-up will be purchased.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.auto_topups.items.[INDEX].threshold","typeLabel":"number"},"quantity":{"type":"number","minimum":1,"description":"Amount of credits to add per auto top-up.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.auto_topups.items.[INDEX].quantity","typeLabel":"number"},"purchase_limit":{"description":"Optional limit on auto top-ups per window, by number of top-ups or amount charged.","type":"object","properties":{"interval":{"enum":["hour","day","week","month"],"type":"string","description":"The time interval for the purchase limit window.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.auto_topups.items.[INDEX].purchase_limit.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","minimum":1,"default":1,"description":"Number of intervals in the purchase limit window.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.auto_topups.items.[INDEX].purchase_limit.interval_count","typeLabel":"number"},"limit":{"type":"number","exclusiveMinimum":0,"description":"Maximum allowed within the interval: a number of auto top-ups when limit_type is count, or a total charge (e.g. 500 for $500, pre-tax) when limit_type is amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.auto_topups.items.[INDEX].purchase_limit.limit","typeLabel":"number"},"limit_type":{"enum":["count","amount"],"type":"string","description":"What `limit` caps: the number of auto top-ups (`count`, default) or the total amount charged for them, in the customer's currency (`amount`).","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.auto_topups.items.[INDEX].purchase_limit.limit_type","typeLabel":"enum\u003cstring>"}},"required":["interval","interval_count","limit"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.auto_topups.items.[INDEX].purchase_limit","typeLabel":"object"},"invoice_mode":{"type":"boolean","description":"When true, auto top-up creates a send_invoice invoice instead of auto-charging.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.auto_topups.items.[INDEX].invoice_mode","typeLabel":"boolean"}},"required":["feature_id","enabled","threshold","quantity"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.auto_topups.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.auto_topups","typeLabel":"object[]"},"spend_limits":{"description":"List of overage spend limits per feature (caps overage spend).","type":"array","items":{"type":"object","properties":{"enabled":{"type":"boolean","default":false,"description":"Whether the overage spend limit is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.spend_limits.items.[INDEX].enabled","typeLabel":"boolean"},"feature_id":{"type":"string","description":"Optional feature ID this spend limit applies to.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.spend_limits.items.[INDEX].feature_id","typeLabel":"string"},"limit_type":{"enum":["absolute","usage_percentage"],"type":"string","description":"How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.spend_limits.items.[INDEX].limit_type","typeLabel":"enum\u003cstring>"},"overage_limit":{"type":"number","minimum":0,"description":"Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.spend_limits.items.[INDEX].overage_limit","typeLabel":"number"},"skip_overage_billing":{"type":"boolean","description":"When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.spend_limits.items.[INDEX].skip_overage_billing","typeLabel":"boolean"}},"required":["enabled"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.spend_limits.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.spend_limits","typeLabel":"object[]"},"usage_limits":{"description":"List of hard usage caps per feature (max units per interval).","type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"The feature this usage limit applies to.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.usage_limits.items.[INDEX].feature_id","typeLabel":"string"},"enabled":{"type":"boolean","default":true,"description":"Whether this usage limit is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.usage_limits.items.[INDEX].enabled","typeLabel":"boolean"},"limit":{"type":"number","minimum":0,"description":"Maximum units allowed per interval.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.usage_limits.items.[INDEX].limit","typeLabel":"number"},"interval":{"enum":["day","week","month","year"],"type":"string","description":"Interval for the cap, aligned to the customer's billing cycle.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.usage_limits.items.[INDEX].interval","typeLabel":"enum\u003cstring>"},"anchor":{"enum":["billing_cycle","utc"],"type":"string","description":"Window alignment. 'billing_cycle' phases the interval to the customer's renewal time; 'utc' aligns to the UTC calendar.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.usage_limits.items.[INDEX].anchor","typeLabel":"enum\u003cstring>"},"filter":{"description":"When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.","type":"object","properties":{"properties":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.usage_limits.items.[INDEX].filter.properties.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.usage_limits.items.[INDEX].filter.properties","typeLabel":"object"}},"required":["properties"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.usage_limits.items.[INDEX].filter","typeLabel":"object"}},"required":["feature_id","enabled","limit","interval"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.usage_limits.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.usage_limits","typeLabel":"object[]"},"usage_alerts":{"description":"List of usage alert configurations per feature.","type":"array","items":{"type":"object","properties":{"enabled":{"type":"boolean","default":true,"description":"Whether this usage alert is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.usage_alerts.items.[INDEX].enabled","typeLabel":"boolean"},"threshold":{"type":"number","description":"The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage. remaining and remaining_percentage accept negative values with basis balance, to alert once the balance is overdrawn.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.usage_alerts.items.[INDEX].threshold","typeLabel":"number"},"threshold_type":{"enum":["usage","usage_percentage","remaining","remaining_percentage"],"type":"string","description":"Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.usage_alerts.items.[INDEX].threshold_type","typeLabel":"enum\u003cstring>"},"basis":{"enum":["balance","included","recurring","usage_limit"],"type":"string","default":"balance","description":"What 100% means. balance: every grant on the feature. included: the plan allowance only. recurring: grants that reset. usage_limit: the cap of the usage limit with the same feature and filter.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.usage_alerts.items.[INDEX].basis","typeLabel":"enum\u003cstring>"},"feature_id":{"type":"string","description":"The feature ID this alert applies to.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.usage_alerts.items.[INDEX].feature_id","typeLabel":"string"},"filter":{"description":"Only valid with basis usage_limit. Points the alert at the usage limit carrying the same filter.","type":"object","properties":{"properties":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.usage_alerts.items.[INDEX].filter.properties.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.usage_alerts.items.[INDEX].filter.properties","typeLabel":"object"}},"required":["properties"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.usage_alerts.items.[INDEX].filter","typeLabel":"object"},"name":{"type":"string","description":"Optional user-defined label to distinguish multiple alerts on the same feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.usage_alerts.items.[INDEX].name","typeLabel":"string"}},"required":["enabled","threshold","threshold_type","basis"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.usage_alerts.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.usage_alerts","typeLabel":"object[]"},"overage_allowed":{"description":"List of overage allowed controls per feature. When enabled, usage can exceed balance.","type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"The feature ID this overage allowed control applies to.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.overage_allowed.items.[INDEX].feature_id","typeLabel":"string"},"enabled":{"type":"boolean","default":false,"description":"Whether overage is allowed for this feature.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.overage_allowed.items.[INDEX].enabled","typeLabel":"boolean"}},"required":["feature_id","enabled"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.overage_allowed.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls.overage_allowed","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.billing_controls","typeLabel":"object"},"customer_eligibility":{"type":"object","properties":{"attach_action":{"enum":["activate","upgrade","downgrade","none","purchase"],"type":"string","description":"The action that would occur if this plan were attached to the customer.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.customer_eligibility.attach_action","typeLabel":"enum\u003cstring>"},"trial_available":{"type":"boolean","description":"Whether the trial on this plan is available to this customer. For example, if the customer used the trial in the past, this will be false.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.customer_eligibility.trial_available","typeLabel":"boolean"},"status":{"enum":["active","scheduled"],"type":"string","description":"The customer's current status with this plan. 'active' if attached, 'scheduled' if pending activation.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.customer_eligibility.status","typeLabel":"enum\u003cstring>"},"canceling":{"type":"boolean","description":"Whether the customer's active instance of this plan is set to cancel.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.customer_eligibility.canceling","typeLabel":"boolean"},"trialing":{"type":"boolean","description":"Whether the customer is currently on a free trial of this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.customer_eligibility.trialing","typeLabel":"boolean"}},"required":["attach_action"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.customer_eligibility","typeLabel":"object"},"variant_details":{"description":"Details about how this variant relates to its latest base plan.","type":"object","properties":{"base_plan_id":{"type":"string","description":"The ID of the base plan this variant was derived from.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.base_plan_id","typeLabel":"string"},"customize":{"description":"The customization that transforms the base plan into this variant.","type":"object","properties":{"price":{"oneOf":[{"type":"object","title":"BasePrice","description":"Override the base price of the plan. Pass null to remove the base price.","required":["amount","interval"],"properties":{"amount":{"type":"number","description":"Base price amount for the plan, in major currency units (e.g. dollars).","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.price.oneOf.0.amount","typeLabel":"number"},"interval":{"enum":["one_off","week","month","quarter","semi_annual","year"],"type":"string","description":"Billing interval (e.g. 'month', 'year').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.price.oneOf.0.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.price.oneOf.0.interval_count","typeLabel":"number"},"additional_currencies":{"description":"Base price amounts in additional currencies. The base 'amount' is in the org's default currency.","type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.price.oneOf.0.additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Price amount in this currency. Set explicitly per currency, not converted from the base amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.price.oneOf.0.additional_currencies.items.[INDEX].amount","typeLabel":"number"}},"required":["currency","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.price.oneOf.0.additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.price.oneOf.0.additional_currencies","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.price.oneOf.0","typeLabel":"BasePrice · object"},{"type":"null","description":"Override the base price of the plan. Pass null to remove the base price.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.price.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.price","typeLabel":"BasePrice · object | null"},"add_items":{"description":"Items to add to the plan.","type":"array","items":{"title":"PlanItem","description":"Configuration for a feature item in a plan, including usage limits, pricing, and rollover settings.","type":"object","properties":{"feature_id":{"type":"string","description":"The ID of the feature to configure.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_id","typeLabel":"string"},"threshold_billing":{"oneOf":[{"type":"object","description":"Bills this many feature units when outstanding overage reaches it.","required":["threshold"],"properties":{"threshold":{"type":"number","exclusiveMinimum":0,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].threshold_billing.oneOf.0.threshold","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].threshold_billing.oneOf.0","typeLabel":"object"},{"type":"null","description":"Bills this many feature units when outstanding overage reaches it.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].threshold_billing.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].threshold_billing","typeLabel":"object | null"},"included":{"type":"number","maximum":10000000000000,"description":"Number of free units included. Balance resets to this each interval for consumable features.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].included","typeLabel":"number"},"unlimited":{"type":"boolean","description":"If true, customer has unlimited access to this feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].unlimited","typeLabel":"boolean"},"pooled":{"type":"boolean","default":false,"description":"Whether entity-level grants contribute to a shared customer balance.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].pooled","typeLabel":"boolean"},"reset":{"description":"Reset configuration for consumable features. Omit for non-consumable features like seats.","type":"object","properties":{"interval":{"enum":["one_off","minute","hour","day","week","month","quarter","semi_annual","year"],"type":"string","description":"Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].reset.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].reset.interval_count","typeLabel":"number"}},"required":["interval"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].reset","typeLabel":"object"},"price":{"description":"Pricing for usage beyond included units. Omit for free features.","type":"object","properties":{"interval":{"enum":["one_off","week","month","quarter","semi_annual","year"],"type":"string","description":"Billing interval. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].price.interval","typeLabel":"enum\u003cstring>"},"billing_method":{"enum":["prepaid","usage_based"],"type":"string","description":"'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].price.billing_method","typeLabel":"enum\u003cstring>"},"amount":{"type":"number","description":"Price per billing_units after included usage. Either 'amount' or 'tiers' is required.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].price.amount","typeLabel":"number"},"additional_currencies":{"description":"Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers'.","type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].price.additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Price amount in this currency. Set explicitly per currency, not converted from the base amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].price.additional_currencies.items.[INDEX].amount","typeLabel":"number"}},"required":["currency","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].price.additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].price.additional_currencies","typeLabel":"object[]"},"tiers":{"description":"Tiered pricing. Either 'amount' or 'tiers' is required.","type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","const":"inf","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].to.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].to","typeLabel":"number | string"},"amount":{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].amount","typeLabel":"number"},"flat_amount":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].flat_amount","typeLabel":"number"},"additional_currencies":{"type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Per-unit amount for this tier in this currency.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX].amount","typeLabel":"number"},"flat_amount":{"type":"number","description":"Flat amount for this tier in this currency, if the tier uses one.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX].flat_amount","typeLabel":"number"}},"required":["currency"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies","typeLabel":"object[]"}},"required":["to","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].price.tiers.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].price.tiers","typeLabel":"object[]"},"tier_behavior":{"enum":["graduated","volume"],"type":"string","description":"How tiers price usage. 'graduated' (default) charges each unit at the rate of the tier it falls in. 'volume' picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier's rate plus its flat_amount.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].price.tier_behavior","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","description":"Number of intervals per billing cycle. Defaults to 1.","default":1,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].price.interval_count","typeLabel":"number"},"billing_units":{"type":"number","default":1,"description":"Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].price.billing_units","typeLabel":"number"},"max_purchase":{"oneOf":[{"type":"number","description":"Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].price.max_purchase.oneOf.0","typeLabel":"number"},{"type":"null","description":"Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].price.max_purchase.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].price.max_purchase","typeLabel":"number | null"}},"required":["interval","billing_method"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].price","typeLabel":"object"},"proration":{"description":"Proration settings for prepaid features. Controls mid-cycle quantity change billing.","type":"object","properties":{"on_increase":{"enum":["bill_immediately","prorate_immediately","prorate_next_cycle","bill_next_cycle"],"type":"string","description":"Billing behavior when quantity increases mid-cycle.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].proration.on_increase","typeLabel":"enum\u003cstring>"},"on_decrease":{"enum":["prorate","prorate_immediately","prorate_next_cycle","none","no_prorations"],"type":"string","description":"Credit behavior when quantity decreases mid-cycle.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].proration.on_decrease","typeLabel":"enum\u003cstring>"}},"required":["on_increase","on_decrease"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].proration","typeLabel":"object"},"rollover":{"description":"Rollover config for unused units. If set, unused included units carry over.","type":"object","properties":{"expiry_duration_type":{"enum":["month","forever"],"type":"string","description":"When rolled over units expire.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].rollover.expiry_duration_type","typeLabel":"enum\u003cstring>"},"max":{"type":"number","description":"Max rollover units. Omit for unlimited rollover.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].rollover.max","typeLabel":"number"},"max_percentage":{"type":"number","description":"Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].rollover.max_percentage","typeLabel":"number"},"expiry_duration_length":{"type":"number","description":"Number of periods before expiry.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].rollover.expiry_duration_length","typeLabel":"number"}},"required":["expiry_duration_type"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].rollover","typeLabel":"object"},"expiry":{"description":"Purchased units expire this long after each purchase. One-off prepaid consumable items only.","type":"object","properties":{"duration":{"enum":["day","week","month","year"],"type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].expiry.duration","typeLabel":"enum\u003cstring>"},"length":{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].expiry.length","typeLabel":"number"}},"required":["duration","length"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].expiry","typeLabel":"object"},"feature_override":{"description":"Overrides fields of this item's feature for customers on this plan (e.g. a credit system's credit_schema).","type":"object","properties":{"credit_schema":{"description":"For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.","type":"array","items":{"oneOf":[{"type":"object","required":["metered_feature_id","tier_behavior","tiers"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature that draws from this credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.metered_feature_id","typeLabel":"string"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers","typeLabel":"object[]"},"billing_units":{"type":"number","exclusiveMinimum":0,"description":"Number of metered-feature units priced together. Defaults to one when omitted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.billing_units","typeLabel":"number"},"dimensions":{"description":"Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies.","type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"oneOf":[{"type":"object","required":["match","tier_behavior","tiers"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.match","typeLabel":"object"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers","typeLabel":"object[]"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["match","credit_cost"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.match","typeLabel":"object"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group when this dimension matches.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.credit_cost","typeLabel":"number"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions","typeLabel":"object"},"multipliers":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"object","properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.match","typeLabel":"object"},"factor":{"type":"number","exclusiveMinimum":0,"description":"Multiplies the matched rate. All matching multipliers stack.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.factor","typeLabel":"number"},"add":{"type":"number","description":"Added to the rate after every factor is applied, in credits per billing-unit group.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.add","typeLabel":"number"}},"required":["match"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties","typeLabel":"object"},"description":"Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["metered_feature_id","credit_cost"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature that draws from this credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.metered_feature_id","typeLabel":"string"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.credit_cost","typeLabel":"number"},"billing_units":{"type":"number","exclusiveMinimum":0,"description":"Number of metered-feature units priced together. Defaults to one when omitted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.billing_units","typeLabel":"number"},"dimensions":{"description":"Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies.","type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"oneOf":[{"type":"object","required":["match","tier_behavior","tiers"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.match","typeLabel":"object"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers","typeLabel":"object[]"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["match","credit_cost"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.match","typeLabel":"object"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group when this dimension matches.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.credit_cost","typeLabel":"number"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions","typeLabel":"object"},"multipliers":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"object","properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.match","typeLabel":"object"},"factor":{"type":"number","exclusiveMinimum":0,"description":"Multiplies the matched rate. All matching multipliers stack.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.factor","typeLabel":"number"},"add":{"type":"number","description":"Added to the rate after every factor is applied, in credits per billing-unit group.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.add","typeLabel":"number"}},"required":["match"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties","typeLabel":"object"},"description":"Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["metered_feature_id","excluded"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature to remove from the credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2.metered_feature_id","typeLabel":"string"},"excluded":{"description":"Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.","type":"boolean","const":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2.excluded","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.credit_schema","typeLabel":"object[]"},"markups":{"description":"For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.","type":"object","properties":{"default_markup":{"type":"number","minimum":-100,"description":"Default percentage markup for customers on this plan. Use -100 to make usage free.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.default_markup","typeLabel":"number"},"provider_markups":{"oneOf":[{"type":"object","description":"Per-provider markup percentages for customers on this plan.","additionalProperties":{"type":"object","properties":{"markup":{"type":"number","minimum":-100,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0.additionalProperties.markup","typeLabel":"number"}},"required":["markup"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0","typeLabel":"object"},{"type":"null","description":"Per-provider markup percentages for customers on this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.provider_markups","typeLabel":"object | null"},"model_markups":{"oneOf":[{"type":"object","description":"Per-model markup overrides for customers on this plan.","additionalProperties":{"type":"object","properties":{"markup":{"type":"number","minimum":-100,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.markup","typeLabel":"number"},"input_cost":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.input_cost","typeLabel":"number"},"output_cost":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.output_cost","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0","typeLabel":"object"},{"type":"null","description":"Per-model markup overrides for customers on this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups.model_markups","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override.markups","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX].feature_override","typeLabel":"object"}},"required":["feature_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items.items.[INDEX]","typeLabel":"PlanItem · object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.add_items","typeLabel":"PlanItem · object[]"},"remove_items":{"description":"Filters selecting items to remove from the plan.","type":"array","items":{"title":"PlanItemFilter","description":"Filter for matching plan items. All provided fields must match (AND).","type":"object","properties":{"feature_id":{"type":"string","description":"Match items linked to this feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.remove_items.items.[INDEX].feature_id","typeLabel":"string"},"billing_method":{"enum":["prepaid","usage_based"],"type":"string","description":"Match items with this billing method (prepaid or usage_based).","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.remove_items.items.[INDEX].billing_method","typeLabel":"enum\u003cstring>"},"interval":{"oneOf":[{"type":"string","description":"Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.","enum":["one_off","week","month","quarter","semi_annual","year"],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.remove_items.items.[INDEX].interval.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"string","description":"Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.","enum":["one_off","minute","hour","day","week","month","quarter","semi_annual","year"],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.remove_items.items.[INDEX].interval.oneOf.1","typeLabel":"enum\u003cstring>"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.remove_items.items.[INDEX].interval","typeLabel":"enum\u003cstring>"},"interval_count":{"description":"Match items with this interval_count. Disambiguates between items that share an interval but differ in count.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.remove_items.items.[INDEX].interval_count","typeLabel":"integer"},"included":{"type":"number","maximum":10000000000000,"description":"Match items whose grant equals this included usage. Omitted is a wildcard.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.remove_items.items.[INDEX].included","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.remove_items.items.[INDEX]","typeLabel":"PlanItemFilter · object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.remove_items","typeLabel":"PlanItemFilter · object[]"},"free_trial":{"oneOf":[{"type":"object","title":"FreeTrialParams","description":"Override the plan's default free trial. Pass an object to set a custom trial, or null to remove the trial entirely.","required":["duration_length","duration_type","card_required"],"properties":{"duration_length":{"type":"number","description":"Number of duration_type periods the trial lasts.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.free_trial.oneOf.0.duration_length","typeLabel":"number"},"duration_type":{"enum":["day","month","year"],"type":"string","default":"month","description":"Unit of time for the trial ('day', 'month', 'year').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.free_trial.oneOf.0.duration_type","typeLabel":"enum\u003cstring>"},"card_required":{"type":"boolean","default":false,"description":"If true, a payment method is required to start the trial and the customer is charged when it ends. Defaults to false.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.free_trial.oneOf.0.card_required","typeLabel":"boolean"},"on_end":{"enum":["bill","revert"],"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.free_trial.oneOf.0.on_end","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.free_trial.oneOf.0","typeLabel":"FreeTrialParams · object"},{"type":"null","description":"Override the plan's default free trial. Pass an object to set a custom trial, or null to remove the trial entirely.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.free_trial.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.free_trial","typeLabel":"FreeTrialParams · object | null"},"billing_controls":{"description":"Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.","type":"object","properties":{"auto_topups":{"type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"The ID of the feature (credit balance) to auto top-up.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].feature_id","typeLabel":"string"},"enabled":{"type":"boolean","default":false,"description":"Whether auto top-up is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].enabled","typeLabel":"boolean"},"threshold":{"type":"number","description":"When the balance drops below this threshold, an auto top-up will be purchased.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].threshold","typeLabel":"number"},"quantity":{"type":"number","minimum":1,"description":"Amount of credits to add per auto top-up.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].quantity","typeLabel":"number"},"purchase_limit":{"description":"Optional rate limit to cap how often auto top-ups occur. Pass count or amount to set the current window's consumed top-ups or charged amount.","type":"object","properties":{"interval":{"enum":["hour","day","week","month"],"type":"string","description":"The time interval for the purchase limit window.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","minimum":1,"default":1,"description":"Number of intervals in the purchase limit window.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit.interval_count","typeLabel":"number"},"limit":{"type":"number","exclusiveMinimum":0,"description":"Maximum allowed within the interval: a number of auto top-ups when limit_type is count, or a total charge (e.g. 500 for $500, pre-tax) when limit_type is amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit.limit","typeLabel":"number"},"limit_type":{"enum":["count","amount"],"type":"string","description":"What `limit` caps: the number of auto top-ups (`count`, default) or the total amount charged for them, in the customer's currency (`amount`).","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit.limit_type","typeLabel":"enum\u003cstring>"},"count":{"type":"number","minimum":0,"description":"Set the current window's consumed auto top-up count. Omit to leave runtime state unchanged.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit.count","typeLabel":"number"},"amount":{"type":"number","minimum":0,"description":"Set the amount already charged by auto top-ups in the current window. Omit to leave runtime state unchanged.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit.amount","typeLabel":"number"}},"required":["interval","interval_count","limit"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit","typeLabel":"object"},"invoice_mode":{"type":"boolean","description":"When true, auto top-up creates a send_invoice invoice instead of auto-charging.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX].invoice_mode","typeLabel":"boolean"}},"required":["feature_id","enabled","threshold","quantity"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.auto_topups.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.auto_topups","typeLabel":"object[]"},"spend_limits":{"type":"array","items":{"type":"object","properties":{"enabled":{"type":"boolean","default":false,"description":"Whether the overage spend limit is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.spend_limits.items.[INDEX].enabled","typeLabel":"boolean"},"feature_id":{"type":"string","description":"Optional feature ID this spend limit applies to.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.spend_limits.items.[INDEX].feature_id","typeLabel":"string"},"limit_type":{"enum":["absolute","usage_percentage"],"type":"string","description":"How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.spend_limits.items.[INDEX].limit_type","typeLabel":"enum\u003cstring>"},"overage_limit":{"type":"number","minimum":0,"description":"Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.spend_limits.items.[INDEX].overage_limit","typeLabel":"number"},"skip_overage_billing":{"type":"boolean","description":"When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.spend_limits.items.[INDEX].skip_overage_billing","typeLabel":"boolean"}},"required":["enabled"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.spend_limits.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.spend_limits","typeLabel":"object[]"},"usage_limits":{"type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"The feature this usage limit applies to.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.usage_limits.items.[INDEX].feature_id","typeLabel":"string"},"enabled":{"type":"boolean","default":true,"description":"Whether this usage limit is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.usage_limits.items.[INDEX].enabled","typeLabel":"boolean"},"limit":{"type":"number","minimum":0,"description":"Maximum units allowed per interval.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.usage_limits.items.[INDEX].limit","typeLabel":"number"},"interval":{"enum":["day","week","month","year"],"type":"string","description":"Interval for the cap, aligned to the customer's billing cycle.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.usage_limits.items.[INDEX].interval","typeLabel":"enum\u003cstring>"},"anchor":{"enum":["billing_cycle","utc"],"type":"string","description":"Window alignment. 'billing_cycle' phases the interval to the customer's renewal time; 'utc' aligns to the UTC calendar.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.usage_limits.items.[INDEX].anchor","typeLabel":"enum\u003cstring>"},"filter":{"description":"When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.","type":"object","properties":{"properties":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.usage_limits.items.[INDEX].filter.properties.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.usage_limits.items.[INDEX].filter.properties","typeLabel":"object"}},"required":["properties"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.usage_limits.items.[INDEX].filter","typeLabel":"object"}},"required":["feature_id","enabled","limit","interval"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.usage_limits.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.usage_limits","typeLabel":"object[]"},"usage_alerts":{"type":"array","items":{"type":"object","properties":{"enabled":{"type":"boolean","default":true,"description":"Whether this usage alert is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.usage_alerts.items.[INDEX].enabled","typeLabel":"boolean"},"threshold":{"type":"number","description":"The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage. remaining and remaining_percentage accept negative values with basis balance, to alert once the balance is overdrawn.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.usage_alerts.items.[INDEX].threshold","typeLabel":"number"},"threshold_type":{"enum":["usage","usage_percentage","remaining","remaining_percentage"],"type":"string","description":"Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.usage_alerts.items.[INDEX].threshold_type","typeLabel":"enum\u003cstring>"},"basis":{"enum":["balance","included","recurring","usage_limit"],"type":"string","default":"balance","description":"What 100% means. balance: every grant on the feature. included: the plan allowance only. recurring: grants that reset. usage_limit: the cap of the usage limit with the same feature and filter.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.usage_alerts.items.[INDEX].basis","typeLabel":"enum\u003cstring>"},"feature_id":{"type":"string","description":"The feature ID this alert applies to.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.usage_alerts.items.[INDEX].feature_id","typeLabel":"string"},"filter":{"description":"Only valid with basis usage_limit. Points the alert at the usage limit carrying the same filter.","type":"object","properties":{"properties":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.usage_alerts.items.[INDEX].filter.properties.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.usage_alerts.items.[INDEX].filter.properties","typeLabel":"object"}},"required":["properties"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.usage_alerts.items.[INDEX].filter","typeLabel":"object"},"name":{"type":"string","description":"Optional user-defined label to distinguish multiple alerts on the same feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.usage_alerts.items.[INDEX].name","typeLabel":"string"}},"required":["enabled","threshold","threshold_type","basis"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.usage_alerts.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.usage_alerts","typeLabel":"object[]"},"overage_allowed":{"type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"The feature ID this overage allowed control applies to.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.overage_allowed.items.[INDEX].feature_id","typeLabel":"string"},"enabled":{"type":"boolean","default":false,"description":"Whether overage is allowed for this feature.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.overage_allowed.items.[INDEX].enabled","typeLabel":"boolean"}},"required":["feature_id","enabled"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.overage_allowed.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls.overage_allowed","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.billing_controls","typeLabel":"object"},"upsert_licenses":{"description":"License links to add or override for this customer, keyed by license_plan_id. Omitted fields inherit the plan catalog link (included defaults to 1 when the license is not in the catalog). A bare entry restores the license to pure catalog inheritance.","type":"array","items":{"type":"object","properties":{"license_plan_id":{"type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].license_plan_id","typeLabel":"string"},"version_slug":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].version_slug","typeLabel":"string"},"included":{"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].included","typeLabel":"integer"},"prepaid_only":{"type":"boolean","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].prepaid_only","typeLabel":"boolean"},"customize":{"oneOf":[{"type":"object","properties":{"price":{"oneOf":[{"type":"object","title":"BasePrice","description":"Base price configuration for a plan.","required":["amount","interval"],"properties":{"amount":{"type":"number","description":"Base price amount for the plan, in major currency units (e.g. dollars).","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.amount","typeLabel":"number"},"interval":{"enum":["one_off","week","month","quarter","semi_annual","year"],"type":"string","description":"Billing interval (e.g. 'month', 'year').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.interval_count","typeLabel":"number"},"additional_currencies":{"description":"Base price amounts in additional currencies. The base 'amount' is in the org's default currency.","type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Price amount in this currency. Set explicitly per currency, not converted from the base amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.additional_currencies.items.[INDEX].amount","typeLabel":"number"}},"required":["currency","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.additional_currencies","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0","typeLabel":"BasePrice · object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price","typeLabel":"BasePrice · object | null"},"add_items":{"type":"array","items":{"title":"PlanItem","description":"Configuration for a feature item in a plan, including usage limits, pricing, and rollover settings.","type":"object","properties":{"feature_id":{"type":"string","description":"The ID of the feature to configure.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_id","typeLabel":"string"},"threshold_billing":{"oneOf":[{"type":"object","description":"Bills this many feature units when outstanding overage reaches it.","required":["threshold"],"properties":{"threshold":{"type":"number","exclusiveMinimum":0,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].threshold_billing.oneOf.0.threshold","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].threshold_billing.oneOf.0","typeLabel":"object"},{"type":"null","description":"Bills this many feature units when outstanding overage reaches it.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].threshold_billing.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].threshold_billing","typeLabel":"object | null"},"included":{"type":"number","maximum":10000000000000,"description":"Number of free units included. Balance resets to this each interval for consumable features.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].included","typeLabel":"number"},"unlimited":{"type":"boolean","description":"If true, customer has unlimited access to this feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].unlimited","typeLabel":"boolean"},"pooled":{"type":"boolean","default":false,"description":"Whether entity-level grants contribute to a shared customer balance.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].pooled","typeLabel":"boolean"},"reset":{"description":"Reset configuration for consumable features. Omit for non-consumable features like seats.","type":"object","properties":{"interval":{"enum":["one_off","minute","hour","day","week","month","quarter","semi_annual","year"],"type":"string","description":"Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].reset.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].reset.interval_count","typeLabel":"number"}},"required":["interval"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].reset","typeLabel":"object"},"price":{"description":"Pricing for usage beyond included units. Omit for free features.","type":"object","properties":{"interval":{"enum":["one_off","week","month","quarter","semi_annual","year"],"type":"string","description":"Billing interval. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.interval","typeLabel":"enum\u003cstring>"},"billing_method":{"enum":["prepaid","usage_based"],"type":"string","description":"'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.billing_method","typeLabel":"enum\u003cstring>"},"amount":{"type":"number","description":"Price per billing_units after included usage. Either 'amount' or 'tiers' is required.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.amount","typeLabel":"number"},"additional_currencies":{"description":"Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers'.","type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Price amount in this currency. Set explicitly per currency, not converted from the base amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.additional_currencies.items.[INDEX].amount","typeLabel":"number"}},"required":["currency","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.additional_currencies","typeLabel":"object[]"},"tiers":{"description":"Tiered pricing. Either 'amount' or 'tiers' is required.","type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","const":"inf","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].to.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].to","typeLabel":"number | string"},"amount":{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].amount","typeLabel":"number"},"flat_amount":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].flat_amount","typeLabel":"number"},"additional_currencies":{"type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Per-unit amount for this tier in this currency.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX].amount","typeLabel":"number"},"flat_amount":{"type":"number","description":"Flat amount for this tier in this currency, if the tier uses one.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX].flat_amount","typeLabel":"number"}},"required":["currency"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies","typeLabel":"object[]"}},"required":["to","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers","typeLabel":"object[]"},"tier_behavior":{"enum":["graduated","volume"],"type":"string","description":"How tiers price usage. 'graduated' (default) charges each unit at the rate of the tier it falls in. 'volume' picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier's rate plus its flat_amount.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tier_behavior","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","description":"Number of intervals per billing cycle. Defaults to 1.","default":1,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.interval_count","typeLabel":"number"},"billing_units":{"type":"number","default":1,"description":"Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.billing_units","typeLabel":"number"},"max_purchase":{"oneOf":[{"type":"number","description":"Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.max_purchase.oneOf.0","typeLabel":"number"},{"type":"null","description":"Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.max_purchase.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.max_purchase","typeLabel":"number | null"}},"required":["interval","billing_method"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price","typeLabel":"object"},"proration":{"description":"Proration settings for prepaid features. Controls mid-cycle quantity change billing.","type":"object","properties":{"on_increase":{"enum":["bill_immediately","prorate_immediately","prorate_next_cycle","bill_next_cycle"],"type":"string","description":"Billing behavior when quantity increases mid-cycle.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].proration.on_increase","typeLabel":"enum\u003cstring>"},"on_decrease":{"enum":["prorate","prorate_immediately","prorate_next_cycle","none","no_prorations"],"type":"string","description":"Credit behavior when quantity decreases mid-cycle.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].proration.on_decrease","typeLabel":"enum\u003cstring>"}},"required":["on_increase","on_decrease"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].proration","typeLabel":"object"},"rollover":{"description":"Rollover config for unused units. If set, unused included units carry over.","type":"object","properties":{"expiry_duration_type":{"enum":["month","forever"],"type":"string","description":"When rolled over units expire.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].rollover.expiry_duration_type","typeLabel":"enum\u003cstring>"},"max":{"type":"number","description":"Max rollover units. Omit for unlimited rollover.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].rollover.max","typeLabel":"number"},"max_percentage":{"type":"number","description":"Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].rollover.max_percentage","typeLabel":"number"},"expiry_duration_length":{"type":"number","description":"Number of periods before expiry.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].rollover.expiry_duration_length","typeLabel":"number"}},"required":["expiry_duration_type"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].rollover","typeLabel":"object"},"expiry":{"description":"Purchased units expire this long after each purchase. One-off prepaid consumable items only.","type":"object","properties":{"duration":{"enum":["day","week","month","year"],"type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].expiry.duration","typeLabel":"enum\u003cstring>"},"length":{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].expiry.length","typeLabel":"number"}},"required":["duration","length"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].expiry","typeLabel":"object"},"feature_override":{"description":"Overrides fields of this item's feature for customers on this plan (e.g. a credit system's credit_schema).","type":"object","properties":{"credit_schema":{"description":"For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.","type":"array","items":{"oneOf":[{"type":"object","required":["metered_feature_id","tier_behavior","tiers"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature that draws from this credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.metered_feature_id","typeLabel":"string"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers","typeLabel":"object[]"},"billing_units":{"type":"number","exclusiveMinimum":0,"description":"Number of metered-feature units priced together. Defaults to one when omitted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.billing_units","typeLabel":"number"},"dimensions":{"description":"Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies.","type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"oneOf":[{"type":"object","required":["match","tier_behavior","tiers"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.match","typeLabel":"object"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers","typeLabel":"object[]"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["match","credit_cost"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.match","typeLabel":"object"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group when this dimension matches.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.credit_cost","typeLabel":"number"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions","typeLabel":"object"},"multipliers":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"object","properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.match","typeLabel":"object"},"factor":{"type":"number","exclusiveMinimum":0,"description":"Multiplies the matched rate. All matching multipliers stack.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.factor","typeLabel":"number"},"add":{"type":"number","description":"Added to the rate after every factor is applied, in credits per billing-unit group.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.add","typeLabel":"number"}},"required":["match"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties","typeLabel":"object"},"description":"Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["metered_feature_id","credit_cost"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature that draws from this credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.metered_feature_id","typeLabel":"string"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.credit_cost","typeLabel":"number"},"billing_units":{"type":"number","exclusiveMinimum":0,"description":"Number of metered-feature units priced together. Defaults to one when omitted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.billing_units","typeLabel":"number"},"dimensions":{"description":"Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies.","type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"oneOf":[{"type":"object","required":["match","tier_behavior","tiers"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.match","typeLabel":"object"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers","typeLabel":"object[]"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["match","credit_cost"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.match","typeLabel":"object"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group when this dimension matches.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.credit_cost","typeLabel":"number"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions","typeLabel":"object"},"multipliers":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"object","properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.match","typeLabel":"object"},"factor":{"type":"number","exclusiveMinimum":0,"description":"Multiplies the matched rate. All matching multipliers stack.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.factor","typeLabel":"number"},"add":{"type":"number","description":"Added to the rate after every factor is applied, in credits per billing-unit group.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.add","typeLabel":"number"}},"required":["match"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties","typeLabel":"object"},"description":"Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["metered_feature_id","excluded"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature to remove from the credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2.metered_feature_id","typeLabel":"string"},"excluded":{"description":"Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.","type":"boolean","const":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2.excluded","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema","typeLabel":"object[]"},"markups":{"description":"For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.","type":"object","properties":{"default_markup":{"type":"number","minimum":-100,"description":"Default percentage markup for customers on this plan. Use -100 to make usage free.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.default_markup","typeLabel":"number"},"provider_markups":{"oneOf":[{"type":"object","description":"Per-provider markup percentages for customers on this plan.","additionalProperties":{"type":"object","properties":{"markup":{"type":"number","minimum":-100,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0.additionalProperties.markup","typeLabel":"number"}},"required":["markup"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0","typeLabel":"object"},{"type":"null","description":"Per-provider markup percentages for customers on this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.provider_markups","typeLabel":"object | null"},"model_markups":{"oneOf":[{"type":"object","description":"Per-model markup overrides for customers on this plan.","additionalProperties":{"type":"object","properties":{"markup":{"type":"number","minimum":-100,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.markup","typeLabel":"number"},"input_cost":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.input_cost","typeLabel":"number"},"output_cost":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.output_cost","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0","typeLabel":"object"},{"type":"null","description":"Per-model markup overrides for customers on this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override","typeLabel":"object"}},"required":["feature_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX]","typeLabel":"PlanItem · object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items","typeLabel":"PlanItem · object[]"},"remove_items":{"type":"array","items":{"title":"PlanItemFilter","description":"Filter for matching plan items. All provided fields must match (AND).","type":"object","properties":{"feature_id":{"type":"string","description":"Match items linked to this feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].feature_id","typeLabel":"string"},"billing_method":{"enum":["prepaid","usage_based"],"type":"string","description":"Match items with this billing method (prepaid or usage_based).","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].billing_method","typeLabel":"enum\u003cstring>"},"interval":{"oneOf":[{"type":"string","description":"Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.","enum":["one_off","week","month","quarter","semi_annual","year"],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].interval.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"string","description":"Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.","enum":["one_off","minute","hour","day","week","month","quarter","semi_annual","year"],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].interval.oneOf.1","typeLabel":"enum\u003cstring>"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].interval","typeLabel":"enum\u003cstring>"},"interval_count":{"description":"Match items with this interval_count. Disambiguates between items that share an interval but differ in count.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].interval_count","typeLabel":"integer"},"included":{"type":"number","maximum":10000000000000,"description":"Match items whose grant equals this included usage. Omitted is a wildcard.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].included","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX]","typeLabel":"PlanItemFilter · object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items","typeLabel":"PlanItemFilter · object[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].customize","typeLabel":"object | null"},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].metadata.additionalProperties","typeLabel":"any"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX].metadata","typeLabel":"object"}},"required":["license_plan_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.upsert_licenses","typeLabel":"object[]"},"remove_licenses":{"description":"License links to drop, keyed by license_plan_id. Parallel to remove_items.","type":"array","items":{"type":"object","properties":{"license_plan_id":{"type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.remove_licenses.items.[INDEX].license_plan_id","typeLabel":"string"}},"required":["license_plan_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.remove_licenses.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize.remove_licenses","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details.customize","typeLabel":"object"}},"required":["base_plan_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan.variant_details","typeLabel":"object"}},"required":["id","name","description","group","version","add_on","auto_enable","price","items","created_at","env","archived","config","metadata","base_variant_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.plan","typeLabel":"object"},"price_change":{"description":"Present when the plan's price changed.","type":"object","properties":{"previous":{"oneOf":[{"type":"object","description":"The plan's price before the change.","required":["amount","interval"],"properties":{"amount":{"type":"number","description":"Base price amount for the plan, in major currency units (e.g. dollars).","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.previous.oneOf.0.amount","typeLabel":"number"},"interval":{"enum":["one_off","week","month","quarter","semi_annual","year"],"type":"string","description":"Billing interval (e.g. 'month', 'year').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.previous.oneOf.0.interval","typeLabel":"enum\u003cstring>"},"additional_currencies":{"description":"Base price amounts in additional currencies. The base 'amount' is in the org's default currency.","type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.previous.oneOf.0.additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Price amount in this currency. Set explicitly per currency, not converted from the base amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.previous.oneOf.0.additional_currencies.items.[INDEX].amount","typeLabel":"number"}},"required":["currency","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.previous.oneOf.0.additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.previous.oneOf.0.additional_currencies","typeLabel":"object[]"},"interval_count":{"type":"number","description":"Number of intervals per billing cycle. Defaults to 1.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.previous.oneOf.0.interval_count","typeLabel":"number"},"display":{"description":"Display text for showing this price in pricing pages.","type":"object","properties":{"primary_text":{"type":"string","description":"Main display text (e.g. '$10' or '100 messages').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.previous.oneOf.0.display.primary_text","typeLabel":"string"},"secondary_text":{"type":"string","description":"Secondary display text (e.g. 'per month' or 'then $0.5 per 100').","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.previous.oneOf.0.display.secondary_text","typeLabel":"string"}},"required":["primary_text"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.previous.oneOf.0.display","typeLabel":"object"},"processors":{"description":"Payment processors this base price is connected to. Omitted when unset.","x-atmn-mapping":true,"type":"object","properties":{"stripe":{"oneOf":[{"type":"object","required":["price_id"],"properties":{"price_id":{"type":"string","description":"Stripe price ID. For prepaid with included > 0 this is the V2 price.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.previous.oneOf.0.processors.stripe.oneOf.0.price_id","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.previous.oneOf.0.processors.stripe.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.previous.oneOf.0.processors.stripe.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.previous.oneOf.0.processors.stripe","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.previous.oneOf.0.processors","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.previous.oneOf.0","typeLabel":"object"},{"type":"null","description":"The plan's price before the change.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.previous.oneOf.1","typeLabel":"null"},{"type":"null","description":"The plan's price before the change.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.previous.oneOf.2","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.previous","typeLabel":"object · null · null"},"current":{"oneOf":[{"type":"object","description":"The plan's price after the change.","required":["amount","interval"],"properties":{"amount":{"type":"number","description":"Base price amount for the plan, in major currency units (e.g. dollars).","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.current.oneOf.0.amount","typeLabel":"number"},"interval":{"enum":["one_off","week","month","quarter","semi_annual","year"],"type":"string","description":"Billing interval (e.g. 'month', 'year').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.current.oneOf.0.interval","typeLabel":"enum\u003cstring>"},"additional_currencies":{"description":"Base price amounts in additional currencies. The base 'amount' is in the org's default currency.","type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.current.oneOf.0.additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Price amount in this currency. Set explicitly per currency, not converted from the base amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.current.oneOf.0.additional_currencies.items.[INDEX].amount","typeLabel":"number"}},"required":["currency","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.current.oneOf.0.additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.current.oneOf.0.additional_currencies","typeLabel":"object[]"},"interval_count":{"type":"number","description":"Number of intervals per billing cycle. Defaults to 1.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.current.oneOf.0.interval_count","typeLabel":"number"},"display":{"description":"Display text for showing this price in pricing pages.","type":"object","properties":{"primary_text":{"type":"string","description":"Main display text (e.g. '$10' or '100 messages').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.current.oneOf.0.display.primary_text","typeLabel":"string"},"secondary_text":{"type":"string","description":"Secondary display text (e.g. 'per month' or 'then $0.5 per 100').","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.current.oneOf.0.display.secondary_text","typeLabel":"string"}},"required":["primary_text"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.current.oneOf.0.display","typeLabel":"object"},"processors":{"description":"Payment processors this base price is connected to. Omitted when unset.","x-atmn-mapping":true,"type":"object","properties":{"stripe":{"oneOf":[{"type":"object","required":["price_id"],"properties":{"price_id":{"type":"string","description":"Stripe price ID. For prepaid with included > 0 this is the V2 price.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.current.oneOf.0.processors.stripe.oneOf.0.price_id","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.current.oneOf.0.processors.stripe.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.current.oneOf.0.processors.stripe.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.current.oneOf.0.processors.stripe","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.current.oneOf.0.processors","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.current.oneOf.0","typeLabel":"object"},{"type":"null","description":"The plan's price after the change.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.current.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change.current","typeLabel":"object | null"}},"required":["previous","current"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.price_change","typeLabel":"object"},"free_trial_change":{"description":"Present when the plan's free trial changed.","type":"object","properties":{"previous":{"oneOf":[{"type":"object","description":"The plan's free trial before the change. Null when none.","required":["duration_length","duration_type","card_required"],"properties":{"duration_length":{"type":"number","description":"Number of duration_type periods the trial lasts.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.free_trial_change.previous.oneOf.0.duration_length","typeLabel":"number"},"duration_type":{"enum":["day","month","year"],"type":"string","description":"Unit of time for the trial duration ('day', 'month', 'year').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.free_trial_change.previous.oneOf.0.duration_type","typeLabel":"enum\u003cstring>"},"card_required":{"type":"boolean","description":"Whether a payment method is required to start the trial. If true, customer will be charged after trial ends.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.free_trial_change.previous.oneOf.0.card_required","typeLabel":"boolean"},"on_end":{"oneOf":[{"type":"string","description":"Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.","enum":["bill","revert"],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.free_trial_change.previous.oneOf.0.on_end.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.free_trial_change.previous.oneOf.0.on_end.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.free_trial_change.previous.oneOf.0.on_end","typeLabel":"enum\u003cstring> | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.free_trial_change.previous.oneOf.0","typeLabel":"object"},{"type":"null","description":"The plan's free trial before the change. Null when none.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.free_trial_change.previous.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.free_trial_change.previous","typeLabel":"object | null"},"current":{"oneOf":[{"type":"object","description":"The plan's free trial after the change. Null when none.","required":["duration_length","duration_type","card_required"],"properties":{"duration_length":{"type":"number","description":"Number of duration_type periods the trial lasts.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.free_trial_change.current.oneOf.0.duration_length","typeLabel":"number"},"duration_type":{"enum":["day","month","year"],"type":"string","description":"Unit of time for the trial duration ('day', 'month', 'year').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.free_trial_change.current.oneOf.0.duration_type","typeLabel":"enum\u003cstring>"},"card_required":{"type":"boolean","description":"Whether a payment method is required to start the trial. If true, customer will be charged after trial ends.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.free_trial_change.current.oneOf.0.card_required","typeLabel":"boolean"},"on_end":{"oneOf":[{"type":"string","description":"Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.","enum":["bill","revert"],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.free_trial_change.current.oneOf.0.on_end.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.free_trial_change.current.oneOf.0.on_end.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.free_trial_change.current.oneOf.0.on_end","typeLabel":"enum\u003cstring> | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.free_trial_change.current.oneOf.0","typeLabel":"object"},{"type":"null","description":"The plan's free trial after the change. Null when none.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.free_trial_change.current.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.free_trial_change.current","typeLabel":"object | null"}},"required":["previous","current"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.free_trial_change","typeLabel":"object"},"customize":{"description":"Params that would transform the previous plan into the current one. Omitted when nothing customizable changed.","type":"object","properties":{"price":{"oneOf":[{"type":"object","title":"BasePrice","description":"Override the base price of the plan. Pass null to remove the base price.","required":["amount","interval"],"properties":{"amount":{"type":"number","description":"Base price amount for the plan, in major currency units (e.g. dollars).","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.price.oneOf.0.amount","typeLabel":"number"},"interval":{"enum":["one_off","week","month","quarter","semi_annual","year"],"type":"string","description":"Billing interval (e.g. 'month', 'year').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.price.oneOf.0.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.price.oneOf.0.interval_count","typeLabel":"number"},"additional_currencies":{"description":"Base price amounts in additional currencies. The base 'amount' is in the org's default currency.","type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.price.oneOf.0.additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Price amount in this currency. Set explicitly per currency, not converted from the base amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.price.oneOf.0.additional_currencies.items.[INDEX].amount","typeLabel":"number"}},"required":["currency","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.price.oneOf.0.additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.price.oneOf.0.additional_currencies","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.price.oneOf.0","typeLabel":"BasePrice · object"},{"type":"null","description":"Override the base price of the plan. Pass null to remove the base price.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.price.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.price","typeLabel":"BasePrice · object | null"},"add_items":{"description":"Items to add to the plan.","type":"array","items":{"title":"PlanItem","description":"Configuration for a feature item in a plan, including usage limits, pricing, and rollover settings.","type":"object","properties":{"feature_id":{"type":"string","description":"The ID of the feature to configure.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_id","typeLabel":"string"},"threshold_billing":{"oneOf":[{"type":"object","description":"Bills this many feature units when outstanding overage reaches it.","required":["threshold"],"properties":{"threshold":{"type":"number","exclusiveMinimum":0,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].threshold_billing.oneOf.0.threshold","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].threshold_billing.oneOf.0","typeLabel":"object"},{"type":"null","description":"Bills this many feature units when outstanding overage reaches it.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].threshold_billing.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].threshold_billing","typeLabel":"object | null"},"included":{"type":"number","maximum":10000000000000,"description":"Number of free units included. Balance resets to this each interval for consumable features.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].included","typeLabel":"number"},"unlimited":{"type":"boolean","description":"If true, customer has unlimited access to this feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].unlimited","typeLabel":"boolean"},"pooled":{"type":"boolean","default":false,"description":"Whether entity-level grants contribute to a shared customer balance.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].pooled","typeLabel":"boolean"},"reset":{"description":"Reset configuration for consumable features. Omit for non-consumable features like seats.","type":"object","properties":{"interval":{"enum":["one_off","minute","hour","day","week","month","quarter","semi_annual","year"],"type":"string","description":"Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].reset.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].reset.interval_count","typeLabel":"number"}},"required":["interval"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].reset","typeLabel":"object"},"price":{"description":"Pricing for usage beyond included units. Omit for free features.","type":"object","properties":{"interval":{"enum":["one_off","week","month","quarter","semi_annual","year"],"type":"string","description":"Billing interval. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].price.interval","typeLabel":"enum\u003cstring>"},"billing_method":{"enum":["prepaid","usage_based"],"type":"string","description":"'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].price.billing_method","typeLabel":"enum\u003cstring>"},"amount":{"type":"number","description":"Price per billing_units after included usage. Either 'amount' or 'tiers' is required.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].price.amount","typeLabel":"number"},"additional_currencies":{"description":"Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers'.","type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].price.additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Price amount in this currency. Set explicitly per currency, not converted from the base amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].price.additional_currencies.items.[INDEX].amount","typeLabel":"number"}},"required":["currency","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].price.additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].price.additional_currencies","typeLabel":"object[]"},"tiers":{"description":"Tiered pricing. Either 'amount' or 'tiers' is required.","type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","const":"inf","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].to.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].to","typeLabel":"number | string"},"amount":{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].amount","typeLabel":"number"},"flat_amount":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].flat_amount","typeLabel":"number"},"additional_currencies":{"type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Per-unit amount for this tier in this currency.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX].amount","typeLabel":"number"},"flat_amount":{"type":"number","description":"Flat amount for this tier in this currency, if the tier uses one.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX].flat_amount","typeLabel":"number"}},"required":["currency"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies","typeLabel":"object[]"}},"required":["to","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].price.tiers.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].price.tiers","typeLabel":"object[]"},"tier_behavior":{"enum":["graduated","volume"],"type":"string","description":"How tiers price usage. 'graduated' (default) charges each unit at the rate of the tier it falls in. 'volume' picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier's rate plus its flat_amount.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].price.tier_behavior","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","description":"Number of intervals per billing cycle. Defaults to 1.","default":1,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].price.interval_count","typeLabel":"number"},"billing_units":{"type":"number","default":1,"description":"Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].price.billing_units","typeLabel":"number"},"max_purchase":{"oneOf":[{"type":"number","description":"Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].price.max_purchase.oneOf.0","typeLabel":"number"},{"type":"null","description":"Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].price.max_purchase.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].price.max_purchase","typeLabel":"number | null"}},"required":["interval","billing_method"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].price","typeLabel":"object"},"proration":{"description":"Proration settings for prepaid features. Controls mid-cycle quantity change billing.","type":"object","properties":{"on_increase":{"enum":["bill_immediately","prorate_immediately","prorate_next_cycle","bill_next_cycle"],"type":"string","description":"Billing behavior when quantity increases mid-cycle.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].proration.on_increase","typeLabel":"enum\u003cstring>"},"on_decrease":{"enum":["prorate","prorate_immediately","prorate_next_cycle","none","no_prorations"],"type":"string","description":"Credit behavior when quantity decreases mid-cycle.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].proration.on_decrease","typeLabel":"enum\u003cstring>"}},"required":["on_increase","on_decrease"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].proration","typeLabel":"object"},"rollover":{"description":"Rollover config for unused units. If set, unused included units carry over.","type":"object","properties":{"expiry_duration_type":{"enum":["month","forever"],"type":"string","description":"When rolled over units expire.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].rollover.expiry_duration_type","typeLabel":"enum\u003cstring>"},"max":{"type":"number","description":"Max rollover units. Omit for unlimited rollover.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].rollover.max","typeLabel":"number"},"max_percentage":{"type":"number","description":"Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].rollover.max_percentage","typeLabel":"number"},"expiry_duration_length":{"type":"number","description":"Number of periods before expiry.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].rollover.expiry_duration_length","typeLabel":"number"}},"required":["expiry_duration_type"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].rollover","typeLabel":"object"},"expiry":{"description":"Purchased units expire this long after each purchase. One-off prepaid consumable items only.","type":"object","properties":{"duration":{"enum":["day","week","month","year"],"type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].expiry.duration","typeLabel":"enum\u003cstring>"},"length":{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].expiry.length","typeLabel":"number"}},"required":["duration","length"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].expiry","typeLabel":"object"},"feature_override":{"description":"Overrides fields of this item's feature for customers on this plan (e.g. a credit system's credit_schema).","type":"object","properties":{"credit_schema":{"description":"For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.","type":"array","items":{"oneOf":[{"type":"object","required":["metered_feature_id","tier_behavior","tiers"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature that draws from this credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.metered_feature_id","typeLabel":"string"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers","typeLabel":"object[]"},"billing_units":{"type":"number","exclusiveMinimum":0,"description":"Number of metered-feature units priced together. Defaults to one when omitted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.billing_units","typeLabel":"number"},"dimensions":{"description":"Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies.","type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"oneOf":[{"type":"object","required":["match","tier_behavior","tiers"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.match","typeLabel":"object"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers","typeLabel":"object[]"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["match","credit_cost"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.match","typeLabel":"object"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group when this dimension matches.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.credit_cost","typeLabel":"number"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions","typeLabel":"object"},"multipliers":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"object","properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.match","typeLabel":"object"},"factor":{"type":"number","exclusiveMinimum":0,"description":"Multiplies the matched rate. All matching multipliers stack.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.factor","typeLabel":"number"},"add":{"type":"number","description":"Added to the rate after every factor is applied, in credits per billing-unit group.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.add","typeLabel":"number"}},"required":["match"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties","typeLabel":"object"},"description":"Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["metered_feature_id","credit_cost"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature that draws from this credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.metered_feature_id","typeLabel":"string"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.credit_cost","typeLabel":"number"},"billing_units":{"type":"number","exclusiveMinimum":0,"description":"Number of metered-feature units priced together. Defaults to one when omitted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.billing_units","typeLabel":"number"},"dimensions":{"description":"Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies.","type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"oneOf":[{"type":"object","required":["match","tier_behavior","tiers"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.match","typeLabel":"object"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers","typeLabel":"object[]"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["match","credit_cost"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.match","typeLabel":"object"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group when this dimension matches.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.credit_cost","typeLabel":"number"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions","typeLabel":"object"},"multipliers":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"object","properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.match","typeLabel":"object"},"factor":{"type":"number","exclusiveMinimum":0,"description":"Multiplies the matched rate. All matching multipliers stack.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.factor","typeLabel":"number"},"add":{"type":"number","description":"Added to the rate after every factor is applied, in credits per billing-unit group.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.add","typeLabel":"number"}},"required":["match"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties","typeLabel":"object"},"description":"Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["metered_feature_id","excluded"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature to remove from the credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2.metered_feature_id","typeLabel":"string"},"excluded":{"description":"Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.","type":"boolean","const":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2.excluded","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.credit_schema","typeLabel":"object[]"},"markups":{"description":"For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.","type":"object","properties":{"default_markup":{"type":"number","minimum":-100,"description":"Default percentage markup for customers on this plan. Use -100 to make usage free.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.markups.default_markup","typeLabel":"number"},"provider_markups":{"oneOf":[{"type":"object","description":"Per-provider markup percentages for customers on this plan.","additionalProperties":{"type":"object","properties":{"markup":{"type":"number","minimum":-100,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0.additionalProperties.markup","typeLabel":"number"}},"required":["markup"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0","typeLabel":"object"},{"type":"null","description":"Per-provider markup percentages for customers on this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.markups.provider_markups","typeLabel":"object | null"},"model_markups":{"oneOf":[{"type":"object","description":"Per-model markup overrides for customers on this plan.","additionalProperties":{"type":"object","properties":{"markup":{"type":"number","minimum":-100,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.markup","typeLabel":"number"},"input_cost":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.input_cost","typeLabel":"number"},"output_cost":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.output_cost","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0","typeLabel":"object"},{"type":"null","description":"Per-model markup overrides for customers on this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.markups.model_markups","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override.markups","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX].feature_override","typeLabel":"object"}},"required":["feature_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items.items.[INDEX]","typeLabel":"PlanItem · object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.add_items","typeLabel":"PlanItem · object[]"},"remove_items":{"description":"Filters selecting items to remove from the plan.","type":"array","items":{"title":"PlanItemFilter","description":"Filter for matching plan items. All provided fields must match (AND).","type":"object","properties":{"feature_id":{"type":"string","description":"Match items linked to this feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.remove_items.items.[INDEX].feature_id","typeLabel":"string"},"billing_method":{"enum":["prepaid","usage_based"],"type":"string","description":"Match items with this billing method (prepaid or usage_based).","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.remove_items.items.[INDEX].billing_method","typeLabel":"enum\u003cstring>"},"interval":{"oneOf":[{"type":"string","description":"Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.","enum":["one_off","week","month","quarter","semi_annual","year"],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.remove_items.items.[INDEX].interval.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"string","description":"Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.","enum":["one_off","minute","hour","day","week","month","quarter","semi_annual","year"],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.remove_items.items.[INDEX].interval.oneOf.1","typeLabel":"enum\u003cstring>"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.remove_items.items.[INDEX].interval","typeLabel":"enum\u003cstring>"},"interval_count":{"description":"Match items with this interval_count. Disambiguates between items that share an interval but differ in count.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.remove_items.items.[INDEX].interval_count","typeLabel":"integer"},"included":{"type":"number","maximum":10000000000000,"description":"Match items whose grant equals this included usage. Omitted is a wildcard.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.remove_items.items.[INDEX].included","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.remove_items.items.[INDEX]","typeLabel":"PlanItemFilter · object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.remove_items","typeLabel":"PlanItemFilter · object[]"},"free_trial":{"oneOf":[{"type":"object","title":"FreeTrialParams","description":"Override the plan's default free trial. Pass an object to set a custom trial, or null to remove the trial entirely.","required":["duration_length","duration_type","card_required"],"properties":{"duration_length":{"type":"number","description":"Number of duration_type periods the trial lasts.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.free_trial.oneOf.0.duration_length","typeLabel":"number"},"duration_type":{"enum":["day","month","year"],"type":"string","default":"month","description":"Unit of time for the trial ('day', 'month', 'year').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.free_trial.oneOf.0.duration_type","typeLabel":"enum\u003cstring>"},"card_required":{"type":"boolean","default":false,"description":"If true, a payment method is required to start the trial and the customer is charged when it ends. Defaults to false.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.free_trial.oneOf.0.card_required","typeLabel":"boolean"},"on_end":{"enum":["bill","revert"],"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.free_trial.oneOf.0.on_end","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.free_trial.oneOf.0","typeLabel":"FreeTrialParams · object"},{"type":"null","description":"Override the plan's default free trial. Pass an object to set a custom trial, or null to remove the trial entirely.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.free_trial.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.free_trial","typeLabel":"FreeTrialParams · object | null"},"billing_controls":{"description":"Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.","type":"object","properties":{"auto_topups":{"type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"The ID of the feature (credit balance) to auto top-up.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.auto_topups.items.[INDEX].feature_id","typeLabel":"string"},"enabled":{"type":"boolean","default":false,"description":"Whether auto top-up is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.auto_topups.items.[INDEX].enabled","typeLabel":"boolean"},"threshold":{"type":"number","description":"When the balance drops below this threshold, an auto top-up will be purchased.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.auto_topups.items.[INDEX].threshold","typeLabel":"number"},"quantity":{"type":"number","minimum":1,"description":"Amount of credits to add per auto top-up.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.auto_topups.items.[INDEX].quantity","typeLabel":"number"},"purchase_limit":{"description":"Optional rate limit to cap how often auto top-ups occur. Pass count or amount to set the current window's consumed top-ups or charged amount.","type":"object","properties":{"interval":{"enum":["hour","day","week","month"],"type":"string","description":"The time interval for the purchase limit window.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","minimum":1,"default":1,"description":"Number of intervals in the purchase limit window.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit.interval_count","typeLabel":"number"},"limit":{"type":"number","exclusiveMinimum":0,"description":"Maximum allowed within the interval: a number of auto top-ups when limit_type is count, or a total charge (e.g. 500 for $500, pre-tax) when limit_type is amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit.limit","typeLabel":"number"},"limit_type":{"enum":["count","amount"],"type":"string","description":"What `limit` caps: the number of auto top-ups (`count`, default) or the total amount charged for them, in the customer's currency (`amount`).","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit.limit_type","typeLabel":"enum\u003cstring>"},"count":{"type":"number","minimum":0,"description":"Set the current window's consumed auto top-up count. Omit to leave runtime state unchanged.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit.count","typeLabel":"number"},"amount":{"type":"number","minimum":0,"description":"Set the amount already charged by auto top-ups in the current window. Omit to leave runtime state unchanged.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit.amount","typeLabel":"number"}},"required":["interval","interval_count","limit"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.auto_topups.items.[INDEX].purchase_limit","typeLabel":"object"},"invoice_mode":{"type":"boolean","description":"When true, auto top-up creates a send_invoice invoice instead of auto-charging.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.auto_topups.items.[INDEX].invoice_mode","typeLabel":"boolean"}},"required":["feature_id","enabled","threshold","quantity"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.auto_topups.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.auto_topups","typeLabel":"object[]"},"spend_limits":{"type":"array","items":{"type":"object","properties":{"enabled":{"type":"boolean","default":false,"description":"Whether the overage spend limit is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.spend_limits.items.[INDEX].enabled","typeLabel":"boolean"},"feature_id":{"type":"string","description":"Optional feature ID this spend limit applies to.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.spend_limits.items.[INDEX].feature_id","typeLabel":"string"},"limit_type":{"enum":["absolute","usage_percentage"],"type":"string","description":"How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.spend_limits.items.[INDEX].limit_type","typeLabel":"enum\u003cstring>"},"overage_limit":{"type":"number","minimum":0,"description":"Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.spend_limits.items.[INDEX].overage_limit","typeLabel":"number"},"skip_overage_billing":{"type":"boolean","description":"When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.spend_limits.items.[INDEX].skip_overage_billing","typeLabel":"boolean"}},"required":["enabled"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.spend_limits.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.spend_limits","typeLabel":"object[]"},"usage_limits":{"type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"The feature this usage limit applies to.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.usage_limits.items.[INDEX].feature_id","typeLabel":"string"},"enabled":{"type":"boolean","default":true,"description":"Whether this usage limit is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.usage_limits.items.[INDEX].enabled","typeLabel":"boolean"},"limit":{"type":"number","minimum":0,"description":"Maximum units allowed per interval.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.usage_limits.items.[INDEX].limit","typeLabel":"number"},"interval":{"enum":["day","week","month","year"],"type":"string","description":"Interval for the cap, aligned to the customer's billing cycle.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.usage_limits.items.[INDEX].interval","typeLabel":"enum\u003cstring>"},"anchor":{"enum":["billing_cycle","utc"],"type":"string","description":"Window alignment. 'billing_cycle' phases the interval to the customer's renewal time; 'utc' aligns to the UTC calendar.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.usage_limits.items.[INDEX].anchor","typeLabel":"enum\u003cstring>"},"filter":{"description":"When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.","type":"object","properties":{"properties":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.usage_limits.items.[INDEX].filter.properties.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.usage_limits.items.[INDEX].filter.properties","typeLabel":"object"}},"required":["properties"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.usage_limits.items.[INDEX].filter","typeLabel":"object"}},"required":["feature_id","enabled","limit","interval"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.usage_limits.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.usage_limits","typeLabel":"object[]"},"usage_alerts":{"type":"array","items":{"type":"object","properties":{"enabled":{"type":"boolean","default":true,"description":"Whether this usage alert is enabled.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.usage_alerts.items.[INDEX].enabled","typeLabel":"boolean"},"threshold":{"type":"number","description":"The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage. remaining and remaining_percentage accept negative values with basis balance, to alert once the balance is overdrawn.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.usage_alerts.items.[INDEX].threshold","typeLabel":"number"},"threshold_type":{"enum":["usage","usage_percentage","remaining","remaining_percentage"],"type":"string","description":"Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.usage_alerts.items.[INDEX].threshold_type","typeLabel":"enum\u003cstring>"},"basis":{"enum":["balance","included","recurring","usage_limit"],"type":"string","default":"balance","description":"What 100% means. balance: every grant on the feature. included: the plan allowance only. recurring: grants that reset. usage_limit: the cap of the usage limit with the same feature and filter.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.usage_alerts.items.[INDEX].basis","typeLabel":"enum\u003cstring>"},"feature_id":{"type":"string","description":"The feature ID this alert applies to.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.usage_alerts.items.[INDEX].feature_id","typeLabel":"string"},"filter":{"description":"Only valid with basis usage_limit. Points the alert at the usage limit carrying the same filter.","type":"object","properties":{"properties":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.usage_alerts.items.[INDEX].filter.properties.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.usage_alerts.items.[INDEX].filter.properties","typeLabel":"object"}},"required":["properties"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.usage_alerts.items.[INDEX].filter","typeLabel":"object"},"name":{"type":"string","description":"Optional user-defined label to distinguish multiple alerts on the same feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.usage_alerts.items.[INDEX].name","typeLabel":"string"}},"required":["enabled","threshold","threshold_type","basis"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.usage_alerts.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.usage_alerts","typeLabel":"object[]"},"overage_allowed":{"type":"array","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"The feature ID this overage allowed control applies to.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.overage_allowed.items.[INDEX].feature_id","typeLabel":"string"},"enabled":{"type":"boolean","default":false,"description":"Whether overage is allowed for this feature.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.overage_allowed.items.[INDEX].enabled","typeLabel":"boolean"}},"required":["feature_id","enabled"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.overage_allowed.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls.overage_allowed","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.billing_controls","typeLabel":"object"},"upsert_licenses":{"description":"License links to add or override for this customer, keyed by license_plan_id. Omitted fields inherit the plan catalog link (included defaults to 1 when the license is not in the catalog). A bare entry restores the license to pure catalog inheritance.","type":"array","items":{"type":"object","properties":{"license_plan_id":{"type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].license_plan_id","typeLabel":"string"},"version_slug":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].version_slug","typeLabel":"string"},"included":{"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].included","typeLabel":"integer"},"prepaid_only":{"type":"boolean","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].prepaid_only","typeLabel":"boolean"},"customize":{"oneOf":[{"type":"object","properties":{"price":{"oneOf":[{"type":"object","title":"BasePrice","description":"Base price configuration for a plan.","required":["amount","interval"],"properties":{"amount":{"type":"number","description":"Base price amount for the plan, in major currency units (e.g. dollars).","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.amount","typeLabel":"number"},"interval":{"enum":["one_off","week","month","quarter","semi_annual","year"],"type":"string","description":"Billing interval (e.g. 'month', 'year').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.interval_count","typeLabel":"number"},"additional_currencies":{"description":"Base price amounts in additional currencies. The base 'amount' is in the org's default currency.","type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Price amount in this currency. Set explicitly per currency, not converted from the base amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.additional_currencies.items.[INDEX].amount","typeLabel":"number"}},"required":["currency","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0.additional_currencies","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.0","typeLabel":"BasePrice · object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.price","typeLabel":"BasePrice · object | null"},"add_items":{"type":"array","items":{"title":"PlanItem","description":"Configuration for a feature item in a plan, including usage limits, pricing, and rollover settings.","type":"object","properties":{"feature_id":{"type":"string","description":"The ID of the feature to configure.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_id","typeLabel":"string"},"threshold_billing":{"oneOf":[{"type":"object","description":"Bills this many feature units when outstanding overage reaches it.","required":["threshold"],"properties":{"threshold":{"type":"number","exclusiveMinimum":0,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].threshold_billing.oneOf.0.threshold","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].threshold_billing.oneOf.0","typeLabel":"object"},{"type":"null","description":"Bills this many feature units when outstanding overage reaches it.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].threshold_billing.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].threshold_billing","typeLabel":"object | null"},"included":{"type":"number","maximum":10000000000000,"description":"Number of free units included. Balance resets to this each interval for consumable features.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].included","typeLabel":"number"},"unlimited":{"type":"boolean","description":"If true, customer has unlimited access to this feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].unlimited","typeLabel":"boolean"},"pooled":{"type":"boolean","default":false,"description":"Whether entity-level grants contribute to a shared customer balance.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].pooled","typeLabel":"boolean"},"reset":{"description":"Reset configuration for consumable features. Omit for non-consumable features like seats.","type":"object","properties":{"interval":{"enum":["one_off","minute","hour","day","week","month","quarter","semi_annual","year"],"type":"string","description":"Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].reset.interval","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].reset.interval_count","typeLabel":"number"}},"required":["interval"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].reset","typeLabel":"object"},"price":{"description":"Pricing for usage beyond included units. Omit for free features.","type":"object","properties":{"interval":{"enum":["one_off","week","month","quarter","semi_annual","year"],"type":"string","description":"Billing interval. For usage-based features, should match reset.interval, unless the price has graduated tiers and reset.interval is a whole multiple of it: each invoice then bills only the newly owed usage, at the tier the reset period has reached.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.interval","typeLabel":"enum\u003cstring>"},"billing_method":{"enum":["prepaid","usage_based"],"type":"string","description":"'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.billing_method","typeLabel":"enum\u003cstring>"},"amount":{"type":"number","description":"Price per billing_units after included usage. Either 'amount' or 'tiers' is required.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.amount","typeLabel":"number"},"additional_currencies":{"description":"Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers'.","type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Price amount in this currency. Set explicitly per currency, not converted from the base amount.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.additional_currencies.items.[INDEX].amount","typeLabel":"number"}},"required":["currency","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.additional_currencies","typeLabel":"object[]"},"tiers":{"description":"Tiered pricing. Either 'amount' or 'tiers' is required.","type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","const":"inf","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].to.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].to","typeLabel":"number | string"},"amount":{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].amount","typeLabel":"number"},"flat_amount":{"type":"number","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].flat_amount","typeLabel":"number"},"additional_currencies":{"type":"array","items":{"type":"object","properties":{"currency":{"type":"string","description":"Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX].currency","typeLabel":"string"},"amount":{"type":"number","description":"Per-unit amount for this tier in this currency.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX].amount","typeLabel":"number"},"flat_amount":{"type":"number","description":"Flat amount for this tier in this currency, if the tier uses one.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX].flat_amount","typeLabel":"number"}},"required":["currency"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX].additional_currencies","typeLabel":"object[]"}},"required":["to","amount"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tiers","typeLabel":"object[]"},"tier_behavior":{"enum":["graduated","volume"],"type":"string","description":"How tiers price usage. 'graduated' (default) charges each unit at the rate of the tier it falls in. 'volume' picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier's rate plus its flat_amount.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.tier_behavior","typeLabel":"enum\u003cstring>"},"interval_count":{"type":"number","description":"Number of intervals per billing cycle. Defaults to 1.","default":1,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.interval_count","typeLabel":"number"},"billing_units":{"type":"number","default":1,"description":"Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.billing_units","typeLabel":"number"},"max_purchase":{"oneOf":[{"type":"number","description":"Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.max_purchase.oneOf.0","typeLabel":"number"},{"type":"null","description":"Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.max_purchase.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price.max_purchase","typeLabel":"number | null"}},"required":["interval","billing_method"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].price","typeLabel":"object"},"proration":{"description":"Proration settings for prepaid features. Controls mid-cycle quantity change billing.","type":"object","properties":{"on_increase":{"enum":["bill_immediately","prorate_immediately","prorate_next_cycle","bill_next_cycle"],"type":"string","description":"Billing behavior when quantity increases mid-cycle.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].proration.on_increase","typeLabel":"enum\u003cstring>"},"on_decrease":{"enum":["prorate","prorate_immediately","prorate_next_cycle","none","no_prorations"],"type":"string","description":"Credit behavior when quantity decreases mid-cycle.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].proration.on_decrease","typeLabel":"enum\u003cstring>"}},"required":["on_increase","on_decrease"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].proration","typeLabel":"object"},"rollover":{"description":"Rollover config for unused units. If set, unused included units carry over.","type":"object","properties":{"expiry_duration_type":{"enum":["month","forever"],"type":"string","description":"When rolled over units expire.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].rollover.expiry_duration_type","typeLabel":"enum\u003cstring>"},"max":{"type":"number","description":"Max rollover units. Omit for unlimited rollover.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].rollover.max","typeLabel":"number"},"max_percentage":{"type":"number","description":"Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].rollover.max_percentage","typeLabel":"number"},"expiry_duration_length":{"type":"number","description":"Number of periods before expiry.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].rollover.expiry_duration_length","typeLabel":"number"}},"required":["expiry_duration_type"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].rollover","typeLabel":"object"},"expiry":{"description":"Purchased units expire this long after each purchase. One-off prepaid consumable items only.","type":"object","properties":{"duration":{"enum":["day","week","month","year"],"type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].expiry.duration","typeLabel":"enum\u003cstring>"},"length":{"type":"number","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].expiry.length","typeLabel":"number"}},"required":["duration","length"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].expiry","typeLabel":"object"},"feature_override":{"description":"Overrides fields of this item's feature for customers on this plan (e.g. a credit system's credit_schema).","type":"object","properties":{"credit_schema":{"description":"For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.","type":"array","items":{"oneOf":[{"type":"object","required":["metered_feature_id","tier_behavior","tiers"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature that draws from this credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.metered_feature_id","typeLabel":"string"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.tiers","typeLabel":"object[]"},"billing_units":{"type":"number","exclusiveMinimum":0,"description":"Number of metered-feature units priced together. Defaults to one when omitted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.billing_units","typeLabel":"number"},"dimensions":{"description":"Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies.","type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"oneOf":[{"type":"object","required":["match","tier_behavior","tiers"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.match","typeLabel":"object"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.tiers","typeLabel":"object[]"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["match","credit_cost"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.match","typeLabel":"object"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group when this dimension matches.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.credit_cost","typeLabel":"number"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.dimensions","typeLabel":"object"},"multipliers":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"object","properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.match","typeLabel":"object"},"factor":{"type":"number","exclusiveMinimum":0,"description":"Multiplies the matched rate. All matching multipliers stack.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.factor","typeLabel":"number"},"add":{"type":"number","description":"Added to the rate after every factor is applied, in credits per billing-unit group.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties.add","typeLabel":"number"}},"required":["match"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers.additionalProperties","typeLabel":"object"},"description":"Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0.multipliers","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["metered_feature_id","credit_cost"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature that draws from this credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.metered_feature_id","typeLabel":"string"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.credit_cost","typeLabel":"number"},"billing_units":{"type":"number","exclusiveMinimum":0,"description":"Number of metered-feature units priced together. Defaults to one when omitted.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.billing_units","typeLabel":"number"},"dimensions":{"description":"Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies.","type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"oneOf":[{"type":"object","required":["match","tier_behavior","tiers"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.match","typeLabel":"object"},"tier_behavior":{"type":"string","const":"graduated","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tier_behavior","typeLabel":"string"},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"to":{"oneOf":[{"type":"number","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.0","typeLabel":"number"},{"type":"string","description":"Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.","enum":["inf"],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].to","typeLabel":"number | enum\u003cstring>"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group within this tier.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX].credit_cost","typeLabel":"number"}},"required":["to","credit_cost"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.tiers","typeLabel":"object[]"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.0","typeLabel":"object"},{"type":"object","required":["match","credit_cost"],"properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.match","typeLabel":"object"},"credit_cost":{"type":"number","minimum":0,"description":"Credits consumed per billing-unit group when this dimension matches.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.credit_cost","typeLabel":"number"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Breaks ties between dimensions that match the same number of keys. Higher wins.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1.priority","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties.oneOf.1","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.dimensions","typeLabel":"object"},"multipliers":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"object","properties":{"match":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.match.additionalProperties","typeLabel":"string"},"description":"Event properties this entry applies to. Every key must equal the tracked property, compared as strings.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.match","typeLabel":"object"},"factor":{"type":"number","exclusiveMinimum":0,"description":"Multiplies the matched rate. All matching multipliers stack.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.factor","typeLabel":"number"},"add":{"type":"number","description":"Added to the rate after every factor is applied, in credits per billing-unit group.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties.add","typeLabel":"number"}},"required":["match"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers.additionalProperties","typeLabel":"object"},"description":"Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1.multipliers","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["metered_feature_id","excluded"],"properties":{"metered_feature_id":{"type":"string","minLength":1,"description":"ID of the metered feature to remove from the credit system.","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2.metered_feature_id","typeLabel":"string"},"excluded":{"description":"Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.","type":"boolean","const":true,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2.excluded","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX].oneOf.2","typeLabel":"object"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.credit_schema","typeLabel":"object[]"},"markups":{"description":"For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.","type":"object","properties":{"default_markup":{"type":"number","minimum":-100,"description":"Default percentage markup for customers on this plan. Use -100 to make usage free.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.default_markup","typeLabel":"number"},"provider_markups":{"oneOf":[{"type":"object","description":"Per-provider markup percentages for customers on this plan.","additionalProperties":{"type":"object","properties":{"markup":{"type":"number","minimum":-100,"isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0.additionalProperties.markup","typeLabel":"number"}},"required":["markup"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.0","typeLabel":"object"},{"type":"null","description":"Per-provider markup percentages for customers on this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.provider_markups.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.provider_markups","typeLabel":"object | null"},"model_markups":{"oneOf":[{"type":"object","description":"Per-model markup overrides for customers on this plan.","additionalProperties":{"type":"object","properties":{"markup":{"type":"number","minimum":-100,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.markup","typeLabel":"number"},"input_cost":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.input_cost","typeLabel":"number"},"output_cost":{"type":"number","minimum":0,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties.output_cost","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0.additionalProperties","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.0","typeLabel":"object"},{"type":"null","description":"Per-model markup overrides for customers on this plan.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups.model_markups","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override.markups","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX].feature_override","typeLabel":"object"}},"required":["feature_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items.items.[INDEX]","typeLabel":"PlanItem · object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.add_items","typeLabel":"PlanItem · object[]"},"remove_items":{"type":"array","items":{"title":"PlanItemFilter","description":"Filter for matching plan items. All provided fields must match (AND).","type":"object","properties":{"feature_id":{"type":"string","description":"Match items linked to this feature.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].feature_id","typeLabel":"string"},"billing_method":{"enum":["prepaid","usage_based"],"type":"string","description":"Match items with this billing method (prepaid or usage_based).","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].billing_method","typeLabel":"enum\u003cstring>"},"interval":{"oneOf":[{"type":"string","description":"Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.","enum":["one_off","week","month","quarter","semi_annual","year"],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].interval.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"string","description":"Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.","enum":["one_off","minute","hour","day","week","month","quarter","semi_annual","year"],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].interval.oneOf.1","typeLabel":"enum\u003cstring>"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].interval","typeLabel":"enum\u003cstring>"},"interval_count":{"description":"Match items with this interval_count. Disambiguates between items that share an interval but differ in count.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].interval_count","typeLabel":"integer"},"included":{"type":"number","maximum":10000000000000,"description":"Match items whose grant equals this included usage. Omitted is a wildcard.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX].included","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items.items.[INDEX]","typeLabel":"PlanItemFilter · object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0.remove_items","typeLabel":"PlanItemFilter · object[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].customize","typeLabel":"object | null"},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].metadata.additionalProperties","typeLabel":"any"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX].metadata","typeLabel":"object"}},"required":["license_plan_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.upsert_licenses","typeLabel":"object[]"},"remove_licenses":{"description":"License links to drop, keyed by license_plan_id. Parallel to remove_items.","type":"array","items":{"type":"object","properties":{"license_plan_id":{"type":"string","isRequired":true,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.remove_licenses.items.[INDEX].license_plan_id","typeLabel":"string"}},"required":["license_plan_id"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.remove_licenses.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize.remove_licenses","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0.customize","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.0","typeLabel":"object"},{"type":"null","description":"Diff of the license's effective plan. Null when created, removed, or the effective content is unchanged.","uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX].plan_change","typeLabel":"object | null"}},"required":["license_plan_id","version","included","action","previous_attributes"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.plan_changes.items.[INDEX].plan_change.license_changes","typeLabel":"object[]"}},"required":["previous_attributes","item_changes"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX].plan_change","typeLabel":"object"}},"required":["action","previous_attributes","item_changes"],"additionalProperties":false,"uniqueKey":"data.plan_changes.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.plan_changes","typeLabel":"object[]"},"tags":{"description":"Reason tags describing why this event fired (e.g. 'trial_ended', 'phase_changed'). Always present; empty when no specific reason applies.","default":[],"type":"array","items":{"type":"string","uniqueKey":"data.tags.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.tags","typeLabel":"string[]"},"entity_id":{"oneOf":[{"type":"string","description":"The ID of the entity, if the changes are scoped to a specific entity.","uniqueKey":"data.entity_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The ID of the entity, if the changes are scoped to a specific entity.","uniqueKey":"data.entity_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.entity_id","typeLabel":"string | null"}},"required":["object","customer_id","plan_changes","tags"],"additionalProperties":false,"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"type":"billing.updated","data":{"object":"billing.updated","customer_id":"cus_123","plan_changes":[{"action":"activated","subscription":{"plan_id":"pro","status":"active","past_due":false,"started_at":1779000000000,"canceled_at":null,"expires_at":null,"trial_ends_at":null,"current_period_start":1779000000000,"current_period_end":1781592000000},"previous_attributes":null,"item_changes":[]},{"action":"expired","subscription":{"plan_id":"free","status":"expired","past_due":false,"started_at":1776000000000,"canceled_at":1779000000000,"expires_at":1779000000000,"trial_ends_at":null,"current_period_start":null,"current_period_end":null},"previous_attributes":{"status":"active"},"item_changes":[]}],"tags":[]}},"examples":{"Example":{"title":"Example","value":{"type":"billing.updated","data":{"object":"billing.updated","customer_id":"cus_123","plan_changes":[{"action":"activated","subscription":{"plan_id":"pro","status":"active","past_due":false,"started_at":1779000000000,"canceled_at":null,"expires_at":null,"trial_ends_at":null,"current_period_start":1779000000000,"current_period_end":1781592000000},"previous_attributes":null,"item_changes":[]},{"action":"expired","subscription":{"plan_id":"free","status":"expired","past_due":false,"started_at":1776000000000,"canceled_at":1779000000000,"expires_at":1779000000000,"trial_ends_at":null,"current_period_start":null,"current_period_end":null},"previous_attributes":{"status":"active"},"item_changes":[]}],"tags":[]}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"cf843492-ad7b-4892-a199-dbab59e79c6f":{"description":"Webhook received successfully.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"5fa91c57-6f3e-4574-a1a0-b31635047121":{"secretKey":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"secretKey"}}},"servers":{"b9562f6e-da6c-4347-b728-e83ef4de48d9":{"url":"https://api.useautumn.com","description":"Production server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"secretKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"secretKey","name":"Authorization"}],"title":"secretKey"}]},"originalFileLocation":"api/openapi.yml"},"subdomain":"autumn-b9b4c0fb","siteName":"Autumn","title":"Plans Updated - Autumn","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-13T19:30:20.402Z","originalFileLocation":"api-reference/webhooks/billingUpdated.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Fired when a customer\u0026#x27;s plans change — activated, scheduled, updated, or expired. Each event carries a plan_changes array describing what happened and a tags array (e.g. trial_ended, phase_changed) describing why.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Autumn\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/autumn-b9b4c0fb/LQO5vXfVIKEXnzb8/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/autumn-b9b4c0fb/LQO5vXfVIKEXnzb8/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/autumn-b9b4c0fb/LQO5vXfVIKEXnzb8/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/autumn-b9b4c0fb/LQO5vXfVIKEXnzb8/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/autumn-b9b4c0fb/LQO5vXfVIKEXnzb8/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/autumn-b9b4c0fb/LQO5vXfVIKEXnzb8/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/autumn-b9b4c0fb/LQO5vXfVIKEXnzb8/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/autumn-b9b4c0fb/LQO5vXfVIKEXnzb8/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/autumn-b9b4c0fb/LQO5vXfVIKEXnzb8/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Plans Updated - Autumn\">\u003cmeta data-mint-head property=\"og:description\" content=\"Fired when a customer\u0026#x27;s plans change — activated, scheduled, updated, or expired. Each event carries a plan_changes array describing what happened and a tags array (e.g. trial_ended, phase_changed) describing why.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Autumn\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.useautumn.com/api-reference/webhooks/billingUpdated\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://autumn-b9b4c0fb.mintlify.site/_mintlify/api/og/v2?division=Billing\u0026amp;title=Plans+Updated\u0026amp;description=Fired+when+a+customer%27s+plans+change+%E2%80%94+activated%2C+scheduled%2C+updated%2C+or+expired.+Each+event+carries+a+%60plan_changes%60+array+describing+what+happened+and+a+%60tags\u0026amp;theme=b0d9fe0672df3d1498e7d4e9\u0026amp;signature=021eca5532f6461b7a544f138adab4fe89aaa9f2d1711eb87fbbf9bda088119a\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Plans Updated - Autumn\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Fired when a customer\u0026#x27;s plans change — activated, scheduled, updated, or expired. Each event carries a plan_changes array describing what happened and a tags array (e.g. trial_ended, phase_changed) describing why.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://autumn-b9b4c0fb.mintlify.site/_mintlify/api/og/v2?division=Billing\u0026amp;title=Plans+Updated\u0026amp;description=Fired+when+a+customer%27s+plans+change+%E2%80%94+activated%2C+scheduled%2C+updated%2C+or+expired.+Each+event+carries+a+%60plan_changes%60+array+describing+what+happened+and+a+%60tags\u0026amp;theme=b0d9fe0672df3d1498e7d4e9\u0026amp;signature=021eca5532f6461b7a544f138adab4fe89aaa9f2d1711eb87fbbf9bda088119a\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/autumn-b9b4c0fb/LQO5vXfVIKEXnzb8/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Autumn\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#8838ff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.useautumn.com/api-reference/webhooks/billingUpdated\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/webhooks/billingUpdated.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.useautumn.com/#organization\",\"name\":\"Autumn\",\"url\":\"https://docs.useautumn.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/autumn-b9b4c0fb/BOEMpWFJsAdGcii1/assets/logo/autumn-dark.svg?fit=max\u0026auto=format\u0026n=BOEMpWFJsAdGcii1\u0026q=85\u0026s=720bd2227c435e77f2c91cbfcbccd274\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.useautumn.com#website\",\"name\":\"Autumn\",\"url\":\"https://docs.useautumn.com\",\"publisher\":{\"@id\":\"https://docs.useautumn.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.useautumn.com/api-reference/webhooks/billingUpdated#webpage\",\"url\":\"https://docs.useautumn.com/api-reference/webhooks/billingUpdated\",\"name\":\"Plans Updated\",\"description\":\"Fired when a customer's plans change — activated, scheduled, updated, or expired. Each event carries a plan_changes array describing what happened and a tags array (e.g. trial_ended, phase_changed) describing why.\",\"dateModified\":\"2026-11-13T19:30:20.402Z\",\"isPartOf\":{\"@id\":\"https://docs.useautumn.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.useautumn.com/api-reference/webhooks/billingUpdated#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.useautumn.com/api-reference/webhooks/billingUpdated#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Webhook Events\",\"item\":\"https://docs.useautumn.com/api-reference/webhooks/balancesUsageAlertTriggered\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Billing\",\"item\":\"https://docs.useautumn.com/api-reference/webhooks/billingAutoTopupFailed\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Plans Updated\",\"item\":\"https://docs.useautumn.com/api-reference/webhooks/billingUpdated\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.useautumn.com/api-reference/webhooks/billingUpdated#apireference\",\"headline\":\"Plans Updated\",\"name\":\"Plans Updated\",\"description\":\"Fired when a customer's plans change — activated, scheduled, updated, or expired. Each event carries a plan_changes array describing what happened and a tags array (e.g. trial_ended, phase_changed) describing why.\",\"url\":\"https://docs.useautumn.com/api-reference/webhooks/billingUpdated\",\"mainEntityOfPage\":{\"@id\":\"https://docs.useautumn.com/api-reference/webhooks/billingUpdated#webpage\"},\"dateModified\":\"2026-11-13T19:30:20.402Z\",\"publisher\":{\"@id\":\"https://docs.useautumn.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.useautumn.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Autumn\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Autumn\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/webhooks/billingUpdated.md","siteName":"Autumn","nav":{"global":{"anchors":[{"anchor":"Discord","icon":"discord","href":"https://discord.gg/STqxY92zuS"},{"anchor":"Website","icon":"globe","href":"https://useautumn.com"}]},"tabs":[{"tab":"Documentation","icon":"folder-open","pages":[{"title":"Documentation","href":"/welcome"}]},{"tab":"Examples","icon":"graduation-cap","pages":[{"title":"Examples","href":"/examples/monetary-credits"}]},{"tab":"CLI","icon":"square-terminal","pages":[{"title":"CLI","href":"/cli/getting-started"}]},{"tab":"API Reference","icon":"display-code","groups":[{"group":"Billing","pages":[{"title":"Attach","openapi":"openapi POST /v1/billing.attach","href":"/api-reference/billing/attach"},{"title":"Update Subscription","openapi":"openapi POST /v1/billing.update","href":"/api-reference/billing/billingUpdate"},{"title":"Open Customer Portal","openapi":"openapi POST /v1/billing.open_customer_portal","href":"/api-reference/billing/openCustomerPortal"},{"title":"Setup Payment","openapi":"openapi POST /v1/billing.setup_payment","href":"/api-reference/billing/setupPayment"},{"title":"Transfer Plan","openapi":"openapi POST /v1/billing.transfer","href":"/api-reference/billing/billingTransfer"},{"title":"Multi Attach","openapi":"openapi POST /v1/billing.multi_attach","href":"/api-reference/billing/multiAttach"},{"title":"Multi Update","openapi":"openapi POST /v1/billing.multi_update","href":"/api-reference/billing/multiUpdate"},{"title":"Create Schedule","openapi":"openapi POST /v1/billing.create_schedule","href":"/api-reference/billing/createSchedule"},{"title":"Verify","openapi":"openapi POST /v1/billing.verify","href":"/api-reference/billing/verify"},{"title":"Import","openapi":"openapi POST /v1/billing.import","href":"/api-reference/billing/import"},{"group":"Previews","pages":[{"title":"Preview Attach","openapi":"openapi POST /v1/billing.preview_attach","href":"/api-reference/billing/previewAttach"},{"title":"Preview Update","openapi":"openapi POST /v1/billing.preview_update","href":"/api-reference/billing/previewUpdate"},{"title":"Preview Multi Attach","openapi":"openapi POST /v1/billing.preview_multi_attach","href":"/api-reference/billing/previewMultiAttach"},{"title":"Preview Multi Update","openapi":"openapi POST /v1/billing.preview_multi_update","href":"/api-reference/billing/previewMultiUpdate"}]},{"group":"Licenses","pages":[{"title":"Attach License","openapi":"openapi POST /v1/licenses.attach","href":"/api-reference/licenses/attachLicense"},{"title":"Release License","openapi":"openapi POST /v1/licenses.release","href":"/api-reference/licenses/releaseLicense"},{"title":"List Licenses","openapi":"openapi POST /v1/licenses.list","href":"/api-reference/licenses/listLicenses"},{"title":"List License Assignments","openapi":"openapi POST /v1/licenses.list_assignments","href":"/api-reference/licenses/listLicenseAssignments"}]}]},{"group":"Balances","pages":[{"title":"Check Permissions","openapi":"openapi POST /v1/balances.check","href":"/api-reference/core/check"},{"title":"Track Usage","openapi":"openapi POST /v1/balances.track","href":"/api-reference/core/track"},{"title":"Batch Track Usage","openapi":"openapi POST /v1/balances.batch_track","href":"/api-reference/core/batchTrack"},{"title":"List Balances","openapi":"openapi POST /v1/balances.list","href":"/api-reference/balances/listBalances"},{"title":"List Balance Ledger","openapi":"openapi POST /v1/balances.list_ledger","href":"/api-reference/balances/listBalanceLedger"},{"title":"Aggregate Balance Ledger","openapi":"openapi POST /v1/balances.aggregate_ledger","href":"/api-reference/balances/aggregateBalanceLedger"},{"title":"Create Balance","openapi":"openapi POST /v1/balances.create","href":"/api-reference/balances/createBalance"},{"title":"Update Balance","openapi":"openapi POST /v1/balances.update","href":"/api-reference/balances/updateBalance"},{"title":"Delete Balance","openapi":"openapi POST /v1/balances.delete","href":"/api-reference/balances/deleteBalance"},{"title":"Finalize Lock","openapi":"openapi POST /v1/balances.finalize","href":"/api-reference/balances/finalizeLock"}]},{"group":"Customers","pages":[{"title":"Get or Create Customer","openapi":"openapi POST /v1/customers.get_or_create","href":"/api-reference/customers/getOrCreateCustomer"},{"title":"Get Customer","openapi":"openapi POST /v1/customers.get","href":"/api-reference/customers/getCustomer"},{"title":"List Customers","openapi":"openapi POST /v1/customers.list","href":"/api-reference/customers/listCustomers"},{"title":"List Subscriptions","openapi":"openapi POST /v1/subscriptions.list","href":"/api-reference/customers/listSubscriptions"},{"title":"List Purchases","openapi":"openapi POST /v1/purchases.list","href":"/api-reference/customers/listPurchases"},{"title":"Update Customer","openapi":"openapi POST /v1/customers.update","href":"/api-reference/customers/updateCustomer"},{"title":"Delete Customer","openapi":"openapi POST /v1/customers.delete","href":"/api-reference/customers/deleteCustomer"},{"title":"Swap Customer IDs","openapi":"openapi POST /v1/customers.swap","href":"/api-reference/customers/swapCustomers"}]},{"group":"Invoices","pages":[{"title":"List Invoices","openapi":"openapi POST /v1/invoices.list","href":"/api-reference/invoices/listInvoices"},{"title":"Create Invoice","openapi":"openapi POST /v1/invoices.create","href":"/api-reference/invoices/createInvoice"},{"title":"Mark Invoice as Paid","openapi":"openapi POST /v1/invoices.pay","href":"/api-reference/invoices/payInvoice"},{"title":"Void Invoice","openapi":"openapi POST /v1/invoices.void","href":"/api-reference/invoices/voidInvoice"},{"title":"Reissue Invoice","openapi":"openapi POST /v1/invoices.reissue","href":"/api-reference/invoices/reissueInvoice"},{"title":"Issue Credit Note","openapi":"openapi POST /v1/invoices.issue_credit_note","href":"/api-reference/invoices/issueCreditNote"},{"title":"Backfill Invoices","openapi":"openapi POST /v1/invoices.insert","href":"/api-reference/invoices/insertInvoices"},{"title":"List Invoice Templates","openapi":"openapi POST /v1/invoices.listTemplates","href":"/api-reference/invoices/listInvoiceTemplates"}]},{"group":"Authorization","pages":[{"title":"Mint","openapi":"openapi POST /v1/keys.mint","href":"/api-reference/keys/mintKey"},{"title":"Refresh","openapi":"openapi POST /v1/keys.refresh","href":"/api-reference/keys/refreshKey"},{"title":"Revoke","openapi":"openapi POST /v1/keys.revoke","href":"/api-reference/keys/revokeKey"}]},{"group":"Analytics","pages":[{"title":"List Events","openapi":"openapi POST /v1/events.list","href":"/api-reference/events/listEvents"},{"title":"Aggregate Events","openapi":"openapi POST /v1/events.aggregate","href":"/api-reference/events/aggregateEvents"},{"title":"Query events in SQL","openapi":"openapi POST /v1/events.query","href":"/api-reference/events/queryEvents"},{"title":"Query data in SQL","openapi":"openapi POST /v1/analytics.query","href":"/api-reference/analytics/queryAnalytics"}]},{"group":"Logs","pages":[{"title":"Search Request Logs","openapi":"openapi POST /v1/logs.search","href":"/api-reference/logs/searchRequestLogs"}]},{"group":"Entities","pages":[{"title":"Get Entity","openapi":"openapi POST /v1/entities.get","href":"/api-reference/entities/getEntity"},{"title":"List Entities","openapi":"openapi POST /v1/entities.list","href":"/api-reference/entities/listEntities"},{"title":"Create Entity","openapi":"openapi POST /v1/entities.create","href":"/api-reference/entities/createEntity"},{"title":"Update Entity","openapi":"openapi POST /v1/entities.update","href":"/api-reference/entities/updateEntity"},{"title":"Delete Entity","openapi":"openapi POST /v1/entities.delete","href":"/api-reference/entities/deleteEntity"}]},{"group":"Accounts","pages":[{"title":"Get Account","openapi":"openapi POST /v1/accounts.get","href":"/api-reference/accounts/getAccount"},{"title":"Update Account","openapi":"openapi POST /v1/accounts.update","href":"/api-reference/accounts/updateAccount"}]},{"group":"Plans","pages":[{"title":"Get a plan","openapi":"openapi POST /v1/plans.get","href":"/api-reference/plans/getPlan"},{"title":"List all plans","openapi":"openapi POST /v1/plans.list","href":"/api-reference/plans/listPlans"},{"title":"Create a plan","openapi":"openapi POST /v1/plans.create","href":"/api-reference/plans/createPlan"},{"title":"Update a plan","openapi":"openapi POST /v1/plans.update","href":"/api-reference/plans/updatePlan"},{"title":"Delete a plan","openapi":"openapi POST /v1/plans.delete","href":"/api-reference/plans/deletePlan"}]},{"group":"Features","pages":[{"title":"Get Feature","openapi":"openapi POST /v1/features.get","href":"/api-reference/features/getFeature"},{"title":"List Features","openapi":"openapi POST /v1/features.list","href":"/api-reference/features/listFeatures"},{"title":"Create Feature","openapi":"openapi POST /v1/features.create","href":"/api-reference/features/createFeature"},{"title":"Update Feature","openapi":"openapi POST /v1/features.update","href":"/api-reference/features/updateFeature"},{"title":"Delete Feature","openapi":"openapi POST /v1/features.delete","href":"/api-reference/features/deleteFeature"}]},{"group":"Rewards \u0026 Referrals","pages":[{"title":"Create Referral Program","openapi":"openapi POST /v1/referral_programs.create","href":"/api-reference/referrals/createReferralProgram"},{"title":"List Referral Programs","openapi":"openapi POST /v1/referral_programs.list","href":"/api-reference/referrals/listReferralPrograms"},{"title":"Get Referral Program","openapi":"openapi POST /v1/referral_programs.get","href":"/api-reference/referrals/getReferralProgram"},{"title":"Update Referral Program","openapi":"openapi POST /v1/referral_programs.update","href":"/api-reference/referrals/updateReferralProgram"},{"title":"Delete Referral Program","openapi":"openapi POST /v1/referral_programs.delete","href":"/api-reference/referrals/deleteReferralProgram"},{"title":"Create Referral Code","openapi":"openapi POST /v1/referrals.create_code","href":"/api-reference/referrals/createReferralCode"},{"title":"Redeem Referral Code","openapi":"openapi POST /v1/referrals.redeem_code","href":"/api-reference/referrals/redeemReferralCode"},{"title":"Create Reward","openapi":"openapi POST /v1/rewards.create","href":"/api-reference/rewards/createReward"},{"title":"List Rewards","openapi":"openapi POST /v1/rewards.list","href":"/api-reference/rewards/listRewards"},{"title":"Get Reward","openapi":"openapi POST /v1/rewards.get","href":"/api-reference/rewards/getReward"},{"title":"Update Reward","openapi":"openapi POST /v1/rewards.update","href":"/api-reference/rewards/updateReward"},{"title":"Delete Reward","openapi":"openapi POST /v1/rewards.delete","href":"/api-reference/rewards/deleteReward"},{"title":"Redeem Reward Code","openapi":"openapi POST /v1/rewards.redeem","href":"/api-reference/rewards/redeemRewardCode"}]},{"group":"Webhooks","pages":[{"title":"Get Webhook","openapi":"openapi POST /v1/webhooks.get","href":"/api-reference/webhooks/getWebhook"},{"title":"List Webhooks","openapi":"openapi POST /v1/webhooks.list","href":"/api-reference/webhooks/listWebhooks"},{"title":"Create Webhook","openapi":"openapi POST /v1/webhooks.create","href":"/api-reference/webhooks/createWebhook"},{"title":"Update Webhook","openapi":"openapi POST /v1/webhooks.update","href":"/api-reference/webhooks/updateWebhook"},{"title":"Delete Webhook","openapi":"openapi POST /v1/webhooks.delete","href":"/api-reference/webhooks/deleteWebhook"},{"title":"Sync Webhooks","openapi":"openapi POST /v1/webhooks.sync","href":"/api-reference/webhooks/syncWebhooks"},{"group":"Previews","pages":[{"title":"Preview Sync Webhooks","openapi":"openapi POST /v1/webhooks.preview_sync","href":"/api-reference/webhooks/previewSyncWebhooks"}]}]},{"group":"Webhook Events","pages":[{"group":"Balances","pages":[{"title":"Usage Alert Triggered","openapi":"api/openapi.yml webhook balances.usage_alert_triggered","href":"/api-reference/webhooks/balancesUsageAlertTriggered"},{"title":"Limit Reached","openapi":"api/openapi.yml webhook balances.limit_reached","href":"/api-reference/webhooks/balancesLimitReached"}]},{"group":"Billing","pages":[{"title":"Auto Top-Up Failed","openapi":"api/openapi.yml webhook billing.auto_topup_failed","href":"/api-reference/webhooks/billingAutoTopupFailed"},{"title":"Auto Top-Up Succeeded","openapi":"api/openapi.yml webhook billing.auto_topup_succeeded","description":"Fired when an automatic top-up grants additional prepaid balance.","href":"/api-reference/webhooks/billingAutoTopupSucceeded"},{"title":"Plans Updated","openapi":"api/openapi.yml webhook billing.updated","href":"/api-reference/webhooks/billingUpdated"}]},{"group":"Invoice","pages":[{"title":"Invoice Finalized","openapi":"api/openapi.yml webhook invoice.finalized","description":"Fired when a Stripe invoice is finalized and its line items have been reconciled. The body is the invoice as returned by `invoices.list`, with `items` populated and each item carrying a per-entity `entities` breakdown.","href":"/api-reference/webhooks/invoiceFinalized"}]},{"group":"Vercel","pages":[{"title":"Resource Deleted","openapi":"api/openapi.yml webhook vercel.resources.deleted","href":"/api-reference/webhooks/vercelResourcesDeleted"},{"title":"Resource Provisioned","openapi":"api/openapi.yml webhook vercel.resources.provisioned","href":"/api-reference/webhooks/vercelResourcesProvisioned"},{"title":"Rotate Secrets","openapi":"api/openapi.yml webhook vercel.resources.rotate_secrets","href":"/api-reference/webhooks/vercelResourcesRotateSecrets"},{"title":"Webhook Event","openapi":"api/openapi.yml webhook vercel.webhooks.event","href":"/api-reference/webhooks/vercelWebhooksEvent"}]}]},{"group":"Platform (Beta)","pages":[{"title":"Overview","href":"/api-reference/platform/overview"},{"title":"Create Organization","openapi":"platform POST /platform/organizations","href":"/api-reference/platform/create-organization"},{"title":"Generate Stripe OAuth URL","openapi":"platform POST /platform/oauth_url","href":"/api-reference/platform/oauth-url"},{"title":"Get Stripe Connection","openapi":"openapi POST /v1/platform.get_stripe_connection","href":"/api-reference/platform/getStripeConnection"},{"title":"Disconnect Stripe","openapi":"openapi POST /v1/platform.disconnect_stripe","href":"/api-reference/platform/disconnectStripe"},{"title":"Update Connected Stripe Account","openapi":"platform POST /platform/organizations/stripe","href":"/api-reference/platform/update-stripe"},{"title":"List Users","openapi":"platform GET /platform/users","href":"/api-reference/platform/list-users"},{"title":"List Organizations","openapi":"platform GET /platform/organizations","href":"/api-reference/platform/list-orgs"}]}]},{"tab":"Lakehouse","icon":"database","dropdowns":[{"dropdown":"v2.6 (latest)","icon":"database","groups":[{"group":"Lakehouse","pages":[{"title":"Lakehouse Overview","sidebarTitle":"Overview","href":"/documentation/lakehouse/v2-6/overview"},{"title":"Connecting","sidebarTitle":"Connecting","href":"/documentation/lakehouse/v2-6/connecting"},{"title":"Schema Reference","sidebarTitle":"Schema Reference","href":"/documentation/lakehouse/v2-6/schema"},{"title":"Migrating from v2.3","sidebarTitle":"Migrating from v2.3","href":"/documentation/lakehouse/v2-6/migrating-from-v2-3"}]},{"group":"Guides","pages":[{"title":"Working with balances","sidebarTitle":"Working with balances","href":"/documentation/lakehouse/v2-6/balances"},{"title":"Working with invoices","sidebarTitle":"Working with invoices","href":"/documentation/lakehouse/v2-6/working-with-invoices"},{"title":"Querying","sidebarTitle":"Querying","href":"/documentation/lakehouse/v2-6/querying"},{"title":"Rebuild a customer or entity","sidebarTitle":"Rebuild a customer or entity","href":"/documentation/lakehouse/v2-6/rebuild-customer-and-entity"}]}]},{"dropdown":"v2.3 (legacy)","icon":"clock-rotate-left","groups":[{"group":"Lakehouse v2.3 (legacy)","pages":[{"title":"Lakehouse Overview","sidebarTitle":"Overview","href":"/documentation/lakehouse/v2-3/overview"},{"title":"Connecting","sidebarTitle":"Connecting","href":"/documentation/lakehouse/v2-3/connecting"},{"title":"Schema Reference","sidebarTitle":"Schema Reference","href":"/documentation/lakehouse/v2-3/schema"},{"title":"Working with balances","sidebarTitle":"Working with balances","href":"/documentation/lakehouse/v2-3/balance-semantics"},{"title":"Working with invoices","sidebarTitle":"Working with invoices","href":"/documentation/lakehouse/v2-3/working-with-invoices"},{"title":"Querying","sidebarTitle":"Querying","href":"/documentation/lakehouse/v2-3/querying"}]}]}]},{"tab":"Changelog","icon":"list-ol","pages":[{"title":"Changelog","href":"/changelog/changelog"}]}]},"basePath":"","title":"Plans Updated - Autumn","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CrDfRf61.js","snippetPresets-Dv-cOUrx.js","utils-BUTreAgv.js","style-to-object-BY3JEAdk.js","utils-wsznt9RM.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DEsMlaPy.js","conditional-requirements-CFM0id0Q.js","cloneDeep-DontW4xJ.js","_Uint8Array-pP7X6_RM.js","isObject-FP1Yky1u.js","ApiExamples-CU_aGGP0.js","usePlaygroundInputsStore-7dNmUIbS.js","shallow-fTtruD8x.js","isEqual-BRfNFpSD.js","CodeSnippets-52884wUJ.js","CodeSnippet-eoRjC4Le.js","getApiPlaygroundDisplay-CZyAPlR2.js","Page-Cr9IwkK7.js","DynamicMarkdown-NFqqduU7.js","SectionHeading-DQ-mJoAt.js","icon-DXTBUt6s.js","MethodPill-2v-b3js5.js","getPastedJson-v_8Y1_4v.js","DuplicateIcon-DXIkhZIo.js","createIcon-DRpYuPZs.js","axios-CsQoIw0U.js","Markdown-CwtoSfEf.js","AssistantPageLink-CTqa3eoi.js","dist-DIfYWxfm.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}