Update meter

Updates a usage meter. The eventName, aggregation, and settlement fields become immutable once any usage event has been reported against the meter. Rate fields remain editable. Requires the METERS_WRITE scope.

PATCH https://api.pandabase.io/v2/core/stores/{storeId}/products/{productId}/meters/{meterId}

Authentication

Requires a bearer token (sk_…) or an API key in the header Authorization.

Path parameters

storeId string required

(length 12–48)

productId string required

(length 12–48)

meterId string required

(length 12–48)

Header parameters

idempotency-key string

(length 8–32)

Body parameters

eventName string

(pattern ^[a-zA-Z0-9_.-]+$, length 1–64)

unitPrice integer

(range 0–100000000)

unitQuantity integer

(range 1–1000000000)

aggregation enum

No description.

settlement enum

No description.

includedUnits integer or null

No description.

Response 200

Default Response

ok enum required

(one of true)

data object required

No description.

Response 400

Default Response

ok enum required

(one of false)

error string required

No description.

Response 404

Default Response

ok enum required

(one of false)

error string required

No description.

Response 409

Default Response

ok enum required

(one of false)

error string required

No description.

Request
curl -X PATCH https://api.pandabase.io/v2/core/stores/:storeId/products/:productId/meters/:meterId \  -H "Content-Type: application/json" \  -d '{"eventName":"string","unitPrice":0,"unitQuantity":0,"aggregation":"SUM","settlement":"ARREARS","includedUnits":0}'
Response
{  "ok": true,  "data": {    "id": "umt_5e1q3npwt0u6s2k8h9j7rzbc",    "productId": "prd_8h4t6sqzy3x9w5n2k1m0vqbf",    "eventName": "input_tokens",    "unitPrice": 300,    "unitQuantity": 1000000,    "aggregation": "SUM",    "settlement": "ARREARS",    "includedUnits": null,    "createdAt": "2026-05-20T14:00:00.000Z",    "updatedAt": "2026-05-20T14:00:00.000Z"  }}