Snapshot Current Version as New Immutable Version
POST/reference-datasets/:dataset_id/versions/snapshot
Materialize the current version's accumulated state into a new immutable version.
Use this after a series of append, records/upsert, and
records/delete calls when you want to checkpoint the current state.
The previous version is preserved in history; the newly-created version
becomes the active "current" and starts mutable.
This operation reads and rewrites the full dataset, so it can be slow on large datasets — the API caller deliberately controls when to incur that cost.
Parameters:
- dataset_id: UUID of the reference dataset
- notes: Optional notes attached to the new snapshot version
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 422
New version created from the materialized current state
Validation Error
Unauthorized
Forbidden
Not Found
Unprocessable Entity