Skip to main content
POST
Report usage measurements (v2)

Authorizations

X-API-KEY
string
header
required

Server API Key

Headers

X-ACCOUNT-ID
string

Account ID — optional when authenticating with a user JWT (Bearer token); falls back to the user's first membership. Ignored for API-key auth.

X-ENVIRONMENT-ID
string

Environment ID — required when authenticating with a user JWT (Bearer token) on environment-scoped endpoints. Ignored for API-key auth (env is intrinsic to the key).

Body

application/json

Report usage for metered features. Batch up to 100 records.

usages
UsageRecord · object[]
required

A list of usage reports to be submitted in bulk

Required array length: 1 - 100 elements

Response

The recorded usage measurements and the balance of each credit wallet they drew from.

Response containing reported usage measurements with current usage values, period information and reset dates, plus the balance of each credit wallet they drew from.

data
UsageV2Data · object
required

Reported usage measurements and the credit balances they drew from