Notes

Create or update a note

Creates a note or updates the existing one at the same path. Updates are merged convergently (CRDT) with the stored content. Optionally pass base_hash — the content_hash you last read — for compare-and-swap semantics: if the note changed since that read, the write returns 409 with the current server note instead of merging. Notes over 10MB are rejected with 413, and exceeding the plan's note cap returns 402.

post/api/notes

Request

  • Base URL: https://api.engram.page
  • URL: https://api.engram.page/api/notes
  • Auth: HTTP bearer

Request body

base_hashstring nullable

Compare-and-swap guard: the content_hash you last read for this note. If the note changed since, the write returns 409 instead of merging.

contentstring
folderstring nullable
mtimenumber float required
pathstring required
tagsstring[]
titlestring nullable
versioninteger nullable

Example request

{
  "content": "# Engram\n\nAn AI-powered personal knowledge base.\n",
  "mtime": 1718900000,
  "path": "Projects/Engram.md",
  "tags": [
    "project",
    "ai"
  ]
}

Response

Created/updated

Example response

{
  "note": {
    "path": "Projects/engram.md"
  }
}

Changes

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