Add a New Version to an Existing File
A 4-step recipe with Autodesk. We can help you get access.
Recipe · 4 steps
Add a New Version to an Existing File
with Autodesk · Document Control Management
Version an existing project file rather than replacing it.
- Search the folder hierarchy for the file by display name. Search walks subfolders, unlike a plain folder contents listing, and requires the data:search scope.
- Read the item to capture the version that is currently the tip, so the caller can tell what it is superseding.
- Create the new version, relating it to the existing item and to the storage object holding the new bytes. This becomes the item's tip.
- List the item's versions to confirm the new version is present and is now the most recent entry in the history.
What you'll need to have ready
- projectId: The project containing the file.
- folderId: The folder to search beneath for the existing file.
- fileName: Display name of the file to version (e.g. "tower.rvt").
- fileType: File extension to narrow the search (e.g. "rvt").
- storageObjectId: The storage object URN holding the new bytes for this version.
- versionExtensionType: The version extension type for the host product (e.g. "versions:autodesk.bim360:File").
For your developer
Arazzo workflow autodesk:add-new-file-version, 4 operations: searchFolder → getItem → createVersion → getItemVersions. Specs on APIs.io.