Sign in

v49

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-081445491.8 MB
Dimensional Price Group

Create dimensional price group

A dimensional price group is used to partition the result of a billable metric by a set of dimensions. Prices in a price group must specify the partition used to derive their usage.

For example, suppose we have a billable metric that measures the number of widgets used and we want to charge differently depending on the color of the widget. We can create a price group with a dimension "color" and two prices: one that charges $10 per red widget and one that charges $20 per blue widget.

post/dimensional_price_groups

Request body

metadataobject nullable

User-specified key/value pairs for the resource. Individual keys can be removed by setting the value to null, and the entire metadata mapping can be cleared by setting metadata to null.

namestring required
external_dimensional_price_group_idstring nullable
dimensionsstring[] required

The set of keys (in order) used to disambiguate prices in the group.

billable_metric_idstring required

Example request

{
  "dimensions": [
    "region",
    "instance_type"
  ]
}

Response

Created

metadataobject required

User specified key-value pairs for the resource. If not present, this defaults to an empty dictionary. Individual keys can be removed by setting the value to null, and the entire metadata mapping can be cleared by setting metadata to null.

idstring required
namestring required

The name of the dimensional price group

external_dimensional_price_group_idstring nullable required

An alias for the dimensional price group

dimensionsstring[] required

The dimensions that this dimensional price group is defined over

billable_metric_idstring required

The billable metric associated with this dimensional price group. All prices associated with this dimensional price group will be computed using this billable metric.

Example response

{
  "external_dimensional_price_group_id": "my_dimensional_price_group_id",
  "dimensions": [
    "region",
    "instance_type"
  ]
}