Version History
ArcaQ feature
ยง1 โ How versioning works
Versioning is automatic and transparent โ no manual commits needed.
Automatic snapshot on save
Every note save writes a versioned copy to <arcaq:versions/> with timestamp.
Timeline view
Chronological list of all snapshots with version number, date and content preview.
One-click restore
Restoring a version replaces current note content and creates a new version entry.
Content diff
Side-by-side diff highlights additions, deletions and rewrites between any two versions.
Linked to annotations
Annotations from the time of a save are reflected in that version's metadata.
Audit-ready
Every version record includes user ID, timestamp and note type โ audit-ready out of the box.
ยง2 โ API reference
One endpoint retrieves the full version history for any note.
| Method | Endpoint | Description |
|---|---|---|
| GET | /second-brain/notes/{note_id}/history | Retrieve all version snapshots for a note |
@prefix arcaq: <http://arcaq.com/> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
arcaq:versions/v-001
a arcaq:NoteVersion ;
arcaq:forNote arcaq:notes/note-42 ;
arcaq:versionNumber "3"^^xsd:integer ;
arcaq:savedAt "2026-05-14T14:22:00Z"^^xsd:dateTime ;
arcaq:savedBy arcaq:users/alice ;
arcaq:content "Full note content as a string literal..." .