Skip to content

docs(v3): document App Actions V3 version history#273

Open
veljko7 wants to merge 2 commits into
masterfrom
release/DEV-1314
Open

docs(v3): document App Actions V3 version history#273
veljko7 wants to merge 2 commits into
masterfrom
release/DEV-1314

Conversation

@veljko7

@veljko7 veljko7 commented Jun 5, 2026

Copy link
Copy Markdown
Contributor

@

Summary

Documents the version-history feature added to V3 App Actions in fliplet-api (DEV-1259 / PR #8070): config snapshots on create/update/restore, the 100-version retention cap, and the three REST endpoints to list, fetch, and restore versions.

Changes

  • New Version history section covering snapshot-on-write behaviour (create/update/pre-restore reasons), retention/pruning, cascade delete, and what a snapshot captures
  • Documented GET /versions (paginated summary), GET /versions/:id (full snapshot), and POST /versions/:id/restore (undo-able restore, refuses production) with Fliplet.API.request() examples and response shapes
  • Added concept point on versioning to Data models and key concepts
  • Error tables: VERSION_NOT_FOUND, CANNOT_RESTORE_PRODUCTION, RESTORE_FAILED (plus the 409 name-collision case on restore)
  • Rate limits: version reads under CRUD bucket, restore under publish
  • Frontmatter capabilities: version history, restore version, rollback

🤖 Generated with Claude Code
@

veljko7 and others added 2 commits June 1, 2026 17:03
Document the version-history feature added to V3 App Actions in
fliplet-api (DEV-1259 / PR #8070): config snapshots on create/update/
restore, the 100-version retention cap, and the three REST endpoints
to list, fetch, and restore versions.

- New "Version history" section covering snapshot-on-write behaviour
  (create/update/pre-restore reasons), retention/pruning, cascade
  delete, and what a snapshot captures
- GET /versions (paginated summary), GET /versions/:id (full snapshot),
  POST /versions/:id/restore (undo-able restore, refuses production)
  documented with Fliplet.API.request() examples and response shapes
- Added concept point on versioning to "Data models and key concepts"
- Error tables: VERSION_NOT_FOUND, CANNOT_RESTORE_PRODUCTION,
  RESTORE_FAILED (plus the 409 name-collision case on restore)
- Rate limits: version reads under CRUD bucket, restore under publish
- Frontmatter capabilities: version history, restore version, rollback

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
docs(v3): document App Actions V3 version history
@veljko7 veljko7 requested review from Arpanexe and Komsomol June 5, 2026 15:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants