Mind Map

The mind map endpoint returns all of your ideas and their relations as a graph structure, ready for visualization.

Get Map Data

GET /api/v1/map

Returns the complete graph containing nodes (ideas) and edges (relations).

curl

curl https://neuralrepo.com/api/v1/map \
  -H "X-API-Key: nrp_YOUR_KEY"

JavaScript

const res = await fetch("https://neuralrepo.com/api/v1/map", {
  headers: { "X-API-Key": "nrp_YOUR_KEY" },
});
const graph = await res.json();

Response 200 OK

{
  "nodes": [
    {
      "id": 42,
      "title": "Add dark mode support",
      "status": "exploring",
      "tags": ["ui", "feature-request"]
    },
    {
      "id": 18,
      "title": "Theme customization options",
      "status": "building",
      "tags": ["ui"]
    },
    {
      "id": 7,
      "title": "Implement design tokens",
      "status": "captured",
      "tags": ["ui", "backend"]
    }
  ],
  "edges": [
    {
      "id": 1,
      "source": 42,
      "target": 18,
      "relation_type": "related",
      "note": "Both deal with theming"
    },
    {
      "id": 2,
      "source": 7,
      "target": 42,
      "relation_type": "blocks",
      "note": null
    }
  ]
}

Node Schema

Each node represents an idea in the graph.

Field	Type	Description
id	number	Idea identifier
title	string	Idea title
status	string	Current status
tags	string[]	Associated tag names

Edge Schema

Each edge represents a relation between two ideas.

Field	Type	Description
id	number	Relation identifier
source	number	Source idea ID
target	number	Target idea ID
relation_type	string	related, parent, blocks, inspires, duplicate, supersedes
note	string | null	Optional description

Managing Relations

The map endpoint is read-only. To create, update, or delete relations, use the Relations endpoints:

• POST /api/v1/map/relations — Create a relation
• PATCH /api/v1/map/relations/:id — Update a relation
• DELETE /api/v1/map/relations/:id — Delete a relation

Usage Tips

• Use the node tags and status fields to filter or color-code nodes in your visualization.
• The relation_type on edges can be used to style different connection types (e.g., dashed lines for related, solid arrows for blocks).

Status Codes

Status	Meaning
200 OK	Graph data returned
401 Unauthorized	Missing or invalid auth