Skip to main content
POST
Usage endpoints are served from https://api-meter.metrifox.com. Other API calls stay on https://api.metrifox.com.
For example, if you recorded 5 image generations but the customer only used 4, send the actual amount and the difference is refunded.

Authorizations

x-api-key
string
header
required

Body

application/json
customer_key
string
required

The unique customer identifier in your application.

event_id
string
required

The event_id of the original usage event to adjust.

actual_quantity
number | null

The true quantity the customer used. Omit to leave quantity unchanged.

actual_credit_used
number | null

The true credits the customer used (prepaid features). Leave out to keep credits unchanged.

reason
string | null

Optional human-readable note stored on the adjustment for audit.

Response

Adjustment applied (or a no-op if already at the requested amount).

data
object