Search ACC Files

Searches for files within an Autodesk Construction Cloud project folder using the APS Data Management search API. The search is recursive — all subfolders of the target folder are included.

Purpose

Use this task when a workflow needs to locate files in ACC based on name, type, date, or author. A Basic search finds files by name. An Advanced search allows multiple conditions to be combined. Results can then be passed to a Loop node to process each file individually, or to Get ACC File for full metadata retrieval.

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 ACC project to search within.
Folder Identifier	Text	No	The folder path or folder ID to scope the search to. Leave empty to search from the project root (Project Files). The search is always recursive.
Search Type	Dropdown	Yes	Basic searches by file name (contains match). Advanced allows multiple conditions across supported fields.
Basic Search Term	Text	Yes (Basic only)	Text to match against file names. Partial matches are returned.
Search Conditions	Search Conditions	Yes (Advanced only)	One or more conditions defining which files to return. See the supported fields and operators below.
Get All Pages	Checkbox	No	When enabled, all pages of results are retrieved. When disabled, only the first page is returned (approximately 50 results).

Advanced Search — Supported Fields and Operators

The following fields and operators are supported by the ACC search API. Conditions using unsupported fields or operators are skipped and a warning is written to the workflow log — the task does not fail.

Field (enter exactly)	Data Type	Supported Operators
File Name	String	equals, contains, startsWith, endsWith
File Type	String	equals (e.g. pdf, dwg, xlsx, rvt)
Create Time	Date/Time	before, after, equals, lessOrEqual, greaterOrEqual
Last Modified Time	Date/Time	before, after, equals, lessOrEqual, greaterOrEqual
Created By	String	equals (username)
Last Modified By	String	equals (username)

Conditions not supported by the ACC API

The following condition types have no equivalent in the ACC search API. Use an If node after this task to post-filter results.

• Negation operators (notEquals, notContains) — the ACC search API does not support negation filters
• Number and boolean condition types — no numeric or boolean metadata fields are exposed by the search endpoint
• Custom attribute values — the folder search endpoint does not filter on custom attributes

Outputs

Name	Description
AccFiles	List of file objects matching the search criteria. Each file includes name, ID, type, create time, last modified time, created-by username, and version number. Pass individual items to Get ACC File to retrieve full metadata and custom attributes.
ResultsCount	The number of files returned.

Autodesk API token usage

Autodesk frequently update their token consumption policies and the cost of individual API operations. Refer to the Autodesk Platform Services Token Usage documentation for current pricing and consumption details.