> ## Documentation Index
> Fetch the complete documentation index at: /dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# notes_related

> Follow the links between notes.

> [!NOTE]
>
> Free · Your own key only

Finds notes for a query, then walks the links between notes for a few steps and gives back the graph: which notes link to which. Use it to see what hangs off a note, not to look something up (that is `notes_find`). Results can be large, so keep `top_k` and `max_total_nodes` small.

Call it at `POST /platform/v1/me/tools/notes_related`. On MCP, your AI tool calls `notes_related` with the same arguments.

## Arguments

Send these inside `arguments`.

**query** `string` *required*

Where to start.

**hops** `integer` (default: 2)

How many steps to follow.

**top\_k** `integer` (default: 10)

How many notes to start from.

**max\_total\_nodes** `integer` (default: 80)

The most notes to return.

**tag\_names** `string[]` (default: null)

Only notes with these tags.

**fixed\_integration\_names** `string[]` (default: null)

Only items from these connected apps.

## Returns

The tool's answer comes back under `result`.

**nodes** `object[]`

The notes found.

**edges** `object[]`

Which note links to which.

```bash Your key theme={"system"}
curl https://api.constella.app/platform/v1/me/tools/notes_related \
  -H "Authorization: Bearer $CONSTELLA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"arguments": {"query": "pricing", "hops": 1, "top_k": 5}}'
```

```python Python theme={"system"}
import os, requests

r = requests.post(
    "https://api.constella.app/platform/v1/me/tools/notes_related",
    headers={"Authorization": f"Bearer {os.environ['CONSTELLA_API_KEY']}", "X-Constella-Client": "my-script"},
    json={"arguments": {"query": "pricing", "hops": 1, "top_k": 5}},
)
print(r.json()["result"])
```

```javascript JavaScript theme={"system"}
const res = await fetch("https://api.constella.app/platform/v1/me/tools/notes_related", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.CONSTELLA_API_KEY}`,
    "X-Constella-Client": "my-script",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"arguments": {"query": "pricing", "hops": 1, "top_k": 5}}),
});
const { result } = await res.json();
```

```json 200 theme={"system"}
{
  "result": {
    "nodes": [
      {
        "id": "9f2c...",
        "title": "Pricing call notes"
      }
    ],
    "edges": []
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.