Packages API reference

Most users do not call this API. The @flocon-ai/next library calls it for you.

Use it only to build your own integration.

Basics

  • Base URL: https://api.flocon-ai.com
  • GET only.
  • Auth: Authorization: Bearer <website token>. Only the website token works. A missing, wrong or revoked token gives 401.
  • If you send an MCP token, the 401 message says: "This is an MCP token. Your website needs the website token: https://flocon-ai.com/app/tokens".
  • One token = one website.
  • Published pages only. Drafts and scheduled pages never come out of this API.
  • Errors are JSON: { "message": "..." }.

GET /website

The website of the token. No parameters.

Returns:

  • name
  • defaultLocale
  • locales
  • badge: true if the Flocon AI badge must be shown (Free plan)

GET /pages

All served pages, light (no blocks). No parameters.

Returns an array. Each entry:

  • locale
  • path
  • title
  • updatedAt
  • alternates: the other locales of this page

GET /pages/{locale}/{path}

One published page. Example: /pages/en/vs/notion gives the page at path /vs/notion in en.

Returns:

  • locale, path, title
  • alternates: the other locales where this page is published
  • seo
  • blocks: see the blocks reference. In a related block, pages come with their path and title.
  • createdAt, updatedAt

Errors:

  • 404: no such page, or it is a draft, or it is not published yet.

GET /doc

The OpenAPI 3.0 description of the API. Public: no token needed.

Updated