Skip to the documentation
API

Add a note to a thread

Pin a private note to a thread.

POST/threads/{id}/notes

Runs the real call on your workspace.

POST /threads/{id}/notes

Pin a private note to a thread.

Example

Needs threads:write. content is up to 20,000 characters, color is one of default, red, orange, yellow, green, blue, purple and pink, and pinned keeps the note at the top. Answers 201 with the note.

curl
curl -X POST "$OE/threads/thr_7c1e4a90/notes" -H "$AUTH" -H "Content-Type: application/json" \  -d '{ "content": "Waiting on the signed contract before replying.", "color": "yellow", "pinned": true }'
Response
{  "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"}

A new note goes after the others. Sending the same request twice adds two notes.

Reference