Fluos API reference
Public Fluos HTTP API — discovery files, documentation, search, and inbound webhooks — described by /openapi.json.
The canonical machine-readable Fluos API description is https://www.fluos.io/openapi.json. Every operation has a unique operationId, a description, typed parameters, and response schemas so agents can register function-calling tools from the spec.
Base URL
https://www.fluos.io
Discovery
| operationId | Method | Path | Purpose |
|---|---|---|---|
getFluosOpenApiSpec | GET | /openapi.json | This specification |
getFluosLlmsTxt | GET | /llms.txt | Curated URL index |
getFluosLlmsFullTxt | GET | /llms-full.txt | Full-text docs dump |
getFluosAiTxt | GET | /ai.txt | AI crawler policy |
getFluosSitemap | GET | /sitemap.xml | All public URLs |
getFluosRobotsTxt | GET | /robots.txt | Crawler rules |
getFluosRssFeed | GET | /feed.xml | Blog RSS |
These endpoints are public and cacheable. No authentication.
Content (Accept negotiation)
| operationId | Method | Path |
|---|---|---|
getFluosHome | GET | / |
getFluosDevelopers | GET | /developers |
getFluosDocsIndex | GET | /docs |
getFluosDocPage | GET | /docs/{slug} |
getFluosAbout | GET | /about |
getFluosPricing | GET | /pricing |
getFluosBlogPost | GET | /blog/{slug} |
Send Accept: text/markdown for Markdown. Missing Accept returns HTML. Incompatible Accept values return 406.
Search
| operationId | Method | Path | Parameters |
|---|---|---|---|
searchFluosDocs | GET | /api/search | q (query string) |
Public. Returns fumadocs/Orama hits over this documentation set.
Inbound webhooks
These accept provider-signed POSTs only. See Fluos webhooks.
| operationId | Method | Path |
|---|---|---|
receiveClerkWebhook | POST | /api/webhooks/clerk |
receiveStripeWebhook | POST | /api/stripe/webhook |
receiveResendWebhook | POST | /api/webhooks/resend |
Errors
| Status | When |
|---|---|
404 | Unknown path. Markdown body lists /sitemap.xml, /llms.txt, /docs, /developers, /openapi.json. |
406 | Accept rejected HTML and Markdown. |
401 | Authenticated product API without a Clerk session. JSON { "error", "code": "unauthorized" }. |
Function calling
Import /openapi.json and register each operationId as a tool. Prefer discovery + searchFluosDocs + Markdown getFluosDocPage before answering product questions. Do not call webhook operations from an agent — they require provider secrets.