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

# notes_read

> Read one note, file or synced item in full.

> [!NOTE]
>
> Free · Your key and project keys

Reads one item by its id, from a search, `notes_recent` or `memory_recall`. Read a note in full before you quote it or rely on a detail from it.

Call it at `POST /platform/v1/me/tools/notes_read` or, for one of your app's users, `POST /platform/v1/users/{uid}/tools/notes_read`. On MCP, your AI tool calls `notes_read` with the same arguments.

## Arguments

Send these inside `arguments`.

**id** `string` *required*

The item's id.

## Returns

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

**id** `string`

The item's id.

**title** `string`

Its title.

**text** `string`

The full text, up to 60,000 characters.

**url** `string`

A link to it, when it has one.

**metadata** `object`

`type`, `integration`, `tags`, `created`, `lastModified`, `truncated` and `totalChars`.

```bash Your key theme={"system"}
curl https://api.constella.app/platform/v1/me/tools/notes_read \
  -H "Authorization: Bearer $CONSTELLA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"arguments": {"id": "9f2c..."}}'
```

```bash Project key theme={"system"}
curl https://api.constella.app/platform/v1/users/u_123/tools/notes_read \
  -H "Authorization: Bearer $CONSTELLA_APP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"arguments": {"id": "9f2c..."}}'
```

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

r = requests.post(
    "https://api.constella.app/platform/v1/me/tools/notes_read",
    headers={"Authorization": f"Bearer {os.environ['CONSTELLA_API_KEY']}", "X-Constella-Client": "my-script"},
    json={"arguments": {"id": "9f2c..."}},
)
print(r.json()["result"])
```

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

```json 200 theme={"system"}
{
  "result": {
    "id": "9f2c...",
    "title": "Pricing call notes",
    "text": "Team plan stays at $20 a seat...",
    "url": null,
    "metadata": {
      "type": "note",
      "integration": "constella",
      "tags": [
        "pricing"
      ],
      "truncated": false,
      "totalChars": 1840
    }
  }
}
```


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