# Versions

Cut, read, compare and download version tags, and preview and publish a
version with the edits drawn on its takes.

- [`GET /v1/accounts/{account}/datasets/{dataset}/mergeHistory`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/versions_getmergehistory.md): Reads the merge and revert events for one dataset, newest first.
- [`GET /v1/accounts/{account}/datasets/{dataset}/versionPreviews`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/versions_listversionpreviews.md): Lists the caller's live preview of the dataset, if any, so a closed dialog picks it up again.
- [`POST /v1/accounts/{account}/datasets/{dataset}/versionPreviews`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/versions_createversionpreview.md): Previews the version an upload or a merged dataset would publish ("Apply all"): freezes the takes `include` picks, each with the edit drawn on it, and starts measuring them.
- [`GET /v1/accounts/{account}/datasets/{dataset}/versionPreviews/{versionPreview}`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/versions_getversionpreview.md): Gets a preview: how far it is, its counts, and, once READY, how it compares with the newest tag and what changed since it was made.
- [`DELETE /v1/accounts/{account}/datasets/{dataset}/versionPreviews/{versionPreview}`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/versions_deleteversionpreview.md): Discards the caller's preview.
- [`GET /v1/accounts/{account}/datasets/{dataset}/versionPreviews/{versionPreview}/items`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/versions_listversionpreviewitems.md): A preview's windows, take by take, with what each measured: the numbers its charts draw.
- [`POST /v1/accounts/{account}/datasets/{dataset}/versionPreviews/{versionPreview}:publish`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/versions_publishversionpreview.md): Publishes a READY preview of the caller's as tag `version_id` ("Create" in the dialog): cuts each edited take into new episodes beside it, then tags exactly the previewed episodes.
- [`GET /v1/accounts/{account}/datasets/{dataset}/versions`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/versions_listversions.md): Lists a dataset's tags, newest first.
- [`POST /v1/accounts/{account}/datasets/{dataset}/versions`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/versions_createversion.md): Tags what the dataset yields now.
- [`GET /v1/accounts/{account}/datasets/{dataset}/versions/{version}`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/versions_getversion.md): Gets a tag, or resolves `stable`, `head`, a DatasetVersion id or a prefix.
- [`PATCH /v1/accounts/{account}/datasets/{dataset}/versions/{version}`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/versions_updateversion.md): Edits a tag's note.
- [`GET /v1/accounts/{account}/datasets/{dataset}/versions/{version}/materializations/{materialization}`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/versions_getmaterialization.md): How far a tag's rendering is.
- [`GET /v1/accounts/{account}/datasets/{dataset}/versions/{version}/materializations/{materialization}/artifacts`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/versions_listmaterializationartifacts.md): A rendered dataset's files in path order, each with a fresh signed URI.
- [`POST /v1/accounts/{account}/datasets/{dataset}/versions/{version}/materializations/{materialization}:start`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/versions_startmaterialization.md): Starts rendering a tag in the id's layout, or picks up the rendering already there: it never renders twice.
- [`GET /v1/accounts/{account}/datasets/{dataset}/versions/{version}/sourceCommits`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/versions_listsourcecommits.md): Lists the repository commits a tag pins, ordered by upload, so a version can be traced to the repositories its episodes came from.
- [`GET /v1/accounts/{account}/datasets/{dataset}/versions:compare`](https://junction-docs.qualiastudios.dev/api/qualia-v1/operations/versions_compareversions.md): What came in, went out or changed revision between two refs of one dataset, and why.