---
title: "Change a note"
description: "Its text, its colour or whether it is pinned."
url: "https://openemail.uk/docs/api/notes/update"
area: "API"
category: "Mailbox"
---

# Change a note

Its text, its colour or whether it is pinned.

`PATCH /threads/{id}/notes/{noteId}`

## PATCH /threads/{id}/notes/{noteId}

Its text, its colour or whether it is pinned.

## Example

Needs `threads:write`. Give at least one of `content`, `color` and `pinned`.

**curl**

```
curl -X PATCH "$OE/threads/thr_7c1e4a90/notes/b3d1f0c2-7a4e-4f7b-9c1d-2e8f6a5b4c3d" -H "$AUTH" \
  -H "Content-Type: application/json" -d '{ "pinned": false }'
```

**Response**

```
{
  "object": "note",
  "id": "b3d1f0c2-7a4e-4f7b-9c1d-2e8f6a5b4c3d",
  "threadId": "thr_7c1e4a90",
  "content": "Waiting on the signed contract before replying.",
  "color": "yellow",
  "pinned": false,
  "order": 4,
  "createdAt": "2026-09-30T09:12:44.000Z",
  "updatedAt": "2026-09-30T09:12:44.000Z"
}
```

> A note id that is not on this thread is a 404, even when the note is on another thread.

## Reference

- [`PATCH /threads/{id}/notes/{noteId}`](https://openemail.uk/docs/api/reference/notes#patch-threads-id-notes-noteid): full reference