14 Apr 2023

AutoSpecs API in Autodesk Construction Cloud

Last month, Autodesk announced the availability of AutoSpecs in Autodesk Construction Cloud (ACC) unified products. 

AutoSpecs intelligently reads construction specification documents and automatically extract submittal information. AutoSpecs helps users to generate comprehensive submittal logs and identify potentially missing submittal requirements, resulting to save time & money, and help mitigate risks.

AutoSpecs in ACC is seamlessly integrated with Autodesk Build. You can publish submittal logs directly to Autodesk Build, as well as store and upload project specifications from Autodesk Docs. It allows you to identify QA/QC requirements, mockups and closeout submittals. You can compare versions of the project specification to quickly assess if any additions or modifications have been made. 

AutoSpecs in ACC is sold as a part of Autodesk Construction Operations Bundle*1, and available for sale in north America only. 

For more information about the product feature, please refer to the product help. You can also try out the feature with the trial version of Autodesk Build.

*1)  Construction Operations Bundle includes: Autodesk Docs, Autodesk Build, Pype AutoSpecs and Pype Closeout. cf. www.autodesk.com/construction-operations 
 

API 

Good news for developer community is that the release of AutoSpecs in ACC comes with API! In this first release, the following four (4) read endpoints are available:

  • GET project metadata
        retrieves AutoSpecs specific project information. e.g., if the extractions have been completed, and the available versions of specifications.  
  • GET smart register
        retrieves all the submittal logs, such as submittal type, division code, and spec number.
  • GET requirements
        returns the number of submittals for each section and group.
  • GET summary
        returns the number of submittals for each group and each type.

GET smart register endpoint provides raw data about submittal. GET requirements and GET summary give you statistics or count data.

Additional notes about AutoSpecs in ACC API are: 

  • The AutoSpecs API supports 3-legged authentication only (i.e., user context required) 
  • Some of the data you see in the Smart Registry UI (i.e., subcontractor, source version and pdf link) are not accessible through API in this release.
  • The version id for specifications is a string data type with a number generated by AutoSpecs (e.g., 2268). It is not a sequential order of uploaded file (like v1, v2, …) which we typically expect in Data Management API.  
  • In the response of GET summary, only when submittalGroup is “Action And Informational”, an additional field submittalGroupTypes are included. We intend to support for other groups in future.  

Documentation 

Code Samples on GitHub: 

Note: at the time of this writing, AutoSpecs is not yet listed in the "Development Software and Web Services Request Form" on Autodesk Developer Network (ADN) portal. In the mean time, you can try, using the trial version of Autodesk Build.   

If you have any question, feel free to contact us through our APS support channel.

Related Article