Skip to main content
POST
Topup Key

Authorizations

X-API-Key
string
header
required

Path Parameters

usd
integer
required

Whole US dollars to add to the prepaid balance

Required range: x >= 5

Response

Successful Response

Response after topping up a key's prepaid balance via x402.

key_id
string
required

Key identifier (SHA-256 hash prefix)

tier
string
required

Tier label (unchanged by a top-up)

credited_usd
number
required

USD credited to the prepaid balance by this payment (1:1)

balance_usd
number
required

Prepaid balance after this credit