Fluos developer resources

Fluos OpenAPI spec, authentication, markdown negotiation, CLI, MCP, and llms.txt for agents and integrators.

This is the Fluos developer index. Fluos is an AI motion agent. Agents can search docs without login, and paid plans can create videos through /api/v1/videos and /api/v1/mcp/app (OAuth).

Start here

ResourceURLWhat it is
Fluos OpenAPI specification/openapi.jsonOpenAPI 3.1 with unique operationIds for function calling
Fluos API reference/docs/apiEndpoint list and schemas
Fluos authentication/docs/authenticationBrowser sessions and OAuth for the paid video API
Fluos API versioning/docs/api-versioning/api/v1/ path versioning, API-Version header, Sunset / Deprecation
Fluos CLI/cliOfficial CLI on npm (npx fluos)
Fluos MCP server/mcpOfficial Model Context Protocol server
llms.txt/llms.txtCurated site index for language models
Docs search/api/v1/search?query=Public full-text search over these docs (q is an alias)

Markdown content negotiation

Public Fluos pages implement acceptmarkdown.com. Send Accept: text/markdown to the same URL a browser uses and you receive CommonMark with Content-Type: text/markdown; charset=utf-8 and Vary: Accept.

curl -sI -H "Accept: text/markdown" https://www.fluos.io/docs/developers

Docs also have Markdown siblings at /docs/{slug}.md and /docs/{slug}.mdx.

If Accept rejects both HTML and Markdown, Fluos returns 406 Not Acceptable.

What is public and what is not

The documentation, search, OpenAPI spec, and the public Docs MCP need no login.

Video creation is available on paid plans through the HTTP API, the CLI, and the Video MCP at /api/v1/mcp/app. These use an OAuth bearer token. The signed-in web app (/dashboard) uses your browser session and is not a public API.

The public Fluos MCP server at /mcp (/api/v1/mcp) is for docs search and OpenAPI. The paid video MCP is /api/v1/mcp/app.

Setup lives under Fluos MCP: Claude Code, Codex, Cursor, other agents, plus tools, recipes, and error codes.

Contact