Knowledge graph
Create a knowledge graph (bubble network) showing how concepts relate to each other, like an Obsidian graph view.
Send "type": "knowledge_graph".
Create a knowledge graph (bubble network) showing how concepts relate to each other, like an Obsidian graph view.
Also available as the MCP tool render_knowledgegraph. The same payload works through either surface.
Fields
nodesobject[]requiredArray of nodes with id, label, and weight (1-8). Labels are 1-3 words, under 24 characters — longer text is pushed under the bubble and cut off after two lines.
Child attributes
idstringrequiredlabelstringrequiredweightintegerrequirededgesobject[]requiredArray of edges with id, from, to, and label. Edge labels are 1-2 words, under 16 characters, and are left as "" when the relationship is obvious — a label on every edge crowds the canvas.
Child attributes
idstringrequiredfromstringrequiredtostringrequiredlabelstringExample
{
"type": "knowledge_graph",
"data": {
"nodes": [
{
"id": "string",
"label": "string",
"weight": 0
}
],
"edges": [
{
"id": "string",
"from": "string",
"to": "string",
"label": "string"
}
]
}
}
Add one record
POST /boards/{boardId}/items/{itemId}/records adds one of these to an item already on a board and leaves the rest of it as it is. Send the same key again to update that record instead of adding another.
Record fields
labelstringrequiredweightnumberHow big it is drawn, 1 to 5.
linkedTostringAnother node, by its label; made when there is none.
relationstringkeystringYour own id for this record, like an issue key. Sending the same key again updates and moves that record instead of adding another.
{
"record": {
"label": "string",
"weight": 0,
"linkedTo": "string",
"relation": "string",
"key": "string"
}
}