10 Jan 2023

BIM 360 Issues Version 2 API Released

We are pleased to inform you about the general availability of BIM 360 Issues version 2 (v2) API.

The v2 API simplifies the format of response body (eliminating JSON:API format). It also provides additional features, such as local attachments. The basic functionality of BIM 360 Issues v2 API remains the same. Code changes are required, but should be straightforward. Below is the overview of differences between v1 and v2:

  • The base url is changed from /v1/…/quality_issues to /v2/…/issues, e.g.,
    from 
https://developer.api.autodesk.com/issues/v1/containers/:container_id/quality-issues

         to

 https://developer.api.autodesk.com/issues/v2/containers/:containerId/issues 

There are a few enhancements as well:

  • Support for local attachment upload. A local attachment is stored in a hidden folder in BIM360 Docs. To complete the local attachment upload workflow, POST /attachments/:attachmentId is added.
  • attachmentType of attachment adds “photo” type to indicates image (e.g., png, jpg.).

You may see better performance due to the internal implementation enhancement. Migration should be straightforward. Here are a couple of points to note on the scope in this release:

  • Get/create pushpin issue is supported in a similar manner as v1 API. However, the data structure is changed; push-pin data is now under linkedDocuments instead of pushpin_attributes. Please refer to the updated tutorials “get pushpin issue” and  “create pushpin issue” for more detail.  
  • Uploading local attachment will require to upload a file through S3 signed url. This is the standard way of using Data Management API. This tutorial describes the steps in detail.
  • filter[qualityUrns] is used to filter issues associated with specific checklists. However, the response field for the checklists are called links in v2, not quality_urns (v1).

Documentation

GitHub

Please be aware that the BIM 360 Issues v2 API is NOT COMPATIBLE with ACC projects. You will need to use the ACC version of Issues API for ACC projects. The format of requests and response data structure in the BIM 360 Issues v2 API follows the same standard that we use in Autodesk Construction Cloud (ACC) Issues API. You may find migrating to v2 as a step toward supporting ACC version.

Moving forward, we encourage you to use v2 API. If you already have an app using BIM 360 Issues v1 API, please take a look at the new set of v2 API at earliest to make sure you have everything you need to migrate to v2 API. If you have any questions or encounter issues, please contact us ASAP through our APS support channel.

 

Tags:

Related Article

Posted By

Mikako Harada

Mikako Harada

Mikako Harada works as an AEC technical lead and Americas manager for the Developer Technical Services (DevTech) team at Autodesk. She provides API (Application Programming Interface) technical support to the members of Autodesk Developer Network worldwide for AEC products. Prior to joining Autodesk, she worked as a researcher for the Swiss Federal Institute of Technology (ETH) in Zurich. While at ETH, she...

Xiaodong Liang

Xiaodong Liang has been with Autodesk since 2007, focusing on providing programming support, consulting, training and evangelism to external developers. He started his career China and now lives in Beijing, China. Xiaodong is currently a developer consultant in the team Developer Technical Services (DevTech), the worldwide team of API gurus providing technical services through the Autodesk Developer Network. He...