Version History
The version history page (/analyst/connectors/{id}/history) is a git-style, two-panel diff viewer
for a connector. The left panel is your current state; the right panel is a published
version you pick to compare against. You can adopt individual changes from the right into your
working copy, or restore an entire version.
Reach it from the Version history (branch icon) button in the connector editor's top bar.
Top bar
| Element | What it does |
|---|---|
| Return to editor | Goes back to /analyst/connectors/{id}/edit. |
| Title | Branch icon, the platform name, and "version history". |
| Change count badge | The total number of differences between the two sides currently shown. |
If anything fails to load, an error bar appears under the top bar.
Panel headers
A two-column header row defines what each side shows.
Left (Current)
A label ("Working copy" or "Published v…") and a Local / Published switch:
- Local (default) — your local working copy, including unsaved/unpublished changes and locally cached test data.
- Published — the last published version, ignoring your local changes.
Right (Compare against)
A version navigator:
- The selected version (
v…), with a Current publish badge when it is the active version, and a spinner while its full config loads. - Older / Newer arrows to step through versions, with a "position/total" indicator between them.
- Restore this version — disabled when the selected version is already the active publish (see below).
Under the headers, a meta line shows who created the selected version, when, and its commit message (if any).
Diff body
The diff is computed between the two sides and grouped into collapsible categories (endpoints, auth, pagination, variables, execution order, and so on). Each category header shows a count and can be collapsed.
Within a category, each changed item is a row showing:
- The item title and a status pill: Only in current (added, green), Only in selected (removed, red), Changed (amber), or Unchanged (muted).
- When applicable, a two-column field-by-field comparison: the current value on the left and the selected version's value on the right, with changed fields highlighted.
- An Adopt button (see below).
If there are no differences, the body shows a green checkmark and "No differences between these versions."
Adopt a change
Adopt pulls the selected version's value for that one item into your working copy, saved as an unpublished change you can later review and publish from the editor. Clicking it opens a confirmation dialog naming the item and the source version. The arrow points left (right → left: into your current copy).
Some items cannot be adopted directly from here; their Adopt button is disabled, with a tooltip saying to edit that item from the connector editor.
Restore a version
Restore this version publishes a brand-new version that is a full copy of the selected one and makes it active, then takes you to the editor for the restored version. A confirmation dialog explains this. Your current working-copy changes are not lost — they remain as unpublished changes. Restore is unavailable when the selected version is already the active publish.
Adopt is surgical (one value into your working copy as an unpublished change). Restore republishes an entire past version as a new active version. Use Adopt to cherry-pick; use Restore to roll back wholesale.
See Versioning for the underlying versioning model.