Notes

Update Note

PATCH /v1/notes/{noteId}

PATCH/v1/notes/{noteId}
PATCH
/v1/notes/{noteId}

Update a note

Updates the content or visibility of an existing note. Only the fields you provide will be changed — any field you omit will remain unchanged. Use the note ID returned when the note was created.

Authorization

x-api-key<token>

API key for Open API authentication

In: header

Request Body

application/jsonRequired

Provide one or more fields to update — only the fields you include will be changed. content replaces the note text. visibility accepted values: "1" = Public, "2" = Private. status accepted values: "0" = Draft, "1" = Published.

contentstring

The updated content of the note. Supports plain text.

Example: "Prospect confirmed interest. Schedule a demo call for next Monday."

visibilitystring

Updated visibility setting. Use "1" for public (visible to all team members) or "2" for private (visible only to you).

Example: "2"Value in: "1" | "2"

statusstring

Updated status of the note. Use "0" for draft or "1" for published.

Example: "1"Value in: "0" | "1"

Path Parameters

noteIdstring

Public note ID returned by Create Note or Fetch Notes.

Request Body Examples

{
  "content": "Prospect confirmed interest. Schedule a demo call for next Monday."
}

Responses

200
Note updated successfully
{
  "message": "Note updated successfully",
  "payload": {
    "id": "Nt7Yp4Za",
    "prospectId": "Pr9xQ2Lm",
    "visibility": "1",
    "status": "1",
    "content": "<p>Updated renewal timeline.</p>",
    "createdAt": "2026-04-21T10:57:07.000Z",
    "updatedAt": "2026-04-21T10:58:28.000Z",
    "editedAt": "2026-04-21T10:58:29.000Z",
    "editedBy": {
      "firstName": "Avery",
      "lastName": "Stone",
      "email": "[email protected]"
    }
  }
}

Request

Example:
curl -X PATCH \
  "https://open-api.saleshandy.com/v1/notes/{noteId}" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "content": "Prospect confirmed interest. Schedule a demo call for next Monday."
}'

Response

No response body