Update a billable metric

LAGO_URL="https://api.getlago.com"
API_KEY="__YOUR_API_KEY__"

curl --location --request PUT "$LAGO_URL/api/v1/billable_metrics/:code" \
  --header "Authorization: Bearer $API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "billable_metric": {
      "name": "Storage",
      "code": "storage",
      "description": "GB of storage used in my application",
      "aggregation_type": "sum_agg",
      "recurring": false,
      "field_name": "gb",
      "weighted_interval": "seconds",
      "filters": [
        {
          "key": "provider",
          "values": ["us-east-1", "us-east-2", "eu-west-1"]
        }
      ]
    }
  }'

Authorizations

Authorization

string

header

required

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

Path Parameters

code

string

required

Code of the existing billable metric.

Example:

"storage"

Body

application/json

Billable metric payload

billable_metric

object

required

Show child attributes

billable_metric.name

string

Name of the billable metric.

Example:

"Storage"

billable_metric.code

string

Unique code used to identify the billable metric associated with the API request. This code associates each event with the correct metric.

Example:

"storage"

billable_metric.description

string | null

Internal description of the billable metric.

Example:

"GB of storage used in my application"

billable_metric.recurring

boolean

Defines if the billable metric is persisted billing period over billing period.

If set to true: the accumulated number of units calculated from the previous billing period is persisted to the next billing period.
If set to false: the accumulated number of units is reset to 0 at the end of the billing period.
If not defined in the request, default value is false.

Example:

false

billable_metric.expression

string | null

Expression used to calculate the event units. The expression is evalutated for each event and the result is then used to calculate the total aggregated units. Accepted function are ceil, concat and round as well as +, -, \ and * operations. Round is accepting an optional second parameter to specify the number of decimal.

Example:

"round((ended_at - started_at) * units)"

billable_metric.rounding_function

enum<string> | null

Refers to the numeric value or mathematical expression that will be rounded based on the calculated number of billing units. Possible values are round, ceil and floor.

Available options:

ceil,

floor,

round,

Example:

"round"

billable_metric.rounding_precision

integer | null

Specifies the number of decimal places to which the rounding_function will be rounded. It can be a positive or negative value.

Example:

2

billable_metric.field_name

string | null

Property of the billable metric used for aggregating usage data. This field is not required for count_agg.

Example:

"gb"

billable_metric.aggregation_type

enum<string>

Aggregation method used to compute usage for this billable metric.

Available options:

count_agg,

sum_agg,

max_agg,

unique_count_agg,

weighted_sum_agg,

latest_agg

Example:

"sum_agg"

billable_metric.weighted_interval

enum<string> | null

Parameter exclusively utilized in conjunction with the weighted_sum aggregation type. It serves to adjust the aggregation result by assigning weights and proration to the result based on time intervals. When this field is not provided, the default time interval is assumed to be in seconds.

Available options:

seconds,

Example:

"seconds"

billable_metric.filters

object[]

Show child attributes

billable_metric.filters.key

string

required

Filter key to add to the event properties payload

Example:

"region"

billable_metric.filters.values

string[]

required

List of possible filter values

Response

Billable metric updated

billable_metric

object

required

Show child attributes

billable_metric.lago_id

string<uuid>

required

Unique identifier of the billable metric created by Lago.

Example:

"1a901a90-1a90-1a90-1a90-1a901a901a90"

billable_metric.name

string

required

Name of the billable metric.

Example:

"Storage"

billable_metric.code

string

required

Unique code used to identify the billable metric associated with the API request. This code associates each event with the correct metric.

Example:

"storage"

billable_metric.recurring

boolean

required

Defines if the billable metric is persisted billing period over billing period.

If set to true: the accumulated number of units calculated from the previous billing period is persisted to the next billing period.
If set to false: the accumulated number of units is reset to 0 at the end of the billing period.
If not defined in the request, default value is false.

Example:

false

billable_metric.created_at

string<date-time>

required

Creation date of the billable metric.

Example:

"2022-09-14T16:35:31Z"

billable_metric.aggregation_type

enum<string>

required

Aggregation method used to compute usage for this billable metric.

Available options:

count_agg,

sum_agg,

max_agg,

unique_count_agg,

weighted_sum_agg,

latest_agg

Example:

"sum_agg"

billable_metric.description

string | null

Internal description of the billable metric.

Example:

"GB of storage used in my application"

billable_metric.rounding_function

enum<string> | null

Refers to the numeric value or mathematical expression that will be rounded based on the calculated number of billing units. Possible values are round, ceil and floor.

Available options:

ceil,

floor,

round,

Example:

"round"

billable_metric.rounding_precision

integer | null

Specifies the number of decimal places to which the rounding_function will be rounded. It can be a positive or negative value.

Example:

2

billable_metric.expression

string

Expression used to calculate the event units. The expression is evalutated for each event and the result is then used to calculate the total aggregated units.

Example:

"round((ended_at - started_at) * units)"

billable_metric.field_name

string | null

Property of the billable metric used for aggregating usage data. This field is not required for count_agg.

Example:

"gb"

billable_metric.weighted_interval

enum<string> | null

Available options:

seconds,

Example:

"seconds"

billable_metric.filters

object[]

Show child attributes

billable_metric.filters.key

string

required

Filter key to add to the event properties payload

Example:

"region"

billable_metric.filters.values

string[]

required

List of possible filter values

API Reference

Authorizations

Path Parameters

Body

Response