API Reference

The ChatBlocks API lets you create, read, update, and delete pages programmatically.

Base URL

https://chatblocks.app/api

Authentication

Most endpoints require authentication via either:

1. API Key — Authorization: Bearer cb_live_YOUR_KEY
2. Browser Session — Automatic cookie-based auth from the browser

See Authentication for details.

Request format

All request bodies use JSON. Set Content-Type: application/json.

Error format

Errors return a JSON object with an error field and appropriate HTTP status:

{
  "error": "Invalid page spec",
  "details": {
    "slug": "Must be at least 2 characters"
  }
}

Status codes

Rate limits

AI generation (prompt mode) is tiered by auth method:

• API key auth: default 60/hour
• Session auth: default 10/hour

Endpoints