ACC Get Folder

The ACC Get Folder node retrieves a specific folder from Autodesk Construction Cloud (ACC) within a Hub and Project, returning its full path and folder details.

Purpose

Use this node to fetch folder metadata from ACC for use in automated workflows requiring folder validation, path building, or further file/folder operations.

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
AccFolder	The folder object retrieved from ACC, including its full path and metadata.

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. Builds the full folder path by retrieving ancestor folders and appending the current folder name.
6. Stores the retrieved folder object as AccFolder.

Example Use Case

✅ Retrieve folder metadata to validate existence prior to uploading files.
✅ Build the full folder path for use in automated naming, reporting, or logging tasks.

Task Success Criteria

• Success: Folder is retrieved and stored in AccFolder, including its full path.
• Failure: If Hub, Project, or Folder 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 folders by both Id and Path to maximise compatibility with varying input types.
• The output object (AccFolder) is a BIMDocsProjectFolder model as returned by the ACC API integration, containing folder GUID, display name, and constructed full path.