Get ACC File

Retrieves a file from Autodesk Construction Cloud along with its custom attributes, with an option to download it to the working folder.

Purpose

Use this task when a workflow needs to reference or act on a specific file in ACC. It accepts either a file path or a file identifier, so it works regardless of how the upstream system provides file references. Enable Download File when a downstream task needs the actual file content — for example, to publish, convert, or upload it elsewhere.

Inputs

Field	Type	Required	Description
Hub Name	Text	Yes	The name of the ACC hub containing the target project.
Project Name	Text	Yes	The name of the project within the hub.
File Identifier	Text	Yes	The identifier of the file to retrieve. Accepts a full file path (e.g. Project Files/PROJ001/DRAWINGS/test.txt), a lineage URN, or a version URN.
Download File	Checkbox	No	When enabled, downloads the file to the working folder and provides its local path as the DownloadedFile output.

Outputs

Name	Description
AccFile	The file object retrieved from ACC, including metadata and any custom attributes defined on the file.
DownloadedFile	(Download File only) The local path to the downloaded file in the working folder.