Concept Maps API

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

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

title

string

required

Title of the concept map

content

string

required

Text content to analyze for concepts and relationships

topic

string

Subject or topic

Response

success

boolean

Whether the request was successful

conceptMap

object

Generated concept map structure

Show properties

string

Concept map ID (null for guests)

title

string

Concept map title

concepts

array

List of key concepts (strings)

relationships

array

Relationships between concepts

Show relationship object

from

string

Source concept

string

Target concept

relationship

string

Description of how concepts are related (e.g., “is part of”, “causes”, “requires”)

topic

string

Subject area

saved

boolean

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: Required

Response

success

boolean

Whether the request was successful

conceptMaps

array

Array of concept maps

Get Concept Map by ID

curl -X GET https://api.inspir.uk/api/conceptmap/abc123

Get a specific concept map. Authentication: Optional

Update 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: Required

Delete Concept Map

curl -X DELETE https://api.inspir.uk/api/conceptmap/abc123 \
  -H "Authorization: Bearer YOUR_TOKEN"

Delete a concept map. Authentication: Required

Error Responses

400 - Missing required fields
401 - Authentication required
404 - Concept map not found
500 - 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.

Overview

Endpoints

Documentation Index

​Overview

​Endpoints

​Generate Concept Map

​Request Body

​Response

​Get Concept Maps

​Response

​Get Concept Map by ID

​Update Concept Map

​Delete Concept Map

​Error Responses

​Concept Map vs Mind Map

Build docs developers (and LLMs) love

Overview

Endpoints

Generate Concept Map

Request Body

Response

Get Concept Maps

Response

Get Concept Map by ID

Update Concept Map

Delete Concept Map

Error Responses

Concept Map vs Mind Map