Ledger
Reserve credits
Hold credits before spending. Returns a token to commit or refund.
POST
The reserve / commit / refund pattern keeps the ledger honest even when
generation can fail mid-flight: you reserve before kicking off work,
commit on success, refund on failure.
Returns
Body
number
required
Credits to hold.
string
Human-readable purpose (shown in
transactions).object
Free-form structured metadata.
402 insufficient_credits with { needed, have } if the reserve
would drive available below zero.