POST
/
metrics

Authorizations

Authorization
string
header
required

API Keys can be issued in the Orb's web application.

Body

application/json
sql
string
required

A sql string defining the metric.

name
string
required

The name of the metric.

item_id
string
required

The id of the item

description
string | null
required

A description of the metric.

metadata
object | null

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.

Response

200
application/json
OK

The Metric resource represents a calculation of a quantity based on events. Metrics are defined by the query that transforms raw usage events into meaningful values for your customers.

metadata
object
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.

id
string
required
name
string
required
description
string | null
required
status
enum<string>
required
Available options:
active,
draft,
archived
item
object
required

The Item resource represents a sellable product or good. Items are associated with all line items, billable metrics, and prices and are used for defining external sync behavior for invoices and tax calculation purposes.