Documentation Index Fetch the complete documentation index at: https://mintlify.com/makriman/inspir/llms.txt
Use this file to discover all available pages before exploring further.
Overview
The Mind Maps API creates visual mind maps from study content using AI. Mind maps help organize information hierarchically with a central concept and branching topics.
Endpoints
Generate Mind Map
POST /api/mindmap/generate
curl -X POST https://api.inspir.uk/api/mindmap/generate \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_TOKEN" \
-d '{
"title": "Photosynthesis",
"content": "Photosynthesis is the process by which plants...",
"topic": "Biology"
}'
Generate a mind map from content.
Authentication: Optional (guests get mind map without saving)
Request Body
Text content to generate mind map from
Subject or topic (e.g., “Biology”, “History”)
Response
Whether the request was successful
Generated mind map structure Mind map ID (null for guests)
Main branches from central concept Sub-topics under this branch (strings)
Whether the mind map was saved (true for authenticated users)
Get Mind Maps
curl -X GET https://api.inspir.uk/api/mindmap/ \
-H "Authorization: Bearer YOUR_TOKEN"
Get user’s saved mind maps.
Authentication: Required
Response
Whether the request was successful
Array of mind maps (same structure as generate response)
Get Mind Map by ID
curl -X GET https://api.inspir.uk/api/mindmap/abc123 \
-H "Authorization: Bearer YOUR_TOKEN"
Get a specific mind map.
Authentication: Optional
Path Parameters
Update Mind Map
curl -X PUT https://api.inspir.uk/api/mindmap/abc123 \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_TOKEN" \
-d '{
"title": "Updated Title",
"branches": [...]
}'
Update a mind map.
Authentication: Required
Delete Mind Map
curl -X DELETE https://api.inspir.uk/api/mindmap/abc123 \
-H "Authorization: Bearer YOUR_TOKEN"
Delete a mind map.
Authentication: Required
Error Responses
400 - Missing required fields
401 - Authentication required
404 - Mind map not found
500 - AI generation failed
Mind maps are ideal for brainstorming, memorization, and understanding hierarchical relationships between concepts.