v69

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-011221331.4 MB

Credit consumption

Consume credits

Consumes a specified amount of credits directly from a customer wallet, with no feature mapping. Returns the optimistic balance.

post/api/v1/credits/consumption

Headers

X-ACCOUNT-IDstring

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-IDstring

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).

Request body

customerIdstring required

The customer to consume credits from (required)

currencyIdstring required

The credit currency to consume from (required)

amountnumber required

The amount of credits to consume

resourceIdstring

Optional resource the consumption is attributed to

idempotencyKeystring required

A unique key used to deduplicate the consumption (required)

dimensionsobject

Optional dimensions describing the consumption

createdAtstring date-time

Optional timestamp the consumption is attributed to

Response

The result of the credit consumption, including the optimistic balance.