Buy AI credits once
Admins only, on any plan, from an interactive Studio browser session (API keys and connected agents are rejected).
POST/v1/organizations/{organizationId}/billing/topup
Returns a Stripe Checkout URL for a one-off payment; the credits are granted when Stripe confirms it, last a year, and are used once the month’s allowance has run out. credits_100k (100,000 credits, EUR 10), credits_250k (250,000, EUR 25), credits_1m (1,000,000, EUR 90). 501 while billing is not connected.
Requires the account:write scope. Operation billing.topup. Not an MCP tool. Buying is a person’s act in a browser: the handler refuses every key and every connected agent, so as a tool it could only ever fail. CLI: grid82 billing topup (npx @grid82/cli).
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
organizationId | string | yes |
Headers
| Name | Type | Required | Description |
|---|---|---|---|
Idempotency-Key | string | no | Any unique string. Sending the same key with the same request again returns the first response (marked Idempotency-Replayed: true) instead of running it twice. Reusing it for a different request is refused with 409. Kept for 24 hours. Up to 255 characters. |
Request body
| Field | Type | Required | Description |
|---|---|---|---|
topUp | “credits_100k” or “credits_250k” or “credits_1m” | yes |
Response
Success
dataobjectrequiredRefused
errorobjectrequired