How do I unlock a Revit file?

To unlock a Revit file in Autodesk Construction Cloud (ACC), you need to use a DELETE request to the lock endpoint. This requires knowing the object path of the locked file.

Here's a breakdown of the process:

1. Identify the Object Path: The object path is the URL that specifies the location of the locked file within ACC. You will need to obtain this path to unlock the file.

2. Use the DELETE Request: Once you have the object path, use the following URL structure with a DELETE request:

   DELETE /{objectPath}/lock?objectMustExist={objectMustExist}

   • Replace {objectPath} with the actual object path of the Revit file.
   • objectMustExist={objectMustExist} is a parameter that specifies whether the object must exist before attempting to unlock it. Set it to true if you want to ensure the file exists. Example: objectMustExist=true

Example:

Let's say the object path for your locked Revit file is /data/myproject/RevitModels/MyRevitModel.rvt. The DELETE request URL would then be:

DELETE /data/myproject/RevitModels/MyRevitModel.rvt/lock?objectMustExist=true

Important Considerations:

• Permissions: You must have the appropriate permissions to unlock the file. Usually, this requires project administrator rights or explicit permissions to modify the file.
• API Access: Unlocking via the DELETE request typically involves using an API client or tool that can send HTTP requests. This may require some programming knowledge or using a pre-built integration.

Why is my Revit File Locked?

Revit files are typically locked for a few reasons:

• Central Model Synchronization: When someone is synchronizing with the central model, the file is temporarily locked to prevent conflicts.
• Worksharing: In a workshared environment, Revit locks elements that a user is actively working on.
• ACC Issues: Sometimes, due to various errors within Autodesk Construction Cloud, a model may remain locked even after a user is no longer actively using or synchronizing it.

If the file remains locked for an extended period and no one is actively using it, the above DELETE request solution is the recommended method to unlock it.