Merge 2.0
Merge 2.0 is a smarter re-import engine, it updates only what actually changed and preserves your customizations.
What gets preserved
Section IDs on matched endpoints
External links, integrations, and bookmarks stay valid after re-import.
Menu structure & ordering
Your navigation is untouched except for items you added or removed.
Customizations on unchanged sections
SEO, display preferences, access control, and viewer lists are never overwritten.
Removed section documents
Removed sections are kept in the database, so nothing is permanently deleted.
Cleaner changelog
Because the diff engine knows exactly which endpoints changed and why, the auto-generated Changelog now reflects only real API contract changes. Entries for unchanged sections which used to appear as modified due to full re-merge writes — no longer surface. The result is a cleaner, more trustworthy change history with no auto-generated noise.
How to use Merge 2.0
- Open the Editor UI.
- Type
/to open the widget menu. - Select Import Collection.
- In the modal, locate the Import Type dropdown.
- Choose Merge 2.0.
- Proceed with the import.
Run the following command:
theneo project import \
--project <project-slug> \
--workspace <workspace-slug> \
--projectVersion <version-slug> \
--publish \
--file ./api-spec.json \
--import-type merge_v2
Requirements: Theneo CLI version 19.1 or later. Check yours with:
theneo --version
On this page
- Merge 2.0