25 Jun 2025
New API to retrieve metadata and signed download URLs of host/linked files for a Revit Cloud Model
Are you struggling to download and handle Revit Cloud Model(RCM) from Autodesk Docs? The downloaded RCM sometimes will be a ZIP package if any linked models are not published to latest, this behaviour makes handling the downloaded RCW file a lot difficult. My colleagues also posted some blogs as follow to workaround this situation:
- Make composite Revit design work with Revit Automation API
- Revit Cloud Worksharing - fast extraction of Revit zip files with partials
While still keeping the current behaviour of zip file, we are pleased to inform you that a new exciting API(public beta) is provided additionally as follow:
This API provides developer the ability to retrieve metadata and signed download URLs of any linked models(also including host model) for a RCM, no matter if the linked model is published or not. Developers now have an option to just download the host or linked model as they want.
For the detail of usage, please refer the tutorial of Download RVT Files from a Published Model.
Please be noted that this API only supports the RCMs published after Feb 7, 2025.
There are a couple of notes I'd like to highlight, let's take a Revit Cloud Mode "Sample2025.rvt" for example:
The response of file version by Data Management API:
{
"type": "versions",
"id": "urn:adsk.wipprod:fs.file:vf.UcS7SqoCQaaFH2q7eOmWwA?version=6",
"attributes": {
"name": "Sample2025.rvt",
"displayName": "Sample2025.rvt",
"createTime": "2025-06-25T20:52:11.0000000Z",
"createUserId": "4V4WKQJGGQ7N",
"createUserName": "Zhong Wu",
"lastModifiedTime": "2025-06-25T20:53:39.0000000Z",
"lastModifiedUserId": "4V4WKQJGGQ7N",
"lastModifiedUserName": "Zhong Wu",
"versionNumber": 6,
"mimeType": "application/vnd.autodesk.r360",
"storageSize": 77254407,
"fileType": "rvt",
"extension": {
"type": "versions:autodesk.bim360:C4RModel",
"version": "1.3.3",
"schema": {
"href": "https://developer.api.autodesk.com/schema/v1/versions/versions:autodesk.bim360:C4RModel-1.3.3"
},
"data": {
"modelVersion": 6,
"isCompositeDesign": true,
"mimeType": "application/vnd.autodesk.r360",
"revitProjectVersion": 2025,
"compositeParentFile": "Sample2025.rvt",
"projectGuid": "1576aefe-dae2-4ef5-a2f4-293ae681ad70",
"publishType": "Hybrid",
"originalItemUrn": "urn:adsk.wipprod:dm.lineage:UcS7SqoCQaaFH2q7eOmWwA",
"modelType": "multiuser",
"latestEpisodeGuid": "a21bcced-17e3-4da1-9a7e-fabd46d6988e",
"modelGuid": "a61ea1eb-c1f3-4cd5-9c34-bcf5a1009f42",
"processState": "PROCESSING_COMPLETE",
"extractionState": "SUCCESS",
"splittingState": "NOT_SPLIT",
"reviewState": "NOT_IN_REVIEW",
"revisionDisplayLabel": "6",
"sourceFileName": "Sample2025.rvt",
"conformingStatus": "NONE"
}
}
},
}- data.attributes.extension.type represents the type of this file, versions:autodesk.bim360:C4RModel tells this is a Revit Cloud Model.
- data.attributes.extension.data.isCompositeDesign represents if it's a zip package or a normal rvt file, true here tells this RCM is a composite model, which should be a zip package if you download this RCM from UI directly.
- data.attributes.extension.data.compositeParentFile represents the host model name.
- data.attributes.extension.data.publishType is a new added property, represents if the zip is also existing, Hybrid represents a state where we publish both the zip file and the metadata required by this API to be able to provide the signed urls of the linked files.
The response of the host/linked models by GET Linked revit files:
{
"hostFile": {
"modelName": "Sample2025.rvt",
"signedUrl": "https://s3.amazonaws.com/skyscraper.project.data/publish/a61ea1eb-c1f3-4cd5-9c34-bcf5a1009f42/version_6.rvt?AWSAccessKeyId=ASIAXEDRHVD2SEZV2I4G&Expires=1750885193&x-amz-security-token=IQoJb3JpZ2luX2VjEFUaCXVzLWVhc3QtMSJHMEUCICER2DxYinv6yFsbIQaSZKYPMDq%2FT5OhofOdCpL3NlB6AiEAhuf7%2F92Ugh0SYQvC88Wtxlf8flw%2FU3AvEPiYqg%2FuFQIqsgUIThAAGgw0ODk4NjM3NTE5MjUiDPKiDU4GU38r5O%2B5cyqPBdtf%2FJj5qmqDuO0O9vxicOc0w8LRFaUzUGmsxl7C1P%2BwfuhEzMGof1CzSj8gKUCPM30kKorIHzzqVRZcDcXrH%2BAxD5hQIZma5re4HUoFYvOnhGX%2F46JrGwCWZJlWYNatUWR6%2BkT4PqZ6p2A09KSjcBWcO4e%2BnMNapj45%2BF7I9R%2BGcwSFQgBrKFJ%2FhRkk9ou7KNA7s6rsO6BCbxsV3NcnVhsU4dS3iWw6fKuGze%2B8k3QVhnK0MoDSq4FML%2BefVGk%2Bj7ZiVGg7HjG8EHu%2B5VkE6LQHkNB0483v2QFSkLe767gxyjCXcbZ9VamufcqloDK3uyPo6HIe5rU6HH6GsLGWVti7PHOap88p3DIwx2xpNTudHYnJOhMuiUmAb0EQwAGfbArAiY9lZWHG2QXuxBXSngrBcmSK7XPZq2GIcwqd9%2FoWeSIl8Gh8sWzjRq1Uh64eCT4FqknGDI3wOvy70ogV6fz%2Fi%2BZFRX5i4X1iVSvrLkvjqeALY1TaOI0pn0YKRHEWUiJj9jzaP4%2B3vf9Nm%2BIODYKCGaRF9VQVesoeP8GxLPT8lnbXB3xFD3Ob%2Fbt13VrMOYyz%2FXVtHaXvKAmHkqcrDnN9e7FMIQeBflnhY43fUTQHPNvvA1EykSSIMEjwNXObARY37tfZMyEj7ETQkrk6lO2SoGhhCR4tH6GH4uU7ODNLUQEQwGpX12CrfcpZ1%2BBQZZv8H6CO6KQkrc%2F0WvvqfMmh1QDjSjeT6FA%2F2aSqo19kA0wPLG6ETosqbbTJx9%2FzZl1bPte8WMkZgFqUQgSASFUKZlvm%2FwwHUyCWdh5X6omNGUV9oZX3lrlG6myeDgFg153QQzbJ1nJlC4AAoWYKS7em7%2FQJ2gywbCJD8vBl%2BAUw97%2FxwgY6sQGsmVahQ3Z017ScATKKPY9Nb1YFEsnRJ4jBly8PGndqIiVoWs48Rxpeu%2Bi%2F5EVtCpGW6Sm3EYNICi0%2BMxUWoYHCbHM9wCk24%2FM4cfzfapJK%2BtWz16Qfty1f0gadY6Md%2Fc3h%2FIwMOO344mN7MBbIfcUUkBTI4esjYZSu1%2FiPWUokBqZ4UmMW2RSM3dT0eNgXgWMECPhOxTvWFmZFZwLPsNOuP4QVyo9Qq6rtPgdxQ%2FDI2Ic%3D&Signature=Bodyy3Bu9eX77vDhYLruv%2Fwfp%2F4%3D",
"itemId": "urn:adsk.wipprod:dm.lineage:UcS7SqoCQaaFH2q7eOmWwA",
"versionId": "urn:adsk.wipprod:fs.file:vf.UcS7SqoCQaaFH2q7eOmWwA?version=6",
"size": 38612992,
"publishStatus": "Published"
},
"linkedFiles": {
"pagination": {
"limit": 600,
"offset": 0,
"totalResults": 1
},
"results": [
{
"modelName": "Sample2025-linked.rvt",
"signedUrl": "https://s3.amazonaws.com/skyscraper.project.data/publish/165fda7b-8939-4574-b584-8d84a8c6551d/version_4.rvt?AWSAccessKeyId=ASIAXEDRHVD2SEZV2I4G&Expires=1750885193&x-amz-security-token=IQoJb3JpZ2luX2VjEFUaCXVzLWVhc3QtMSJHMEUCICER2DxYinv6yFsbIQaSZKYPMDq%2FT5OhofOdCpL3NlB6AiEAhuf7%2F92Ugh0SYQvC88Wtxlf8flw%2FU3AvEPiYqg%2FuFQIqsgUIThAAGgw0ODk4NjM3NTE5MjUiDPKiDU4GU38r5O%2B5cyqPBdtf%2FJj5qmqDuO0O9vxicOc0w8LRFaUzUGmsxl7C1P%2BwfuhEzMGof1CzSj8gKUCPM30kKorIHzzqVRZcDcXrH%2BAxD5hQIZma5re4HUoFYvOnhGX%2F46JrGwCWZJlWYNatUWR6%2BkT4PqZ6p2A09KSjcBWcO4e%2BnMNapj45%2BF7I9R%2BGcwSFQgBrKFJ%2FhRkk9ou7KNA7s6rsO6BCbxsV3NcnVhsU4dS3iWw6fKuGze%2B8k3QVhnK0MoDSq4FML%2BefVGk%2Bj7ZiVGg7HjG8EHu%2B5VkE6LQHkNB0483v2QFSkLe767gxyjCXcbZ9VamufcqloDK3uyPo6HIe5rU6HH6GsLGWVti7PHOap88p3DIwx2xpNTudHYnJOhMuiUmAb0EQwAGfbArAiY9lZWHG2QXuxBXSngrBcmSK7XPZq2GIcwqd9%2FoWeSIl8Gh8sWzjRq1Uh64eCT4FqknGDI3wOvy70ogV6fz%2Fi%2BZFRX5i4X1iVSvrLkvjqeALY1TaOI0pn0YKRHEWUiJj9jzaP4%2B3vf9Nm%2BIODYKCGaRF9VQVesoeP8GxLPT8lnbXB3xFD3Ob%2Fbt13VrMOYyz%2FXVtHaXvKAmHkqcrDnN9e7FMIQeBflnhY43fUTQHPNvvA1EykSSIMEjwNXObARY37tfZMyEj7ETQkrk6lO2SoGhhCR4tH6GH4uU7ODNLUQEQwGpX12CrfcpZ1%2BBQZZv8H6CO6KQkrc%2F0WvvqfMmh1QDjSjeT6FA%2F2aSqo19kA0wPLG6ETosqbbTJx9%2FzZl1bPte8WMkZgFqUQgSASFUKZlvm%2FwwHUyCWdh5X6omNGUV9oZX3lrlG6myeDgFg153QQzbJ1nJlC4AAoWYKS7em7%2FQJ2gywbCJD8vBl%2BAUw97%2FxwgY6sQGsmVahQ3Z017ScATKKPY9Nb1YFEsnRJ4jBly8PGndqIiVoWs48Rxpeu%2Bi%2F5EVtCpGW6Sm3EYNICi0%2BMxUWoYHCbHM9wCk24%2FM4cfzfapJK%2BtWz16Qfty1f0gadY6Md%2Fc3h%2FIwMOO344mN7MBbIfcUUkBTI4esjYZSu1%2FiPWUokBqZ4UmMW2RSM3dT0eNgXgWMECPhOxTvWFmZFZwLPsNOuP4QVyo9Qq6rtPgdxQ%2FDI2Ic%3D&Signature=6yCfZG9KSebD1LrnppcFhzkaekY%3D",
"itemId": "urn:adsk.wipprod:dm.lineage:2D1VbM5fRp6QImjI3K90lA",
"size": 38629376,
"publishStatus": "NotPublished"
}
]
}
}- data.hostFile.publishStatus and data.linkedFiles.results.publishStatus represents if the model is published or not, for host model, it will be always "Published", for linked files, you may get "NotPublished" if this linked model is not published to latest.
- data.linkedFiles.results.versionId only existing if the linked model is published to latest.
- This API also works with SSA token, just make sure the SSA account user has at least download permission to the Revit Cloud Model.
Have questions or need help? Please don't hesitate to contact us through our APS support channel.
