--- title: "Update a single Note" method: POST path: "/v2/notes/{noteId}" tags: ["Notes"] --- # Update a single Note `POST /v2/notes/{noteId}` Make an update to an existing note's body content or its entity associations. You can only update notes you have write access to. You can update any type of note including AI Notetaker notes (`ai-notetaker`, `ai-notetaker-reply`), but a note's type itself cannot be changed. All body properties are optional: only the properties supplied are updated, and other properties are left unchanged. For each of `persons`, `companies`, and `opportunities`, you may: - omit the field to leave existing associations unchanged - send an empty array (`[]`) to clear all associations of that kind - send a non-empty array to replace the existing set with the supplied list. Reply notes (`user-reply`, `ai-notetaker-reply`) have no entity associations, so only `content` can be updated for replies. Updating `content` is subject to the same HTML restrictions as creation; submitting restricted HTML will cause the request to fail. See the request examples below. The content of notes that contain @mentions cannot be updated through this endpoint; attempting to do so returns `400 Bad Request`. Returns `204 No Content` on success, regardless of whether any properties actually changed. ## Path parameters - `noteId` integer, required ## Request body - NotesNoteToBeUpdated — Request body for updating an existing note. All properties are optional: only those explicitly provided are updated, and other properties are left unchanged. The properties that may be updated depend on the existing note's type: - Root notes (`entities`, `interaction`, `ai-notetaker`) may update `content` and the entity association arrays (`persons`, `companies`, `opportunities`). - Reply notes (`user-reply`, `ai-notetaker-reply`) may update `content` only; attaching `persons`, `companies`, or `opportunities` to a reply note is rejected. For each of `persons`, `companies`, and `opportunities`, you may: - omit the field to leave existing associations unchanged - send an empty array (`[]`) to clear all associations of that kind - send a non-empty array to replace the existing set with the supplied list. Any note the caller has write access to can be updated, including AI Notetaker notes. A note's type itself cannot be changed. The content of notes that contain @mentions cannot be updated. - `content` NotesContentToBeSaved — The note's body content. Only `html` is supported on write; supply rendered HTML limited to the allowed tags listed below. - `html` string, required — The HTML content of the note. **Allowed tags (with no attributes other than those explicitly noted):** `

`, `
`, ``, ``, ``, `

    `, `