ACC Get File

The ACC Get File node retrieves a file from Autodesk Construction Cloud (ACC) using its identifier or path within a specified Hub and Project.

Purpose

Use this node to fetch a BIM file or document from ACC and store it for use in subsequent workflow tasks.

Inputs

Field Label	Input Type	Description
Hub Name	Text	The name of the Autodesk Construction Cloud Hub containing the file.
Project Name	Text	The name of the ACC Project containing the file.
File Identifier	Text	The unique identifier of the file in ACC. If the identifier is invalid, the system will attempt to retrieve the file by its path instead.

Outputs

Output Variable	Description
AccFile	The BIM file object retrieved from ACC.

Functionality

This node:

1. Validates required inputs (Hub Name, Project Name, File Identifier).
2. Retrieves Autodesk service account token from stored credentials.
3. Fetches the Hub and Project details using the provided names.
4. Attempts to retrieve the file by its identifier. If not found, it tries to get the file by its path.
5. Stores the retrieved file object as AccFile for use in subsequent tasks.

Example Use Case

✅ Retrieve a Revit file stored in ACC for automated downloading or processing in a later node.
✅ Retrieve a PDF drawing for inclusion in an automated transmittal package.

Task Success Criteria

• Success: File is retrieved and stored in AccFile.
• Failure: If Hub, Project, or File cannot be found, the task fails with a descriptive error message indicating which part of the retrieval failed.

Notes

• Ensure the ThirdParty-Autodesk service account is correctly configured with valid credentials and appropriate access to the specified Hub and Project.
• The task attempts retrieval by both Id and Path to maximise compatibility with varying input types.
• The output object (AccFile) structure depends on the BIMFile model returned by the ACC API integration.