API overview
The Flexweg Publishing API lets you programmatically turn any HTML content into a public URL, manage files and folders on your static site, upload videos, and build embeddable forms with submission tracking. Everything is REST over JSON.
Base URL
All endpoints live under:
https://www.flexweg.com
What you can do
Publish HTML without an account Send HTML, get back a temporary public URL — perfect for AI agents, demos and prototypes. See Publish (demo).
Manage your site files List, read, create, rename and delete files and folders with a typed JSON API. See Files and Folders.
Host videos Upload MP4, WebM, OGG and MOV files with a simple multipart request. See Videos.
Build forms and collect submissions Create embeddable forms, get snippets for HTML or React, paginate and filter submissions. See Forms.
Content formats
- Input / output: JSON (except video uploads, which use
multipart/form-data). - Binary files (images, PDF, fonts): send the content base64-encoded with
"encoding": "base64"in the payload. - CORS: enabled on all endpoints.
OpenAPI specification
A full OpenAPI 3 spec is available and machine-readable:
https://www.flexweg.com/.well-known/openapi.json
Drop it into Postman, Insomnia or any OpenAPI-aware client to generate a ready-to-use collection.
AI-friendly
Flexweg exposes an MCP server and an AI plugin manifest:
https://www.flexweg.com/.well-known/mcp.json— Model Context Protocol server definition for Claude Code, Claude Desktop, Cursor, and other MCP-aware clients.https://www.flexweg.com/.well-known/ai-plugin.json— plugin manifest for AI agents.https://www.flexweg.com/ai.txt— human- and AI-readable capability summary.
See Build your site with AI for the end-user side of the AI integration.
Next steps
- Read Authentication to learn how to pass your API key.
- Try the publish endpoint — no account required.
- Browse the endpoint families on the left sidebar.