ACC Get Files In Folder

The ACC Get Files In Folder node retrieves a list of files from a specified folder in Autodesk Construction Cloud (ACC) within a Hub and Project.

Purpose

Use this node to list all files within a specific ACC folder for further processing in your automation workflows.

Inputs

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

Outputs

Output Variable	Description
AccFiles	A list of BIM files retrieved from the specified folder.

Functionality

This node:

1. Validates required inputs (Hub Name, Project Name, Folder 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 folder by its identifier. If not found, it tries to get the folder by its path.
5. Lists all files within the folder and stores them in AccFiles.

Example Use Case

✅ List all PDF drawings in a project folder to attach them to automated transmittal emails.
✅ Retrieve all Revit models within a design folder for batch processing or publishing workflows.

Task Success Criteria

• Success: Files are retrieved and stored in AccFiles.
• Failure: If Hub, Project, Folder, or Files 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 has appropriate access to the specified Hub and Project.
• The task retrieves files by both Id and Path to maximise compatibility with varying input types.
• The output object (AccFiles) is a list of BIMFile models as returned by the ACC API integration.