Skip to the documentation
API

List the notes on a thread

The private notes on one thread, pinned ones first.

GET/threads/{id}/notes

Runs the real call on your workspace.

GET /threads/{id}/notes

The private notes on one thread, pinned ones first.

Example

Needs threads:read. The notes come back in the order the Notes panel shows them: pinned first, then the rest as they were arranged.

curl
curl "$OE/threads/thr_7c1e4a90/notes" -H "$AUTH"
Response
{  "object": "list",  "data": [{      "object": "note",      "id": "b3d1f0c2-7a4e-4f7b-9c1d-2e8f6a5b4c3d",      "threadId": "thr_7c1e4a90",      "content": "Waiting on the signed contract before replying.",      "color": "yellow",      "pinned": true,      "order": 4,      "createdAt": "2026-09-30T09:12:44.000Z",      "updatedAt": "2026-09-30T09:12:44.000Z"    }]}

Notes are private to a person. A key reads and writes the notes of the workspace owner, and an app those of the person who connected it.

A key limited to particular addresses or domains reaches only the notes on threads that arrived at them, and any other thread is a 404.

Reference