New Usage Contract Configuration (V3 only)
March 3rd, 2026
Contract usage billing configuration has been restructured into a single usage_configuration object:
- Breaking Change: The
usage_overage_invoicingandusage_commitmenttop-level fields on the Contract response have been replaced byusage_configuration - The new
usage_configurationobject contains:usage_invoicing- Usage invoicing frequency, payment terms, invoice date, and cycleminimum_commitment_invoicing- Commitment invoicing frequency and payment terms (only present when a minimum commitment is configured)minimum_commitment_cycle- How often the minimum commitment resets (MONTHLYorCONTRACT)contract_level_minimum_commitment- Shared minimum commitment across all usage items
- Item-level minimum commitments: Contract items with usage pricing now support
usage_minimum_commitmentfor per-item commitments - The
intervalfield has been removed fromUsageCommitment; useminimum_commitment_cycleinstead
