Update a billable metric

curl --request PUT \
  --url https://api.metronome.com/v1/billable-metrics/{billable_metric_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "CPU hours"
}
'

{
  "data": {
    "id": "8deed800-1b7a-495d-a207-6c52bac54dc9"
  }
}

Billable metrics

Update a billable metric

Updates only the display name of an existing billable metric. Use this to correct mistakes or apply standardized naming conventions across all billable metrics. Returns the billable metric ID to confirm the update.

Important: Only the name can be modified via this endpoint; configurations cannot be changed after creation.

Example workflow:

If you need to make changes to a streaming billable metric, for example, Metronome supports easily rolling out these changes using a simple workflow:

Duplicate the billable metric
Make required changes
Save the metric
Navigate to the product you have associated with the incorrect metric
Schedule the product to reference the newly created metric on the appropriate date

PUT

billable-metrics

{billable_metric_id}

Update a billable metric

curl --request PUT \
  --url https://api.metronome.com/v1/billable-metrics/{billable_metric_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "CPU hours"
}
'

{
  "data": {
    "id": "8deed800-1b7a-495d-a207-6c52bac54dc9"
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

billable_metric_id

string<uuid>

required

Body

application/json

The billable metric to update

name

string

required

The new name of the metric

Response

200 - application/json

Success

data

object

required

Show child attributes

List all billable metrics

Archive a billable metric

⌘I