# Update conversation note

> Updates a note's content. Only the note's author can edit it.

`PATCH /v2/api/conversations/notes/{id}`

<Note>
**Required scope:** `NOTES_WRITE`
</Note>

## Behavior

Replaces the note's `content`. Only the note's **author** can edit it — updating someone else's note returns `403` with code `NOT_NOTE_AUTHOR`.

Mentions are re-parsed from the new content — see the [mentions guide](/docs/notes/overview#mentions).

## Errors

| Status | Code | When |
|--------|------|------|
| `400` | `EMPTY_NOTE_CONTENT` | `content` is missing or blank |
| `400` | `NOTE_CONTENT_TOO_LONG` | `content` exceeds 4,000 characters |
| `403` | `NOT_NOTE_AUTHOR` | The API key's user is not the note's author |
| `404` | `NOTE_NOT_FOUND` | No note with this ID |
