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

tier_expires_at
string<date-time> | null

When the active Growth/Pro term ends (null without a term). The key then moves to the first queued term, or back to the tier it had before

queued_terms
QueuedTerm · object[]

Terms bought during a higher active term (Growth during Pro), oldest first; each starts when the one ahead of it ends