We are pleased to announce that Autodesk has released a new set of Autodesk Construction Cloud (ACC) Reviews API endpoints, primarily designed for creating approval workflows and initiating file reviews.
The Reviews tool is a module within Autodesk Docs. It provides a tool to send files for review using the approval workflow feature, which enables project administrators to facilitate, control, and automate the distribution of files to project members. Project members assigned as reviewers can then review and comment on the files, and members selected as approvers can give final approval for the files to be used.
In summary, the Reviews tool enables document managers to distribute project drawings, models, and files for review and approval before construction commencement. You can find information about the Reviews tool feature in the product help.
In this second phase of the Reviews API, we have released five (5) new endpoints, where two (2) are needed for creating approval workflows and initiating file reviews, and three (3) read-only endpoints for retrieving a single workflow & review, and the progress of a review.
WRITE endpoints
- POST workflows: Create an approval workflow.
- POST reviews: Initiate a file review of selected file versions and the approval workflow.
READ endpoints
- GET workflows/:workflowId: Retrieves details of a single approval workflow.
- GET reviews/:reviewId: Retrieves details of a single review (instance).
- GET reviews/:reviewId/progress: Retrieves the current state of each step in the review’s approval workflow, showing the assigned candidates, whether steps have been claimed or submitted, and who performed each action.
Documentation
- Field Guide: This page provides an overview of the terminology and background information related to Reviews and the Reviews API. It also includes information about the scope of the current release and its limitations.
- Step-by-step Tutorial - Create Approval Workflows: This newly added page provides instructions on how to create an approval workflow.
- Step-by-step Tutorial - Create a Review: This newly added page provides instructions on how to initiate a file review of selected file versions and the approval workflow.
- Step-by-step Tutorial - Inspect a Review: This newly added page provides instructions on how to inspect a review.
- Reference Guide: This section lists a set of endpoints for creating approval workflows and initiating file reviews, as well as retrieving details of a single workflow & review, and current review progress.
Code Samples on GitHub
If you have any questions or feedback, please don't hesitate to contact us through our APS support channel.