API Overview

Folionaut exposes a REST API for content management and AI chat functionality.

Base URL: https://your-domain.com/api/v1

Endpoint Summary

Content (Public)

Method	Endpoint	Description
GET	/api/v1/content	List content items
GET	/api/v1/content/:type/:slug	Get single content item
GET	/api/v1/content/bundle	Get all content in one request

Chat (Public)

Method	Endpoint	Description
POST	/api/v1/chat	Send chat message

Admin Content

Method	Endpoint	Description
GET	/api/v1/admin/content	List all content (including drafts)
GET	/api/v1/admin/content/:id	Get content by ID
POST	/api/v1/admin/content	Create content
PUT	/api/v1/admin/content/:id	Update content
DELETE	/api/v1/admin/content/:id	Delete content
GET	/api/v1/admin/content/:id/history	Get version history
POST	/api/v1/admin/content/:id/restore	Restore to previous version

Admin Chat

Method	Endpoint	Description
GET	/api/v1/admin/chat/sessions	List chat sessions
GET	/api/v1/admin/chat/sessions/:id	Get session with messages
DELETE	/api/v1/admin/chat/sessions/:id	End/delete session

Health & Infrastructure

Method	Endpoint	Description
GET	/api/health/live	Liveness probe
GET	/api/health/ready	Readiness probe
GET	/api/health/startup	Startup probe
GET	/api/metrics	Prometheus metrics (requires X-Admin-Key)

MCP over HTTP

Method	Endpoint	Description
POST	/api/mcp	MCP JSON-RPC requests
GET	/api/mcp	SSE stream
DELETE	/api/mcp	Terminate MCP session

Quick Links

• Conventions - Authentication, headers, rate limiting, pagination, caching
• Schemas & Errors - Response schemas and error codes