Bono API Concepts

Pages, post blocks, and credits

Bono content is organized into Pages (your public link/landing pages) each containing one or more Blocks. The API exposes /pages and a post-shaped subset of blocks under /posts. Generation and write endpoints consume credits from the same pool as the Bono web app.

Async jobs, pagination, idempotency

Carousel and video generation are asynchronous; the endpoint returns 202 Accepted with a job id and pollUrl. List endpoints use limit/skip pagination (default 20, max 100). Pass an Idempotency-Key header on writes to safely retry without duplicating side effects.