Fluos API reference
Public Fluos HTTP API — discovery files, documentation, search, and paid video operations — 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
Canonical public API prefix: /api/v1/. Send API-Version: 1. See Fluos API versioning and deprecation.
Discovery
| operationId | Method | Path | Purpose |
|---|---|---|---|
getFluosOpenApiSpec | GET | /openapi.json | This specification |
getFluosOpenApiSpecV1 | GET | /api/v1/openapi.json | Versioned alias of this specification |
getFluosMcpServerCard | GET | /api/v1/mcp | Fluos MCP server card |
callFluosMcp | POST | /api/v1/mcp | Fluos MCP JSON-RPC |
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 | / |
getFluosCli | GET | /cli |
getFluosMcp | GET | /mcp |
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 | query (or alias q) |
searchFluosDocsV1 | GET | /api/v1/search | query (or alias q) |
Public. Returns ranked hits over this documentation set. Prefer /api/v1/search. Responses include IETF RateLimit headers; 429 includes Retry-After.
Errors
| Status | When |
|---|---|
404 | Unknown path. Markdown body lists /sitemap.xml, /llms.txt, /docs, /docs/developers, /openapi.json. |
406 | Accept rejected HTML and Markdown. |
401 | Authenticated API without a session or token. 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.