Query AEC Elements

Queries elements and their properties from a Revit model hosted in Autodesk Construction Cloud using the AEC Data Model API. Supports three query modes of increasing complexity.

Purpose

Use this task to extract BIM element data from an ACC-hosted Revit model for reporting, scheduling, quantity take-off, or validation workflows. Simple mode lets you pick a Revit category and return specific properties without writing queries. Intermediate mode allows a custom filter expression. Advanced mode gives full control with a raw GraphQL query.

Shared Inputs

These inputs are shown for every query mode.

Field	Type	Required	Description
Hub Name	Text	Yes	The name of the ACC Hub.
Project Name	Text	Yes	The name of the ACC Project.
File	Text	Yes	The Revit file to query. Can be a folder path (e.g. Project Files/Models/MyBuilding.rvt), a lineage URN, or a version URN.
Query Mode	Dropdown	Yes	Simple, Intermediate, or Advanced. Controls which additional inputs are shown.

Query Modes

Simple

Filter by Revit category and return selected properties. Best for straightforward element extraction without writing query syntax.

Inputs

Field	Type	Required	Description
Revit Category	Editable Dropdown	No	Filter results to a specific Revit category (e.g. Doors, Windows, Walls). Leave empty to return all element types. You can also type a custom category name.
Instances Only	Checkbox	No	When enabled (default), only returns placed instances — not family type definitions. Recommended for most use cases.
Return Properties	List	No	The element properties to include in the response (e.g. Name, Width, Family Name). Defaults to Name.

Intermediate

Write a filter expression directly for more precise control over which elements are returned.

Inputs

Field	Type	Required	Description
Advanced Filter	Text	No	A raw AEC filter expression. Property names with spaces must be wrapped in single quotes. Example: 'property.name.Element Context'=='Instance' and 'property.name.Revit Category Type Id'=='Doors'
Return Properties	List	No	The element properties to include in the response.

Advanced

Write a complete GraphQL query for full control over the request and response shape.

Inputs

Field	Type	Required	Description
Raw GraphQL	Multi-line Text	No	A complete GraphQL query. Use {{ElementGroupId}} as a placeholder for the resolved element group ID — it is replaced at runtime.

Outputs

Name	Description
AecData	A JSON string containing the list of elements matching the query, each with the requested properties. Pass this to a data transformation or reporting task for further processing.

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.

Authentication

This node requires an Autodesk service account or third-party account with access to the target hub and project.