ACC Issues
The Autodesk Construction Cloud (ACC) Issues API creates and updates issues in your ACC projects. An issue is an item that is created in ACC for tracking, managing and communicating tasks, problems and other points of concern through to resolution. The Issues API includes the following features:
- Create, update and retrieve project-related ACC issues.
- Retrieve file-related issues (pushpins).
- Retrieve a user’s basic issue permissions.
- Retrieve issue project settings, such as custom attribute (field) definitions and mappings, issue types, and root cause categories.
- Add and retrieve issue comments.
- Update issue statuses (draft/open/answered/closed), and publish or unpublish an issue.
Differences Between BIM 360 and ACC
The following list details some notable differences between the BIM 360 Issues API and the ACC Issues API:
- The Issue permissions for ACC are different from BIM 360. For example, a user with Create for my company permissions can only assign an issue to a member of the same company. See GET users/me for more details. In addition, some attributes can only be updated by the issue creator or the assignee. For more information, see the help documentation.
- ACC issues are created as unpublished by default. Only the issue creator and assignee have access to the unpublished issue and only they can edit it. See the help documentation for more details. You can create issues in a published state or transition them to a published state by configuring the
published
request attribute. - We are only exposing a single status set for ACC. (in BIM 360 we exposed two status sets). Note that we might be supporting additional status values within the single status set in the future.
- We have replaced BIM 360 attachments with ACC references. You can use the Relationships API to define and retrieve references between different modules, such as links between issues and photos. See this blogpost for more information about the Relationships API.
Limitations
The following list details known limitations for the ACC Issues API release:
- You cannot add issues to sheets, models, or files (pushpins). You can retrieve issues that are associated with files, however, we do not currently support retrieving issues that are associated with sheets in the ACC Build Sheet tool.
- We do not currently provide endpoints to programmatically retrieve user IDs when assigning users to issues. We recommend using the Data Connector API to extract the IDs. See the Retrieve User Permissions tutorial for more details. We will be releasing endpoints that directly retrieve Autodesk IDs in the near future.
- We do not currently support retrieving issue activities.
- You can download photo references by retrieving them via the Relationships API and downloading them using Photos API. However, you cannot currently upload photos using the Photos API. We will be supporting the photos upload in the near future. As a workaround you can upload photos to ACC Files using the Data Management API and a file reference to the issue. See the tutorial in the introduction to POST issues for more details.
- Note that the ACC Issues API is not compatible with BIM 360 projects. Use the BIM 360 Issues API for BIM 360 projects.
- Currently, you can only check permissions for the “current” user. You cannot retrieve permission levels for all users.
- We do not support endpoints that configure permissions.
- We do not support endpoints that configure issue types or custom attributes.