Autodesk Construction Cloud Reviews API General Availability

We are pleased to inform you about the general availability of the Autodesk Construction Cloud (ACC) Reviews API, following an explicitly longer private beta testing.

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 prior to construction commencement. You can find information about the Reviews tool feature in the product help.

In this first phase of the Reviews API, we have released five (5) read-only endpoints. Using the API, you can retrieve the following data:

Approval Workflows
- GET workflows: A list of the approval workflow definitions.
Reviews
- GET reviews: A list of the reviews - instances of the approval workflows.
- GET reviews/:id/workflowreview: The approval workflow assigned to a review.
- GET versions: A list of the File versions included in a review.
Versions
- GET approval-statuses: A list of the complete approval records and review references of a specific File version.

Known Limitations

Reviews API doesn't support SSA, Secure Service Accounts). (Wish: ACSD-43717)

The following Q&A may answer some of your questions:

Q1. Why do I get an empty array from the response of GET workflows?

A1. Please verify that the user you used when calling this endpoint is a project admin. The non-admin users require calling the API with the querying string `filter[initiator]=true`.

The GET workflows endpoint primarily returns data for Approval Workflows on the settings page of the ACC Web UI, which is accessible only to project admins. (See product help for the UI feature)

If the user is only a project member, not a project admin, please ensure that you call the endpoint in this way: GET workflows?filter[initiator]=true. This returns the data of the approval workflows list when initiating or creating a review on the ACC Web UI. (See product help for the UI feature)

Note. The user refers to the user account you logged in with for three-legged access tokens, or the user's `autodeskId` you specified in the request header `x-user-id` when using two-legged access tokens.

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.
Reference Guide: This section lists a set of endpoints for retrieving approval workflows, review metadata, and file versions currently under review. Use it to track review progress, view approval statuses, and access file-level review outcomes.