OverviewPlatformsAPI Reference
Billing

Start a top-up

Returns a hosted checkout link with amountCents filled in. The buyer can change it there, from $20 to $5,000. The balance is credited within a minute of payment, and tracking paused for balance resumes right away. This call charges nothing by itself. successUrl must be on an origin this deployment trusts. Leave it out to return to the dashboard's billing page.

POST
/v1/billing/top-ups

Authorization

bearerAuth
AuthorizationBearer <token>

An API key from POST /v1/api-keys. Keys start with ref_.

In: header

Request Body

application/json

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/billing/top-ups" \  -H "Content-Type: application/json" \  -d '{    "amountCents": 2000  }'
{  "url": "string"}
Was this page helpful?

Check the credential

Call this first. It shows the workspace the credential works in, its type (API key, MCP sign-in token or dashboard session), whether it can write, and for keys the id and expiry. A read key gets 403 read_only_key on any write, and scripts often aim at the wrong workspace.

Get a receipt link

For a paid order from GET /v1/billing/invoices, returns a receipt PDF URL that expires soon.