Get ACC File

Retrieves a file from Autodesk Construction Cloud along with its custom attributes.

Purpose

Use this task when a workflow needs to reference or act on a specific file that already exists in ACC. It accepts either a file path or a file identifier, so it works regardless of how the upstream system provides file references. The retrieved file object, including any custom attributes defined in ACC, is made available to all subsequent tasks in the workflow.

Inputs

Field	Type	Required	Description
Hub Name	Text	Yes	The name of the ACC hub containing the target project. This can be found in the ACC web app under accounts.
Project Name	Text	Yes	The name of the project within the hub. This can be found in the ACC web app under projects.
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.

Outputs

Name	Description
AccFile	The file object retrieved from ACC, including metadata and any custom attributes defined on the file. Pass this to downstream tasks such as Download ACC File or document processing tasks.