Set a contract usage filter

If a customer has multiple contracts with overlapping rates, the usage filter routes usage to the appropriate contract based on a predefined group key.

As an example, imagine you have a customer associated with two projects. Each project is associated with its own contract. You can create a usage filter with group key project_id on each contract, and route usage for project_1 to the first contract and project_2 to the second contract.

Use this endpoint to:

• Support enterprise contracting scenarios where multiple contracts are associated to the same customer with the same rates.
• Update the usage filter associated with the contract over time.

Usage guidelines:

To use usage filters, the group_key must be defined on the billable metrics underlying the rate card on the contracts.