Working with Review Links

This guide describes managing Review Links using's API.


Review Links are a core feature for collecting Assets, and sending them around for feedback via a single URL without requiring explicit Team or Project access. Fundamentally, they're a representation of Assets from within a single Project, so this guide will assume that:

  1. You either have Assets at hand, or are familiar with uploading Assets via API.
  2. You know the ID of the Project in which you'd like to create the Review Link.
  3. Your goal is to end up with a URL that you can distribute outside of (e.g. via email, chat, or other dispatch).

Core concepts

Review Links strictly belong to Projects, and an Asset in a Review Link is represented as a special resource type called a Review Link Item, which will always contain the review_link_id and asset_id it's joining, as well as the full payload of the associated Asset.

While Review Link Items do not need to be tracked or managed on their own, they're a helpful structure to understand the full workflow captured in this guide. Accordingly, the hierarchical family of a Review Link looks like this:

Project > Review Link > Review Link Item > Asset reference

Required scopes

Before beginning this guide, you'll need to make sure you have a token that includes at least the following scopes:

Projects: ReadNot strictly required, but necessary for fetching the root_asset_id of a Project.
Assets: ReadNot strictly required, but necessary for navigating to asset_ids via API.
Review Links: Create, Read, UpdateCreate the Review Link, add Assets, and fetch information (especially if tracking in another system).

1. Gather your IDs

To create a Review Link, you'll need to gather:

  1. A Project ID
  2. The IDs of one or many Assets in that Project

If you don't have the Project ID handy, but do have access to and know which Project you'd like to use, you can see the ID on your address bar when navigating to the project:<project-id>.

Similarly, if you don't have the Asset ID(s) handy, navigate to the asset(s) you want, and pull the ID(s) from the address bar in your browser:<asset-id>.