API reference
HTTP endpoints exposed by /api. Cookie-auth or MCP key required.
Authentication
All /api routes (except sign-in / sign-up) require the session cookie set during login, or an MCP API key passed as Authorization: Bearer ...
Core endpoints
| POST /api/generate | Generate a mindmap from a YouTube URL. |
| GET /api/mindmaps | List your mindmaps. |
| GET /api/mindmaps/:id | Fetch a single mindmap. |
| POST /api/research | Run deep research on a node. |
| POST /api/quiz | Generate a quiz session. |
| POST /api/notion/export | Export a mindmap to Notion. |
| POST /api/auth/logout | End the current session. |
Error shape
json
{
"ok": false,
"error": "insufficient_tokens",
"message": "You need at least 5 tokens to generate a mindmap."
}Was this page helpful?