Overview The Concept Maps API creates visual concept maps showing relationships between ideas. Unlike mind maps (which are hierarchical), concept maps show interconnected concepts with labeled relationships.
Endpoints Generate Concept Map POST /api/conceptmap/generate
curl -X POST https://api.inspir.uk/api/conceptmap/generate \ -H "Content-Type: application/json" \ -H "Authorization: Bearer YOUR_TOKEN" \ -d '{ "title": "Ecosystem Relationships", "content": "An ecosystem consists of living organisms...", "topic": "Ecology" }'
Generate a concept map showing relationships between concepts.
Authentication: Optional (guests get concept map without saving)Request Body Text content to analyze for concepts and relationships
Response Whether the request was successful
Generated concept map structure Concept map ID (null for guests)
List of key concepts (strings)
Relationships between concepts Description of how concepts are related (e.g., “is part of”, “causes”, “requires”)
Whether the concept map was saved
Get Concept Maps curl -X GET https://api.inspir.uk/api/conceptmap/ \ -H "Authorization: Bearer YOUR_TOKEN"
Get user’s saved concept maps.
Authentication: RequiredResponse Whether the request was successful
Get Concept Map by ID curl -X GET https://api.inspir.uk/api/conceptmap/abc123
Get a specific concept map.
Authentication: OptionalUpdate Concept Map curl -X PUT https://api.inspir.uk/api/conceptmap/abc123 \ -H "Content-Type: application/json" \ -H "Authorization: Bearer YOUR_TOKEN" \ -d '{ "title": "Updated Title", "concepts": [...], "relationships": [...] }'
Update a concept map.
Authentication: RequiredDelete Concept Map DELETE /api/conceptmap/:id
curl -X DELETE https://api.inspir.uk/api/conceptmap/abc123 \ -H "Authorization: Bearer YOUR_TOKEN"
Delete a concept map.
Authentication: RequiredError Responses
400 - Missing required fields401 - Authentication required404 - Concept map not found500 - AI generation failed
Concept Map vs Mind Map Feature Concept Map Mind Map Structure Network (interconnected) Hierarchical (tree-like) Relationships Labeled connections Parent-child only Best for Understanding complex systems Brainstorming, categorization Example use Ecosystem relationships Study topic breakdown
Concept maps are particularly useful for subjects with complex interrelationships like biology, chemistry, and systems thinking.