Set how many packs of an add-on the organisation holds
Admins only, on a paid plan, from an interactive Studio browser session (API keys and connected agents are rejected).
POST/v1/organizations/{organizationId}/billing/addons
packs is the number held after the call, not a number to add; 0 removes it. More packs are charged now, prorated, and a declined card refuses the change; fewer are credited on the next invoice. Sold this way: steps_50k, 50,000 more workflow steps a month per pack, and ai_250k, 250,000 more AI credits a month per pack. Refused while a plan change is scheduled; 501 while billing is not connected.
Requires the account:write scope. Operation billing.addons. 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 addons (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 |
|---|---|---|---|
addon | string | yes | |
packs | integer | yes | At least 0. At most 200. |
Response
Success
dataobjectrequiredRefused
errorobjectrequired