Grid82
grid82.comJoin the waitlist
BillingSet how many packs of an add-on the organisation holds

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

NameTypeRequiredDescription
organizationIdstringyes

Headers

NameTypeRequiredDescription
Idempotency-KeystringnoAny 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

FieldTypeRequiredDescription
addonstringyes
packsintegeryesAt least 0. At most 200.

Response

application/json

Success

dataobjectrequired

Use these docs with your AI tools

An AI agent can read this documentation directly. You do not need an account or an API key. Everything here is public and read-only.

Query these docs via MCP

Recommended

Add this server to Claude, Claude Code, Cursor, Mistral, or any tool that supports MCP. Your agent can then search Grid82 documentation and read it in full, instead of answering from memory.

https://grid82.com/docs/mcp
  • searchFind the passages that answer a question.
  • fetchRead one page in full, as Markdown.
  • list_pagesSee every page in this documentation.

Query these docs over HTTP

The same tools also work as plain web requests. Use this for scripts, or for any tool that does not support MCP. There is one endpoint per tool. Arguments go in the query string, and the answer comes back as JSON.

https://grid82.com/docs/api/docs/search?query=custom+domain

Read the OpenAPI description. It is built from the same definitions as the tools, so it always matches what the endpoints do.

Read these docs as Markdown

Add .md to any page URL to get its Markdown source. You can also send the headerAccept: text/markdown to the page URL itself.

To read the whole documentation in one file, open llms-full.txt. For a short index of every page, open llms.txt.