Get File Attachments

Retrieves the files associated with a parent file in Autodesk Vault as either attachments, dependencies, or both.

Purpose

Use this task when a workflow needs to know what other files are linked to a given Vault file. This is useful for checking which files are attached to an assembly before publishing, identifying all dependency files that must be downloaded before a local operation, or building a complete picture of a file's relationship tree. The result is available both as a hierarchy and as a flat list, making it easy to loop over associated files in subsequent tasks.

Inputs

Field	Type	Required	Description
Parent File Identifier	Text	Yes	Identifies the parent file in Vault. Accepts a Vault path ($/Designs/Assembly.iam), a numeric file ID, or a file name.
Association Type	Dropdown	No	Which relationship type to retrieve: Attachment (files attached to the parent), Dependency (files the parent depends on), or All. Defaults to Attachment.
Include All Levels	Checkbox	No	When enabled, recursively traverses the full association hierarchy. When disabled, only the immediate associations are returned.
Include Hidden Files	Checkbox	No	When enabled, hidden files are included in the results.

Visibility Rules

Include All Levels is only shown when Association Type is set to Dependency or All.

Outputs

Name	Description
ParentFile	The resolved parent Vault file object.
HierarchyRoot	The root node of the association tree, with nested child nodes representing each level of the hierarchy.
TotalFileCount	Total number of associated files found across all levels.
AssociationType	The association type used for this query (Attachment, Dependency, or All).
IncludedAllLevels	Boolean indicating whether recursive traversal was enabled.
FlatFileList	All associated files as a flat array, regardless of hierarchy level.