The A2UI Atomic Catalog over plain HTTP
Base URL https://a2uicatalog.ai. No API key, no signup. The full contract is the
OpenAPI 3.1 spec at /openapi.json; this skill is the short path through it.
1. Find the atoms
GET /ask?query=countdown timer— ranked, typed atom matches for a plain-English question (NLWeb).mode=summarizeadds a one-paragraph answer. 60 requests per IP per day.GET /spec.json— every atom with its real field contract. Read the fields from here; never guess a field name.GET /catalogue/index.jsonis the compact menu.
2. Turn a request into blocks (optional)
POST /api/compose with {"prompt": "weekly sales dashboard with a trend chart"} returns
candidate atom blocks. 20 requests per IP per day. Check the result against /spec.json
before rendering; it is a starting point, not a finished payload.
3. Render
The payload is {"title": "...", "theme": "light" | "dark", "blocks": [ ... ]}.
POST /api/render— returns a complete self-contained HTML page.POST /api/render/batchwith{"payloads": [ ... ]}— up to 25 payloads in one call, one call against the daily allowance. Partial success: a bad payload gets its own status inresultsand the rest still render.POST /api/render/jobs— the async form. Returns202 Acceptedwithjob_id, aLocationheader andstatus_url.GETthe status URL untilstatusisdone, thenGETitsresult_urlfor the HTML. Polling spends no quota. Jobs are kept for one hour. Renders finish within the request today, so the first poll already saysdone; poll anyway so your code keeps working if rendering moves to a queue.
Add ?surface=web|mcp-apps|google-apps-script-web|google-meet-stage to apply that surface's
compatibility policy (X-A2UI-Degraded and X-A2UI-Incompatible name what changed).
4. Headers worth reading
X-API-Version: 1on every response. Send the same header on a request to name the version your code was built against; an unsupported value gets a 400 that lists the supported versions. Breaking changes are announced withDeprecationandSunsetheaders at least 90 days apart (/versioning.md).X-RateLimit-Limit,X-RateLimit-Remaining, and the IETFRateLimit-Policy/RateLimitpair on the metered routes. Render is 50 requests per IP per day; a429carriesRetry-After.Idempotency-Keyon render requests: retrying the same key within 10 minutes returns the first response instead of spending quota again.
Sandbox
https://a2uicatalog.ai/api/sandbox serves the render routes with the same code on their own
allowance (20 requests per IP per day), so building an integration never spends the
production one: POST https://a2uicatalog.ai/api/sandbox/api/render, .../api/render/batch,
.../api/render/jobs. Replies carry X-A2UI-Sandbox: true. Production is also safe to test
against: these endpoints hold no production data and change nothing; the only cost is quota. To try payloads
by hand, use the playground at https://play.a2uicatalog.ai.
Failure modes
400with a JSONerrornames the limit hit: 256 KB body, 300 blocks, 12 levels of nesting.- Atoms that need a render-time server fetch (
data_source,firestore_read,doc_ai_summary,multi_doc_ai_brief,gemini_handoff) are refused on the public renderer; deploy your own (/renderer) for those. - Unpublished or preview atoms render as a visible notice and are named in
X-A2UI-Unpublished, never silently dropped.
