billing

Purchase additional credits

[cloud-only] Purchases a one-time credit top-up using the user's payment method on file.

post/api/billing/topup

Request body

amountinteger required

Number of credits to purchase

Top-up successful

billing_op_idstring required

Billing operation ID to poll for status via GET /api/billing/ops/{id}

topup_idstring required

Unique identifier for the top-up request (same as billing_op_id, deprecated)

status'pending' | 'completed' | 'failed' required

Current status of the top-up

amount_centsinteger required

Amount being charged in cents