Notes

Update a Note with revision conflict protection

Update a Note with revision conflict protection.

patch/api/notes/{id}

Request

  • Base URL: https://keep.md
  • URL: https://keep.md/api/notes/{id}
  • Auth: one of:
    • HTTP bearer
    • API key in cookie keep.session_token

Headers

Keep-API-Versionstring
Example:2026-08-24

Optional date-based Keep API version. Omit it to use the current version.

Request body

titlestring
bodyMarkdownstring
propertiesobject

Custom Note metadata. First-class tags, Project, repository, kind, and state use their top-level fields.

tagsstring[]

Omit on update to preserve current tags. Send an empty array to remove every tag.

projectstring nullable

Omit on update to preserve the current Project. Send null to clear it.

repositorystring nullable

Omit on update to preserve the current repository. Send null to clear it.

kindstring nullable

Omit on update to preserve the current kind. Send null to clear it.

statestring nullable

Omit on update to preserve the current state. Send null to clear it.

expectedRevisioninteger required

Required for replacements and metadata changes. Optional on append to pin the write to a known revision.

clientRequestIdstring
changeSummarystring
modelstring

Response

Updated Note

replayedboolean required
webUrlstring uri required

Changes

No recorded changes to this operation across all 1 revision of this API.