ACC/BIM 360 Assets API General Availability

We are pleased to inform you about the general availability of ACC/BIM 360 Assets API.

ACC/BIM 360 Assets API provides read/write access to the data stored Assets module of Autodesk Build and BIM 360 Build, which allows you to track your project’s assets and equipment from design to handover. With Assets, you can easily maintain an inventory of job site equipment, conduct inspections, document defects, and generate asset-related issues for quick resolution. There is no change since the beta period. 

Using the Assets API, you can:

• Read, create, and update Asset records, including custom attribute values. You can access records either individually, one-by-one or in batch mode, which allows you to access multiple records in one API call. 
• Filter assets when reading assets records. (e.g., fetch assets modified since a given date by query parameter filter[updatedAt]).
• Read, create, and update Asset statuses. Read access has batch-mode access as well. 
• Read, create, and update custom attribute definitions in project Admin settings, including the ability to set custom attributes to a given asset category. You can also read multiple custom attribute definitions in batch mode in one API call. 
• Read, create, and update categories in project admin settings. You can also use batch mode to read multiple categories in one API call.  
• Read, create, and update the status set in project admin settings. You can use batch mode to multiple status sets in one API call.
• Read and create links to issues/checklists/documents in the Docs module through Relationships API.

Using API, for example, you can extract asset data to export to an external system and import it back to the Assets module of Autodesk Build or BIM 360 Build. You can also automate setting up initial data, eliminating tedious manual tasks.

For information about the product features, see the product helps:

• Assets in Autodesk Build Product help documentation
• Assets in BIM 360 Product help documentation

Known Limitations

Currently, the Assets API doesn’t support the following functionalities:

• System categories in project admin settings 
• System records
• Access to data and settings related to Assets Model-based Workflow (e.g., the model field in the asset attributes, model mappings in project admin settings, etc.)

For more information about the Assets API, please check out the official API documentation on the APS developer portal. The tutorial section will be a good starting point for understanding how Assets API works.

Documentation:

• Field Guide
• Step-by-Step Tutorials
• Reference Guide

Code Samples on GitHub: 

• Postman Collection
• Export/import asset data to/from Excel
• Set up Assets from a Design Model (Integration with Viewer and Design Automation) 
• View Assets in Design Model (Integration with Viewer and filtering by rooms and levels)
• Set up Asset custom attributes from the Parameter service (Import Parameters to Assets)

Recordings and Presentations:

If you would like to know what will be possible with Assets feature and its API, please check out these recordings:

• Tracking Assets and Equipment in BIM 360 (product features) 
• BIM 360 API Update and Beyond (Assets API overview starts at 16:15, including demo samples)  

Happy coding!