Meter

POST/api/v1/meter/events

List_metrics

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Conditions as filter[][]=. Conditions on different fields all apply. in (any of) and all (every one of, on fields holding several values) take a comma-separated list (\, for a literal comma). exists takes true or false. Datetimes are RFC 3339, now, or a time before now such as -30m, -6h or -7d.

q?string

Full-text search over this list's searchable fields.

Length1 <= length <= 200

sort?string

Comma-separated sort keys, - for descending, at most 1. Keys: name, version, updated_at, created_at. Default: -created_at.

limit?integer

Rows per page, 1 to 100 (default 25).

Range1 <= value <= 100

cursor?string

The page.next_cursor of the previous page. Cannot be combined with page.

page?integer

A 1-based page number, for jumping. Cannot be combined with cursor.

Range1 <= value

total?boolean

Set to true to include the number of matching rows in page.total.

Response Body

`application/json`

curl -X GET "https://example.com/api/v1/meter/metrics"

{  "metrics": [    {      "aggregation": {        "bucket": "minute",        "kind": "sum",        "rollups": [          "minute"        ]      },      "created_at": "2019-08-24T14:15:22Z",      "dimensions": [        {          "cardinality": "low",          "name": "string",          "required": true        }      ],      "metric_id": "string",      "name": "string",      "pricing": {        "currency": "string",        "tiers": [          {            "unit_price": 0.1,            "up_to": 0          }        ]      },      "quota": {        "enabled": true,        "hard_limit": 0,        "period": "day",        "soft_limit": 0      },      "retention": {        "hot_bucket_days": 0,        "report_days": 0      },      "unit": "string",      "updated_at": "2019-08-24T14:15:22Z",      "version": 0    }  ],  "page": {    "has_more": true,    "next_cursor": "string",    "page": 0,    "total": 0  }}

POST/api/v1/meter/metrics

Create_metric

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

aggregation?

Aggregation configuration (kind, bucket, rollups)

dimensions?array<>

Declared dimensions for the metric

name*string

Metric name, for example llm.tokens

pricing?

Graduated pricing configuration

quota?

Quota policy

retention?

Retention policy

unit*string

Unit of measure, for example token

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/meter/metrics" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "unit": "string"  }'

{  "aggregation": {    "bucket": "minute",    "kind": "sum",    "rollups": [      "minute"    ]  },  "created_at": "2019-08-24T14:15:22Z",  "dimensions": [    {      "cardinality": "low",      "name": "string",      "required": true    }  ],  "metric_id": "string",  "name": "string",  "pricing": {    "currency": "string",    "tiers": [      {        "unit_price": 0.1,        "up_to": 0      }    ]  },  "quota": {    "enabled": true,    "hard_limit": 0,    "period": "day",    "soft_limit": 0  },  "retention": {    "hot_bucket_days": 0,    "report_days": 0  },  "unit": "string",  "updated_at": "2019-08-24T14:15:22Z",  "version": 0}

GET/api/v1/meter/metrics/{metric}

Get_metric

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Path Parameters

metric*string

Response Body

`application/json`

curl -X GET "https://example.com/api/v1/meter/metrics/string"

{  "aggregation": {    "bucket": "minute",    "kind": "sum",    "rollups": [      "minute"    ]  },  "created_at": "2019-08-24T14:15:22Z",  "dimensions": [    {      "cardinality": "low",      "name": "string",      "required": true    }  ],  "metric_id": "string",  "name": "string",  "pricing": {    "currency": "string",    "tiers": [      {        "unit_price": 0.1,        "up_to": 0      }    ]  },  "quota": {    "enabled": true,    "hard_limit": 0,    "period": "day",    "soft_limit": 0  },  "retention": {    "hot_bucket_days": 0,    "report_days": 0  },  "unit": "string",  "updated_at": "2019-08-24T14:15:22Z",  "version": 0}

GET/api/v1/meter/{metric}/alarms

List_alarms

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Path Parameters

metric*string

Query Parameters

limit?integer

Rows per page, 1 to 100 (default 25).

Range1 <= value <= 100

cursor?string

The page.next_cursor of the previous page. Cannot be combined with page.

page?integer

A 1-based page number, for jumping. Cannot be combined with cursor.

Range1 <= value

total?boolean

Set to true to include the number of matching rows in page.total.

Response Body

`application/json`

curl -X GET "https://example.com/api/v1/meter/string/alarms"

{  "alarms": [    {      "alarm_id": "string",      "limit": 0.1,      "metric": "string",      "scope": "string",      "status": "triggered",      "threshold": "soft_limit",      "triggered_at": "2019-08-24T14:15:22Z",      "usage": 0.1    }  ],  "page": {    "has_more": true,    "next_cursor": "string",    "page": 0,    "total": 0  }}

POST/api/v1/meter/{metric}/check

Check_budget

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Path Parameters

metric*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

planned_units*number

Planned units the caller intends to consume

Formatdouble

user_id?|

User to check budget for (defaults to the caller)

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/meter/string/check" \  -H "Content-Type: application/json" \  -d '{    "planned_units": 0.1  }'

{  "allowed": true,  "current_usage": 0.1,  "hard_limit": 0,  "hard_limit_exceeded": true,  "planned_units": 0.1,  "reserved_units": 0.1,  "soft_limit": 0,  "soft_limit_exceeded": true}

POST/api/v1/meter/{metric}/commit

Commit_reservation

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Path Parameters

metric*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

actual_units*number

Actual units consumed; unused reserved units are released

Formatdouble

reservation_id*string

Reservation identifier returned by reserve

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/meter/string/commit" \  -H "Content-Type: application/json" \  -d '{    "actual_units": 0.1,    "reservation_id": "string"  }'

{  "committed_units": 0.1,  "released_units": 0.1,  "reservation_id": "string",  "status": "reserved"}

POST/api/v1/meter/{metric}/estimate

Estimate_cost

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Path Parameters

metric*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

units*number

Units to price against the metric graduated pricing tiers

Formatdouble

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/meter/string/estimate" \  -H "Content-Type: application/json" \  -d '{    "units": 0.1  }'

{  "currency": "string",  "estimated_cost": 0.1,  "metric": "string",  "units": 0.1}

GET/api/v1/meter/{metric}/forecast

Forecast

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Path Parameters

metric*string

Query Parameters

user_id?string

User to forecast usage for (defaults to the caller)

period?string

Reset period to forecast against

Value in

"day"
"month"
"billing_cycle"
"prepaid"

Response Body

`application/json`

curl -X GET "https://example.com/api/v1/meter/string/forecast"

{  "confidence": 0.1,  "current_usage": 0.1,  "metric": "string",  "period_fraction_elapsed": 0.1,  "projected_usage": 0.1,  "user_id": "string"}

GET/api/v1/meter/{metric}/reports

List_reports

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Path Parameters

metric*string

Query Parameters

sort?string

Comma-separated sort keys, - for descending, at most 1. Keys: generated_at. Default: -generated_at.

limit?integer

Rows per page, 1 to 100 (default 25).

Range1 <= value <= 100

cursor?string

The page.next_cursor of the previous page. Cannot be combined with page.

page?integer

A 1-based page number, for jumping. Cannot be combined with cursor.

Range1 <= value

total?boolean

Set to true to include the number of matching rows in page.total.

Response Body

`application/json`

curl -X GET "https://example.com/api/v1/meter/string/reports"

{  "page": {    "has_more": true,    "next_cursor": "string",    "page": 0,    "total": 0  },  "reports": [    {      "estimated_cost": 0.1,      "generated_at": "2019-08-24T14:15:22Z",      "metric": "string",      "quota": {        "hard_limit_exceeded": true,        "soft_limit_exceeded": true      },      "report_id": "string",      "top_consumers": [        {          "dimension": "string",          "usage": 0.1,          "value": "string"        }      ],      "total": 0.1,      "unique_count": 0    }  ]}

POST/api/v1/meter/{metric}/reports/generate

Generate_report

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Path Parameters

metric*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

period?null|

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/meter/string/reports/generate" \  -H "Content-Type: application/json" \  -d '{}'

{  "estimated_cost": 0.1,  "generated_at": "2019-08-24T14:15:22Z",  "metric": "string",  "quota": {    "hard_limit_exceeded": true,    "soft_limit_exceeded": true  },  "report_id": "string",  "top_consumers": [    {      "dimension": "string",      "usage": 0.1,      "value": "string"    }  ],  "total": 0.1,  "unique_count": 0}

POST/api/v1/meter/{metric}/reserve

Reserve_budget

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Path Parameters

metric*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

units*number

Units to reserve up front

Formatdouble

user_id?|

User to reserve budget for (defaults to the caller)

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/meter/string/reserve" \  -H "Content-Type: application/json" \  -d '{    "units": 0.1  }'

{  "expires_at": "2019-08-24T14:15:22Z",  "reservation_id": "string",  "reserved_units": 0.1,  "status": "reserved"}

GET/api/v1/meter/{metric}/top

Top_consumers

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Path Parameters

metric*string

Query Parameters

limit?integer

Rows per page, 1 to 100 (default 25).

Range1 <= value <= 100

cursor?string

The page.next_cursor of the previous page. Cannot be combined with page.

page?integer

A 1-based page number, for jumping. Cannot be combined with cursor.

Range1 <= value

dimension?string

Dimension to rank consumers by

period?string

Bucket resolution to read top consumers from

Response Body

`application/json`

curl -X GET "https://example.com/api/v1/meter/string/top"

{  "consumers": [    {      "dimension": "string",      "usage": 0.1,      "value": "string"    }  ],  "dimension": "string",  "metric": "string",  "page": {    "has_more": true,    "next_cursor": "string",    "page": 0,    "total": 0  },  "period": "string"}

GET/api/v1/meter/{metric}/usage

Query_usage

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Path Parameters

metric*string

Query Parameters

user_id?string

User to query usage for (defaults to the caller)

period?string

Bucket resolution (minute, hour, day, billing_cycle)

Response Body

`application/json`

curl -X GET "https://example.com/api/v1/meter/string/usage"

{  "buckets": [    {      "bucket": "string",      "value": 0.1    }  ],  "metric": "string",  "period": "string",  "total": 0.1,  "user_id": "string"}

Meter

202application/json

400

403

409

200application/json

400

201application/json

400

403

200application/json

404

200application/json

400

404

200application/json

403

404

200application/json

400

404

200application/json

400

404

200application/json

403

404

200application/json

400

201application/json

403

404

201application/json

403

404

429

200application/json

400

404

200application/json

403

404

On this page

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`