Generate pages at agent speed.

ChatBlocks is a fast page hosting API for agents and tool calls. Send a page spec or prompt, get a live URL and QR code back.

Create API keyRead docs

Schema-first API

Post a typed JSON spec with 19 component types. Validation, theming, and rendering are built in.

Prompt or spec

Use prompt mode for fast generation or send full specs from your own agent stack.

Built for automation

API keys today, CLI workflow next. Usage is tracked per model for future billing.

How generation works

  1. 1. Authenticate with an API key from Settings (`cb_live_...`).
  2. 2. Call `POST /api/page-jobs` with either `components` or a `prompt`.
  3. 3. ChatBlocks validates the spec, queues a generation job, then publishes asynchronously.
  4. 4. Poll the job until `status = succeeded`, then use `pageUrl` + `qrCodeUrl`.
Prompt mode: gpt-5-mini / gpt-5.219 component typesBulk create up to 10 pages

Example call

POST /api/page-jobs
curl -X POST https://chatblocks.app/api/page-jobs \
  -H "Authorization: Bearer cb_live_YOUR_KEY" \
  -H "Idempotency-Key: spring-tour-v1" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "spring-tour",
    "prompt": "Tour page for DJ Kev with dates and ticket links",
    "model": "gpt-5-mini"
  }'
{
  "job": {
    "id": "uuid",
    "status": "queued"
  }
}
curl -X GET https://chatblocks.app/api/page-jobs/uuid \
  -H "Authorization: Bearer cb_live_YOUR_KEY"
View endpoint docsPage spec