Snapshots — Note Versioning#

Save, list, and restore note versions using Aicoo OS endpoints.

Prerequisites#

• AICOO_API_KEY must be set
• Base URL: https://www.aicoo.io/api/v1

API Endpoints#

• GET /api/v1/os/snapshots/{noteId}
• POST /api/v1/os/snapshots/{noteId}
• POST /api/v1/os/snapshots/{noteId}/restore

Save a Snapshot#

bash

curl -s -X POST "https://www.aicoo.io/api/v1/os/snapshots/42" \
  -H "Authorization: Bearer $AICOO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"label":"Before Q2 update"}' | jq .

List Snapshots#

bash

curl -s "https://www.aicoo.io/api/v1/os/snapshots/42?limit=10" \
  -H "Authorization: Bearer $AICOO_API_KEY" | jq .

Restore a Snapshot#

bash

curl -s -X POST "https://www.aicoo.io/api/v1/os/snapshots/42/restore" \
  -H "Authorization: Bearer $AICOO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"versionId":7}' | jq .

Restore auto-backs up current state first.

Snapshot-Before-Edit Pattern#

bash

# 1) backup
curl -s -X POST "$PULSE_BASE/os/snapshots/42" \
  -H "Authorization: Bearer $AICOO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"label":"Pre-edit backup"}' | jq .

# 2) edit
curl -s -X PATCH "$PULSE_BASE/os/notes/42" \
  -H "Authorization: Bearer $AICOO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content":"# Updated content..."}' | jq .

Scheduled Backup Pattern#

bash

# list notes in a folder
NOTES=$(curl -s "$PULSE_BASE/os/notes?folderId=5&limit=200" \
  -H "Authorization: Bearer $AICOO_API_KEY" | jq -r '.notes[].id')

# backup each
for id in $NOTES; do
  curl -s -X POST "$PULSE_BASE/os/snapshots/$id" \
    -H "Authorization: Bearer $AICOO_API_KEY" \
    -H "Content-Type: application/json" \
    -d "{\"label\":\"Pre-sync $(date +%Y-%m-%d)\"}" | jq .success
done

Guest Access Guidance#

Guest write scope still depends on notesAccess on the share link:

• read: can view/search notes
• write: can create notes
• edit: can edit notes and use snapshots