Flipbook API Docs for Agents and LLMs

Quickstart

Anonymous public reads need no key. Creating, updating, deleting, and reading private flipbooks require Authorization: Bearer fk_live_....

# Public read — no key required
curl https://urmuupgjgyacsuvmqyhc.supabase.co/functions/v1/api-v1/flipbooks

# Create a flipbook — Bearer key required
curl -X POST https://urmuupgjgyacsuvmqyhc.supabase.co/functions/v1/api-v1/flipbooks \
  -H "Authorization: Bearer fk_live_..." \
  -H "Idempotency-Key: 00000000-0000-4000-8000-000000000000" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Q4 Report",
    "pages": [
      "https://cdn.example.com/p1.jpg",
      "https://cdn.example.com/p2.jpg"
    ],
    "is_public": true
  }'

Core endpoints

Method	Path	Purpose	Auth
GET	`/flipbooks`	List public flipbooks, or owner flipbooks when a key is provided.	Optional
GET	`/flipbooks/{id_or_slug}`	Fetch one public flipbook by id or slug. Private flipbooks require the owner's key.	Optional
POST	`/flipbooks`	Create a flipbook from ordered page image URLs.	Required
PATCH	`/flipbooks/{id}`	Update title, description, slug, or visibility.	Required
DELETE	`/flipbooks/{id}`	Delete a flipbook owned by the API key user.	Required
GET	`/flipbooks/{id}/embed`	Return the iframe embed URL and HTML snippet.	Required for private

Discovery resources

OpenAPI 3.1

Machine-readable contract for REST clients, agent tools, and API explorers.

https://flipbook.it.com/openapi.yaml

llms.txt

Concise LLM-facing summary with endpoints, auth rules, pricing, and links.

https://flipbook.it.com/llms.txt

Plugin manifest

Agent/plugin discovery metadata for compatible clients.

https://flipbook.it.com/.well-known/ai-plugin.json

MCP server

Flipbook exposes an MCP server over Streamable HTTP with OAuth 2.1 and dynamic client registration.

{
  "mcpServers": {
    "flipbook": {
      "url": "https://urmuupgjgyacsuvmqyhc.supabase.co/functions/v1/mcp"
    }
  }
}

Available tools: create_flipbook, list_flipbooks, get_flipbook, update_flipbook, delete_flipbook, and get_embed_code.

Self-serve API keys and usage

Signed-in users can create, revoke, and manage API keys in the dashboard. Each key supports configurable per-key request limits, monthly quotas, usage charts, and metered billing at $1.00 per flipbook created via API.

Open dashboard