v1

latestOpenAPI 3.1.1Proprietary2026-07-2687313591.4 KB
Notes

Update a single Note

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.

post/v2/notes/{noteId}

Path parameters

noteIdinteger required

The id of the Note to update

Request body

Example request

{
  "content": {
    "html": "<p>Quick recap of the call. Action items follow.</p>"
  },
  "persons": [
    {
      "id": 1
    }
  ],
  "companies": [
    {
      "id": 1
    }
  ],
  "opportunities": [
    {
      "id": 1
    }
  ]
}

Response

No Content