v2

latestOpenAPI 3.0.0raw.githubusercontent.com2026-02-16143114179.4 KB
Billable Metrics

Update a billable metric

Update billable metric details. Code and aggregation type cannot be changed.

patch/api/billable-metrics/{id}

Path parameters

idstring required

Billable Metric ID

Request body

namestring
descriptionstring
fieldNamestring
recurringboolean

Example request

{
  "name": "API Requests",
  "description": "Number of API requests",
  "fieldName": "tokens",
  "filters": [
    {
      "key": "region",
      "values": [
        "us-east",
        "eu-west"
      ]
    }
  ]
}

Response

Billable metric updated

idstring required
namestring required
codestring required
descriptionstring
aggregationType'COUNT' | 'SUM' | 'MAX' | 'UNIQUE_COUNT' | 'LATEST' | 'WEIGHTED_SUM' required
fieldNamestring
recurringboolean required
createdAtstring required
updatedAtstring required

Example response

{
  "id": "clx1234567890",
  "name": "API Calls",
  "code": "api_calls",
  "description": "Number of API calls made",
  "aggregationType": "COUNT",
  "fieldName": "tokens",
  "filters": [
    {
      "id": "clx1234567890",
      "key": "region",
      "values": [
        "us-east",
        "us-west",
        "eu"
      ]
    }
  ]
}