Get Note Versions

Every time a note's body is created, replaced, or appended to, Monolith records a version snapshot. This endpoint retrieves a note's version history — useful for audit trails and for recovering earlier content.

GET /v1/notes/{uuid}/versions

Path parameters

Parameter	Description
uuid	UUID of the note whose versions to list.

Query parameters

All optional.

Parameter	Type	Default	Description
version_uuid	string	—	Return a single version by its UUID.
include_content	boolean	false	Include each version's HTML body (note_data).
search	string	—	Full-text search within version text. Matching versions include a snippets array of excerpts around each match.
sort_by	string	—	created_on.
sort_dir	string	asc	asc or desc.
page	number	1	Page number (1-based).
page_size	number	3000	Results per page, max 3000.

Response — 200 OK

{
  "data": [
    {
      "uuid": "a3bb189e-8bf9-3888-9912-ace4e6543002",
      "note_uuid": "0f8fad5b-d9cb-469f-a165-70867728950e",
      "created_on": "2026-08-03T14:32:11.482Z",
      "note_data": "<p>Imaging started at 13:05 UTC.</p><p><strong>14:32 UTC</strong> — Imaging completed.</p>",
      "created_by": {
        "user_id": 12,
        "email": "[e-mail]",
        "first_name": "API",
        "last_name": "User",
        "full_name": "API User",
        "title": "Integration"
      },
      "linked_case": {
        "case_id": 42,
        "uuid": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
        "case_number": "2026-0042",
        "case_name": "Acme Corp Investigation"
      }
    }
  ],
  "page": 1,
  "next_page": null,
  "page_size": 3000,
  "total": 3
}

• note_data is only present when include_content=true.

• snippets is only present on search queries.

Examples

List a note's version history (newest first)

response = session.get(
    f"{BASE_URL}/notes/0f8fad5b-d9cb-469f-a165-70867728950e/versions",
    params={"sort_by": "created_on", "sort_dir": "desc"},
)
for version in response.json()["data"]:
    author = version["created_by"]["full_name"] if version["created_by"] else "unknown"
    print(f"{version['created_on']}  {version['uuid']}  by {author}")

Recover an earlier version's content

note_uuid = "0f8fad5b-d9cb-469f-a165-70867728950e"

# Fetch a specific version with its body
version = session.get(f"{BASE_URL}/notes/{note_uuid}/versions", params={
    "version_uuid": "a3bb189e-8bf9-3888-9912-ace4e6543002",
    "include_content": "true",
}).json()["data"][0]

# Restore it by writing the old body back to the note
# (this itself records a new version, so nothing is lost)
session.patch(f"{BASE_URL}/notes/{note_uuid}", json={
    "note_data": version["note_data"],
}).raise_for_status()

Find which version introduced a phrase

response = session.get(f"{BASE_URL}/notes/{note_uuid}/versions", params={
    "search": "write blocker",
    "sort_dir": "asc",
})
versions = response.json()["data"]
if versions:
    first = versions[0]
    print(f"First mentioned {first['created_on']} in version {first['uuid']}")
    for snippet in first.get("snippets", []):
        print(f"  ...{snippet}...")

Errors

Status	Body	Cause
400	{"message": "Invalid query parameters", "errors": [...]}	Bad parameter type or value.
401	Unauthorized	Missing or invalid API key.