Skip to main content
POST
Upgrade Key

Authorizations

X-API-Key
string
header
required

Path Parameters

tier
string
required

Response

Successful Response

Response after buying prepaid balance via x402 on POST /v1/keys/upgrade/{tier}.

key_id
string
required

Key identifier (SHA-256 hash prefix)

previous_tier
string
required

Tier label before this purchase

new_tier
string
required

Tier label after this purchase (never lower than before)

monthly_limit
integer
required

Monthly request ceiling for the tier label (an abuse cap, not prepaid calls)

payment_amount_usdc
number
required

Amount paid in USDC

credited_usd
number
required

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

balance_usd
number
required

Prepaid balance after this credit