metronome-group-keys
metronome-group-keys
Designs the group_keys array on a billable metric, and the matching
pricing_group_key / presentation_group_key on its product. Extends
metronome-setup-catalog's Step 1 — read this before calling
POST /v1/billable-metrics/create whenever more than one dimension is involved.
Every property referenced in group_keys, and your aggregation_key, needs a
matching property_filters entry with exists: true. These are two independent
checks — omitting either produces a specific, named error ("Group key '<key>' does not match one of the property filter names." for a group_keys mismatch,
"The specified aggregation key must be one of the property filter names." for the
aggregation_key), and you can get several of these back together in one response.
property_filters is optional on the API, but in practice you'll always need one
entry per dimension you group by — this is the single most common mistake when adding
group keys to an existing metric.